From 8f361389dc3a0c8badfe1c46d253afd4ad334d83 Mon Sep 17 00:00:00 2001 From: Randall Winkhart Date: Mon, 24 Aug 2026 21:34:44 -0400 Subject: [PATCH] Document Pavlok API setup --- README.md | 2 +- pavlok-help.md | 9 +++++++++ src/pkjs/config.js | 2 +- 3 files changed, 11 insertions(+), 2 deletions(-) create mode 100644 pavlok-help.md diff --git a/README.md b/README.md index 45f1a9a..d5613c1 100644 --- a/README.md +++ b/README.md @@ -24,4 +24,4 @@ Perhaps the most unique, Trigalarm features optional [Pavlok](https://pavlok.com ## Future Goals (1.1 and beyond) - Full touch navigation - Draw measurements based on triangle side locations, rather than in fixed positions -- Speaker support +- Custom, self-hosted Pavlok API support (going to try some Bluetooth reverse engineering) diff --git a/pavlok-help.md b/pavlok-help.md new file mode 100644 index 0000000..aa8bf33 --- /dev/null +++ b/pavlok-help.md @@ -0,0 +1,9 @@ +# Pavlok Integration Steps +1. Head [here](https://pavlok.readme.io/reference/stimulus_create_api_v5_stimulus_send_post) and log in using the button at the top right. + - For some reason, my Pavlok password will not log me into this page, so I have to use the password-less login option. YMMV. +2. Find the `CREDENTIALS` section and click the lock icon in the `Header` bar. You need to copy all the text AFTER `Bearer`. + - This is your JWT token/API key and should begin with `ey`. +3. Open Trigalarm's phone-side settings, enable Pavlok integration, and paste the copied key into the `API Key` box. +4. Make sure the Pavlok app is open in the background & press the `TEST API KEY W/BEEP` button to verify it is working. + - If all is well, your Pavlok should audibly beep. You're good to go! + - Feel free to reach out (via the "contact developer" feature in the Pebble store) if you need assistance! diff --git a/src/pkjs/config.js b/src/pkjs/config.js index 70e1d51..2a0d894 100644 --- a/src/pkjs/config.js +++ b/src/pkjs/config.js @@ -24,7 +24,7 @@ module.exports = [ "type": "input", "messageKey": "PKJS_PAVLOK_API_KEY", "label": "API Key", - "description": 'API bearer token, starting with "ey".' + "description": 'API bearer token, starting with "ey". Click HERE for help getting this token.' }, { "id": "pavlok_test_beep",