Glance for Pebble

Updated : 19 June 2015 / Glance 0.15

See the main page for latest updates

Recent Additions
Getting Started
Using the WatchApp
Using Glance with Tasker
Configuring Glance / Settings
Customising the WatchApp
Watchface Edtior
Premium Features

Recent Additions

See the main page for latest updates

  • Pebble Time (Colour)
    • Most items in the Screen Editor can take a background and foreground colour
    • A custom image can be imported into the editor. Set the Image type to custom and hit * to grab an image from your gallery. Note images take a while to send to the Pebble, particularly 64 colour dithered photos.
    • A new Analog clock layer type has been added, the fg and bg colours set the colour of the different hands
    • Colour Presets
      • FunW, Spots and ColCal are simple image backgrounds with data fields on top
      • AnalogPlus is an example of different analog displays, a clock, and  analog indicators. Top Left = GMail, Top Right = SMS, Btm Left = Phone Battery, Btm Right = Weather
  • Buttons can now be mapped to an individual custom launch.
    • From Customise->Button Mappings if you tap “CustomLaunch” in the drop down list for any button mapping (e.g. “Top Button Mapping”) you can set a custom pebble app to run.


  • Install the Glance Android App from the Google Play store
  • Install the Glance watchapp from inside the Android App (tap “Install WatchApp” on the main screen or from the menu)
  • Launch the watchapp on your pebble – explore the features.
  • Some features need configuration, and some are Premium only.
  • Turn off the in app help from the “Toggle Help” menu item

If you are struggling to install the watchapp please try from these links SDK1 SDK2
On some Android phones, you may find you have to use Firefox or download the pbw and use a file manager to launch the Pebble app installer.

Getting Started

Once the Android app is installed from the Google Play store, you should see something similar to the following screen.
The exact message may change depending on if you have an old version of Glance installed on your pebble.


The top status area gives a quick view of what is going on.
Any issues detected (like an old watchapp version, or problems with weather data) will be reported here.
Tapping on the status area will give a breakdown of the status of many of the features in Glance which can be useful for diagnosis of issues.
In the bottom right of the status area there is an icon which when tapped will have the app gather some information and open an email for you to send to the author. If you have a problem, a description will probably help! If you just want to say how awesome things are, thats great too. Even better is to buy Premium.

Beneath the status area are various menu options some of which only appear as necessary:

  • Settings – opens the main settings for Glance, including setting the SMS Presets
  • Customise WatchApp – opens the settings that enable customisation such as button mappings and the watchface editor
  • Instructions – Opens this document
  • Refresh Data – will resend the latest configuration and any other data to the pebble.
  • Install WatchApp – when relevant this item will be shown and will start the watchapp install process
  • Buy Premium – when relevant allows the purchase of premium features

The pop up or top right corner drop down menu (device / Android version dependent) has the following options:

  • Install WatchApp – will force the reinstall of the watchapp
  • Buy Premium – will force start the purchase process
  • Get Premium Order Details – will display your order number if you need to query about it
  • Send Logs – will allow the current application logs to be shared via email to the Glance author.
  • About – shows the latest release notes and the Open Source credits
  • Save Preferences to external – saves your preferences to …/Downloads/GlanceSettings.json
  • Load Preferences from external – loads your preferences from …/Downloads/GlanceSettings.json

Using the WatchApp

The main screen in Glance is by generally configured as a watch with additional information. The Classic default layouts are as shown here:


New Layouts can be created using the Watchface Editor (Premium) in the Android “Customise WatchApp” settings screen

Glance premium watchapps don’t take custom watch faces from the
editor. A short middle button click on these faces slides in some more
information (Long click for menu)

The buttons can be configured within the Android “Customise WatchApp” settings screen to launch the various other functions (See below).

The middle/select button will show the main Glance menu (long click in analog or text watch), which by default lists all the available functions. The menu can be edited to only show the desired functions using the Watchmenu Editor (Premium) in the Android “Customise WatchApp” settings screen.
The menu also shows the current Pebble battery % and Bluetooth connection status.

The default can be set from the Android “Customise WatchApp” menu.

Information Screens:
Most of the informational screens conform to the following pattern:

  • LONG UP/DOWN to scroll
  • UP/DOWN to get the previous/next screen (where appropriate)
  • MIDDLE(SEL) to take an appropriate action
  • Weather : shows additional weather information as available from the weather provider for the next few days (5 or 7). Middle to refresh forecast.
  • Calendar: shows a summary of the upcoming calendar events for the next two weeks. Middle to get a fuller dataset for an event.
  • ReadSMS: shows the text of the SMS messages from the inbox. Middle to reply (Premium)
  • UKTrain: shows the train timetable for the configured route. Configure in the Android settings screen. Click the bottom button for the return journet
  • NextBus: shows the NextBus timetime for the configured operator and stops (Premium). Check your operator is supported here. Configure in the Android settings screen.
  • Stocks: shows markets information from Yahoo finance. Configure in the Android settings screen.

The font size of the information screens can be set in the Android Settings panel, where default is as set by the developer (can be very small) or medium and large for those who want to be able to see the data more clearly!

