Repository| Issues

The Pebble is a smart watch, that connects via Bluetooth.

Pebble puts critical apps and notifications on your wrist, giving you immediate access to what's most important.

For more info about the Pebble platform click here.

How to Install

$ npm install cylon cylon-pebble

First, install the Pebble 2.0 iOS or Android app. (If you haven't already)

With that done, download WatchBot (our Pebble App) from the Pebble App Store.

Pebble App Store

Watchbot configuration screenshot


Once you've got WatchBot installed, go to "My Pebble" on your smartphone's Pebble app. Once there, configure the following settings:

  • robot name: leave this blank
  • robot api host: IP of the computer running the Cylon API
  • robot api port: port number for the Cylon API
  • publish command: leave this blank
  • message command: leave this blank
  • accelerometer: leave this unchecked

How to Use

  • Before running the example, make sure configuration settings match with your program, in example, api host is your computer IP, robot name is 'pebble', and robot api port is 8080

This small program receives message queue events from a Pebble smart watch.

var Cylon = require('cylon');

  host: '',
  port: '8080',
  ssl: false

  name: 'pebble',

  connections: {
    pebble: { adaptor: 'pebble' }

  devices: {
    pebble: { driver: 'pebble' }

  work: function(my) {
    my.pebble.send_notification("Hello Pebble!");

    my.pebble.on('button', function(data) {
      console.log("Button pushed: " + data);

    my.pebble.on('tap', function() {
      console.log("Tap event detected");

How to Connect

This software requires version 2.X of the Pebble watch firmware.

The main steps are:

  • Install Pebble 2.0 iOS or Android app. (If you haven't already)
  • Install watchbot by following these instructions
  • After app is installed, click on "Settings" and configure robot name, robot api host, and robot api port
  • Configuration settings must match with your program, in this example, api host would be your computer IP, robot name is 'pebble', and robot api port is 8080

Supported Features

  • Event detection of 3 main pebble buttons
  • Tap event
  • Accelerometer support
  • Sending text notification to pebble


There is only one driver for the Pebble platform, as listed below.