pebble-tool 5.0.31

Tool for interacting with pebbles.

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.

For developers of pebble-tool, use:

uv run pebble.py

Testing

Test coverage can be run locally with:

uv run pytest

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.