pebble
  • Tutorials
  • Get the SDK
  • Guides
  • Documentation
  • Examples
  • Community
  • Blog
  • More
Privacy
Cookies
Publish

SDK

  • Installation
  • Changelog
    • 4.3
    • 4.2.2
    • 4.2.1
    • 4.2
    • 4.2-beta5
    • 4.2-beta4
    • 4.1.4
    • 4.1.2
    • 4.1.1
    • 4.1
    • 4.0.1
    • 4.0
    • 4.0-rc20
    • 4.0-beta17
    • 4.0-dp3
    • 3.14
    • 4.0-dp2
    • 4.0-dp1
    • 3.13.1
    • 3.13
    • 3.12
    • 3.11.1
    • 3.11
    • 3.10.1
    • 3.10
    • 3.10-beta6
    • 3.10-beta2
    • 3.10-beta1
    • 3.9.2
    • 3.9.1
    • 3.9
    • 3.9-beta8
    • 3.9-beta7
    • 3.9-beta5
    • 3.8.2
    • 3.8.1
    • 3.8
    • 3.8-beta12
    • 3.8-beta10
    • 3.8-beta8
    • 3.7
    • 3.6.2
    • 3.6
    • 3.6-dp8
    • 3.6-dp7
    • 3.6-dp6
    • 3.6-dp5
    • 3.6-dp2
    • 3.4
    • 3.3
    • 3.2.1
    • 3.2
    • 3.1
    • 3.0
    • 3.0-beta12
    • 3.0-beta11
    • 3.0-beta10
    • 3.0-dp9
    • 3.0-dp8
    • 3.0-dp7
    • 3.0-dp6
    • 3.0-dp5
    • 3.0-dp4
    • 3.0-dp3
    • 3.0-dp2
    • 3.0-dp1
    • 2.9
    • 2.8.1
    • 2.8
    • 2.7
    • 2.6.1
    • 2.6
    • 2.5
    • 2.4.1
    • 2.4
    • 2.3
    • 2.2
    • 2.1.1
    • 2.1
    • 2.0.2
    • 2.0.1
    • 2.0.0
    • 2.0-BETA7
    • 2.0-BETA6
    • 2.0-BETA5
    • 2.0-BETA4
    • 2.0-BETA3
    • 2.0-BETA2
    • 2.0-BETA1
    • 2.0-BETA0
    • 2.0-DP3
    • 2.0-DP2
  • Getting Started with Pebble Time Round

Installing the Pebble SDK

Install dependencies

MacOS

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

Ubuntu

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

Windows

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.

Download the Pebble CLI

Install uv, a fast package manager for Python.

Then, run:

uv tool install pebble-tool

Next Steps

Now that you have the Pebble SDK downloaded and installed on your computer, it is time to create your first app!

Create a Pebble app

Install the latest SDK:

pebble sdk install latest

Create a project (for example, called myproject):

pebble new-project myproject

Compile the project (after cding 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

Learn more

Check out the Tutorials for a step-by-step guide on how to write a simple C Pebble application.

Installation Problems?

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.

Overview

  • Install dependencies
  • MacOS
  • Ubuntu
  • Windows
  • Download the Pebble CLI
  • Next Steps
  • Create a Pebble app
  • Learn more
  • Installation Problems?