0.18.0 • Public • Published

Cylon.js For Pebble

Cylon.js ( is a JavaScript framework for robotics, physical computing, and the Internet of Things (IoT).

This module provides an adaptor and driver for the Pebble smart watch ( It uses the Pebble 3.0 SDK, and requires the 3.0 iOS or Android app, and that the "Watchbot" app ( has been installed on the Pebble watch.

Want to use Ruby on robots? Check out our sister project Artoo (

Want to use the Go programming language to power your robots? Check out our sister project Gobot (

Build Status Code Climate Test Coverage

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


We're busy adding documentation to our web site at please check there as we continue to work on Cylon.js

Thank you!


For our contribution guidelines, please go to .

Release History

For the release history, please go to .


Copyright (c) 2013-2015 The Hybrid Group. Licensed under the Apache 2.0 license.

Package Sidebar


npm i cylon-pebble


Weekly Downloads






Last publish


  • andrewstewart
  • deadprogram
  • edgarsilva