Use Homebrew to install dependencies.
You'll need Python 3.10 or above, not the MacOS default installation of 3.9. To install a newer version of Python, as well as the other dependencies, run:
brew install python glib pixman
You will need to install a few dependencies to make the SDK run.
sudo apt install python3-pip python3-venv nodejs npm libsdl1.2debian libfdt1
Note: if you already have
node
installed, you can install only:
sudo apt install libsdl1.2debian libfdt1
The Pebble SDK does not run on Windows, but you can use WSL. Install Ubuntu in WSL, and then use the instructions above to install dependencies.
Install uv, a fast package manager for Python.
Then, run:
uv tool install pebble-tool
Now that you have the Pebble SDK downloaded and installed on your computer, it is time to create your first app!
Install the latest SDK:
pebble sdk install latest
Create a project (for example, called myproject):
pebble new-project myproject
Compile the project (after cd
ing to your project directory):
pebble build
Install the app on an emulator for the Pebble Time:
pebble install --emulator basalt
Or, install the app/watchface on your phone (replace IP with your phone's IP shown in the Pebble app):
pebble install --phone IP
Check out the Tutorials for a step-by-step guide on how to write a simple C Pebble application.
If you have any issues with downloading or installing the Pebble SDK, feel free to post your comments in #sdk-dev
in the
Rebble Discord. Please provide as many details as you can about the issues
you may have encountered.
Tip: Copying and pasting commands from your Terminal output will help a great deal.