Sovereign 8s.is mirror of standardgalactic/pebble-tool
  • Python 92.3%
  • JavaScript 5.2%
  • CSS 1.4%
  • C 1%
  • Shell 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2025-11-25 22:22:37 +01:00
.github/workflows Create release.yml 2025-07-15 12:32:17 -04:00
pebble_tool Revert "Add support for python 3.14" 2025-11-25 22:22:22 +01:00
.gitignore Update gitignore 2025-07-04 10:45:15 -04:00
LICENSE Create LICENSE 2015-06-06 00:55:37 -07:00
pebble.py Initial commit. 2015-06-02 13:59:23 -07:00
pyproject.toml bump version 2025-11-25 22:22:37 +01:00
README.md Update README.md 2025-08-04 14:40:33 -04:00
requirements.txt Enable QEMU VNC with websockify 2025-08-14 14:05:48 -07:00

Pebble Tool

The command-line tool for the Pebble SDK.

About

The Pebble SDK now runs in Python 3. This includes:

  1. The command-line tool to build and install apps and watchfaces (this repository).
  2. The SDK code in PebbleOS (https://github.com/coredevices/PebbleOS/tree/main/sdk). This isn't fully working yet, so pebble-tool currently uses a patched version of the existing SDK core (version 4.3) that has been modified for Python 3.
  3. pypkjs (https://github.com/coredevices/pypkjs), which allows PebbleKitJS code to run in the QEMU emulator.

Previously, the Pebble SDK was installed by downloading a tar file containing pebble-tool, the toolchain, and executables for PebbleOS QEMU and pebble-tool. Users had to decide where to extract the file, add the binaries to their PATH, and configure a virtualenv.

Now, pebble-tool is a standalone command-line tool that can be installed through pip/uv. The toolchain (arm-none-eabi) and QEMU binary are no longer bundled, but instead installed when pebble sdk install is run.

Installation

Instructions are at https://developer.repebble.com/sdk

It's super simple: install a few platform-specific dependencies, then install pebble-tool via uv.

Troubleshooting

If you run into issues, try uninstalling and re-installing. You can remove the latest SDK with

pebble sdk uninstall 4.4

You can also delete pebble-tool's entire data directory, located at ~/.pebble-sdk on Linux and ~/Library/Application Support/Pebble SDK on Mac.