Pebble pairing¶

All Pebbles when powered up for the first time demand that you connect it via the official App. This is not necessary, you can get started with Gadgetbridge only. While on original Pebbles this screen could be bypassed by a long press on the right button, newer pebbles seem to be stuck in recovery until a firmware gets flashed.

We recommend to flash the latest available firmware. On the Pebble and Pebble Steel (black and white models), this includes flashing a migration firmware first.

See also the Pebble gadget page for related links and resources for Pebble.

Steps to follow:

• Install Gadgetbridge
• Follow the wizard to pair your Pebble, do NOT select THE Pebble LE!
• Start Gadgetbridge and tap on your Pebble until it says initialized
• Flash a firmware as noted in Pebble Firmware Update
• Install a language pack as noted in Pebble Language Packs
• Optionally, open the App Manager, select the Installed apps tab, and enable Health, Workout, and Weather if your device supports it

Pairing a Pebble 2 or a new Core Devices Pebble (2025+ released watches)¶

• Open Gadgetbridge and press the Add button to add a device (if you don't find it, use Hamburger Menu → Connect new device)
• Click on the Pebble once it shows up
• When asked whether to pair as Companion Device, confirm
• There should be a popup on the phone to confirm, followed by the pair screen on the Pebble and after confirming the Pebble should be visible in Gadgetbridge

Just to make sure, open Hamburger Menu → Debug → Companion device and check if your Pebble was set up as such. If it is not listed under "Companion device", but under "Other": tap it once, confirm the dialog, and confirm the permission request.

Pairing a Pebble BTLE¶

Instructions quoted from comment on issue #1098.

You should NOT pair a BTLE device via Android's Bluetooth settings. If you already did so and ran into problems with it in Gadgetbridge (which you certainly will if you did), first step is to "forget the device" - that is the Pebble in Android's Bluetooth settings as well as the Android device in the Pebble's settings.

• Set/keep the "Client only" option enabled
• Forget the Pebble (on the Android device) and the Android device (on the Pebble)
• Toggle Bluetooth on both pebble and Android
• Add the Pebble again (pressing the + button in Gadgetbridge)

Pairing a Pebble OG¶

• Disable "Companion device pairing" (experienced on Android 8)
• Pair via Gadgetbridge's Add button
• Do not select the LE Pebble but the "normal" Pebble in the list of found devices

Replacing a Pebble while keeping its data¶

If you need to replace your Pebble device by another Pebble device, but want to keep the data associated as if it was collected from the replacement device, the following steps can accomplish that:

• Disable Bluetooth on all involved devices (watches, Android device)
• Optional: backup app and data using your favorite backup solution
• Optional: export your data (Hamburger Menu → Data management → Export zip respectively Hamburger Menu → Data management → Export data) and copy the files off-device
• Open Hamburger Menu → Debug → Devices, select your Pebble, and replace its Bluetooth address with the one of the replacement device (find the new address on the Pebble in Settings → System → Information)
• Confirm (Gadgetbridge will restart)
• Optional: forget the existing Pebble in the Bluetooth settings of the Android device
• Turn Bluetooth on for Android and the replacement Pebble
• In Gadgetbridge: Connect new device (follow the steps above for pairing)
• you may need to swith Bluetooth off and on again on the Android device after pairing so it finally connects