Shows a list of those who have recently sent SMS messages within the SMS inbox. Middle to select a recipient. Then displayes the preset SMS responses (configured from the Android settings screen).

Turns the backlight on (useful to map to a button if you like to turn the lighton by touch)

Plays the phone ringer to help you find that missing phone. Or get out of that awkward meeting. Press again to stop, or dismiss from the Android app status box.

Allows a message to be sent to a preset number (Set in the Android settings screen) with the current GPS location appended.

Various Pebble Apps can be launched:

A custom launcher can also be configured to launch any app which you
have the UUID for – these can be discovered using Catapult for Pebble
or by contacting the Pebble app author.

Tasker: See Glance and Tasker

Configuring Glance / Settings

The majority of the configuration for Glance is done within the Android app Settings. Each setting is detailed below.

    • SMS
      • SMS Presets – Opens the SMS Preset Editor
      • SMS Recipient Source – Allows the SMS recipient list to be generated using either the default (Last few SMS recipients) or default + various combinations of numbers from the last calls list.
      • SMS Favourites – Allows some favourite numbers to be
        “pinned” to the top of the SMS recipient list
      • Alert on SMS sent – Send an alert when and SMS has been
        succesfully sent
      • Write SMS to Outbox – writes sent messgaes to the sysem
      • Send Actionabale notification – sends a notification
        includes the Glance Presets as actionable responses on your
        Pebble (at the bottom of the list)
      • NOTE: Due to the way numbers are stored in Android it is possible duplicate suppression will not work between different versions of the same phone number (i.e. national vs. international versions)
    • General
      • Foreground Service
        • On/Off : On can improve performance at the cost of memory
          use. Off by default.
      • Check for watch updates
        • On/Off : On will poll the server once a day to see if there
          is a new watchapp. On by default.
      • Filter Unicode
        • On/Off: When on unicode extended characters will appear as ?. When off they should work (i.e. with pebble bits firmware). If there are issues with SMS sending or Contact names please leave on.
      • Start Glance on Pebble when Android App starts
        • On/Off: When On Glance on Pebble will start with the Android app.
    • Bluetooth
      • Vibrate watch on bluetooth disconnect
      • Bluetooth vibe delay – delay time in seconds
      • Long vibe on disconnect – changes vibe type for
      • Invert on disconnect – invert Pebble screen on BT disconnect
    • Messages
      • Check for battery, unread Gmail/SMS : powers the Smartwatch unread message display, turn off if you don’t use that to save power.
      • Unread SMS count from Tasker/Intent: Take the unread SMS count from the contents of the intent TASKERMSGC (See recipes by Julian Starke here
    • Email
      • Email Provider:
        • Gmail – default using the local Gmail client (which needs to be enabled and working)
        • Intent – takes a number from an intent for use with Tasker or other Android app
        • K-9 – uses the K-9 mail client if installed
      • Gmail account : will populate with the default gmail account on your Android. Can be overridden if you have more.
      • Inbox settings for new Gmail inbox:
        • Default: The default inbox or the personal tab in the new inbox
        • All New Inboxes: The total of all the new in box tabs (Personal+Social+Promotions…etc)
        • Priority Inbox: The priority inbox
        • By Label: Will use the label selected in the following Preference
      • Recommended: Use By Label and select a label in “GMail Label for unread count”
      • GMail Label for unread count : lists the labels for the
        selected gmail account.
      • K9 Account : lists the installed K9 accounts to choose between
    • Weather
      • Temperature unit (C/F)
      • Frequency of weather updates : When off, weather will only update on demand (Middle button from the weather watchapp screen)
      • Weather Data Provider: Openweathermap, Yahoo or both (where
        Yahoo is used for the main watch display and openweather for the
        detail display as it has more data). can be used with an API key.
      • API Key: For you need to paste you API key here.
    • Location Settings
      • Override Location : If the location detection is failing, you
        can override it here by entering latitude,longitude in decimal
        form, e.g. 40.6893,-74.0446 is the Statue of Liberty
      • Location Provider
        • Network (default) : Low power coarse location from the cellular network. Should work for most.
        • GPS: High power fine location from the GPS. Will fallback to network if no GPS.
        • Location Services: Google Play Location Services “fused” provider. Google suggests this is the most modern provider, used for Google Maps etc
    • Calendar
      • Display All Day Events : Will filter all day events from the feed to Pebble when set to Off
      • Move on to next event n minutes after start of current: Allows you to see the next event rather than the current event a few minutes after it starts.
      • Calendars to use with Glance: Select the calendars to display on your Pebble via Glance
    • Location / Emergency SMS Message : Sends a preset message your current GPS location
      • Recipient Phone Number: The number to send to in full international form (e.g. +447725036251, +15551231234)
      • Message : The message to which the GPS location will be appended. GPS location is a embedded in a Google Maps link. Your message should be less than 100 characters.
    • Data Screens
      • Data Screen Font Size: Default (varies by screen), Medium or Large
      • UK Train Station Departing/Arriving: UK 3 letter codes for a train station for the departure data screen, e.g. WAT is Waterloo, RDG is Reading
      • NextBus Operator: Can be extracted from the NextBus website (Check your operator is supported here. You can find stops etc here). Once you have found your stop, look at the URL and the operator code is the a= parameter, e.g. bronx
      • NextBus Line,Stop list: From the url you found above, you want the r= and s= parameters as your line and stop. You can have a few listed here as pairs, e.g. BX1,100085,BX1,100086
      • Stocks: Yahoo! Finance instrument codes for the stocks
        data screen, e.g. GOOG,AAPL,GBPUSD=X
      • Stock Background Refresh Period(Hours) – Time between
        refreshing stock prices in background for inclusion in custom screens

Customise Watch

The Watchapp can be customised from the Android app “Customise Watchface” settings.

      • Watchface Editor : Launch the watchface editor (See below)
      • Watch menu Editor : Enables the customisation of the items on the Pebble Glance app menu. Remove the ones you don’t use to make the menu more usable.
      • Default Main Screen : Which screen will be the primary watch face (Big Weather, SmartWatch or SmartWatch without Gmail, SmartTime, SmartCal or Custom from the Editor)
      • Enable seconds on custom watchfaces : sets the Pebble to update the clock every second. Will impact watch battery life. ONLY SHOWS ON CUSTOM FACES USING THE APPROPRIATE CLOCK TYPE!
      • Show (tiny) phone battery% : Adds a phone battery % in the top right corner of the Pebble screen
      • White background: Inverts the main watch display
      • Vibrate on the hour
      • Button Mappings
        • Configure Custom Pebble App Launch : Allows any Pebble App that you know the uuid to be launch via the Pebble Menu or a button. Enter a UUID manually or use Catapult for Pebble to search
        • Top/Longpress : Maps the top button on your Pebble to open one of the Glance screens
        • Bottom/Longpress : Maps the bottom button on your Pebble
          to open one of the Glance screens
      • Alternate Watchapp settings
        • Slide in on Gesture : Enables flicking your wrist to get
          the weather and message count panel on the TextWatch and
          Analog faces

Watchface Editor:

A example faces can be found here

Layout List:
An list of the currently saved layouts

      • Save: Saves the layouts locally on your phone
      • Import: Tries to import the JSON for a layout into the list from the clipboard
      • Add: Add a new layout

Each row is a layout with the following actions:

      • Name: Tapping the name of the layout will open the editor.
      • Copy: Makes a copy of the layout
      • Send: Sends the layout to the watch, and sets it as the default. On failure should default back to BigWeather.
      • Share: Enables the JSON representation of the layout to be copied to the clipboard, email etc. Will attach a .gwf File to the email (or dropbox etc)
      • Delete: Deletes the layout

Layout Editor:
Displays a list of the layers making up a layout
Tap the title at the top of the screen to edit.
Click Save to save the layout and return to the layout list
Click Add to add a layer, with fifteen layers maximum. [ Some layouts show instability at 15 layers ]
Each layer has the following options:

      • Name: Tapping the name of the layer will open the layer editor
      • Up/Down: Move the layer up and down the drawing order
      • Delete: Delete the layer

Layer Editor:
Edits the parameters of a layer

      • Name: Tap the title to edit
      • Type:
        • Text
        • Image
        • Clock
        • Inverter
      • x,y,w,h : Location, Width and Height
      • Background: Layer background color
      • Foreground: Layer foreground color
      • Font: Text/Clock font
      • Alignment: Text/Clock/Image alignment
      • Content: Defines what is in the Text or Image. Format may be required.
      • Format:
        • Label: Should contain the label text, can contain
          custom data items in #format
        • Clock:
          • Should contain the strftime
          • %2 will display the time obeying the 12h/24h
            Pebble setting.
          • %3 will display the output from the timer
        • * Menu – shows the current values of additional data
          items that can be used. Tapping on one of these will add
          it in # format to the Label. # format = #DATAITEM
          inserts the value of the DATAITEM or just DATAITEM if no
          value is found. The format item is ended with a space or
          another # such that #DATAITEM#DATAITEM2# allows two dataitems
          to be added back to back with no space

Some special items


#speed = speed in mph
#speedo = + if on, – if off
#speed_high = high speed (during last period when speedo was running)
#speed_avg = average speed
– In the Customise screen on Android turn on “Enable seconds on custom watch faces” (otherwise the speed will not update frequently)
– Map one of you buttons to “Speedo” (makes triggering it on and off much easier)
The very first time you run the layout you will see “speedspeedo” or similar as there is no data in the local cache relating to it.
If you press the button you mapped to speedo you should see speed go to 0.0 and speedo go to + (and then – if you turn it off)
From then on in you should pick up whatever the last value was on any layout you have.
NOTE: Speedo turns on high accuracy GPS, which is a large battery drain. You have been warned.


MB_ARTIST = artist name
MB_TRACK = track name
MB_ALBUM = album name

Premium Content

Some of the features in Glance are only available as an in app purchase.
Keeping Glance maintained takes a surprising amount of my time. If you enjoy it and find it useful, then please consider buying the Premium version. Even if you don’t want the premium features its good karma and only the cost of a Starbucks or two. Thanks.