Glance – Instructions

Glance for Pebble 0.9

QuickStart
Getting Started
Using the WatchApp
Configuring Glance
Customising the WatchApp
Watchface Edtior
Premium Features

QuickStart

  • 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.

glance-android-main-cropped

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.
bug
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:

smartwatch smarttime smartcal bigtimewhite

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

In Glance 0.9c two new premium editions of the watch app – TextWatch and Analog. These editions 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.

Watchfaces:
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.

SMS:
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).

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

LostPhone:
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.

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

Launchers:
Various Pebble Apps can be launched:


Tasker:
Shows a watch and three lines of Tasker ready text.

  • To populate the face use the Intent uk.co.finebyte.pebbleglance.TASKERSEND with a String Extra in the format msg:ToGoOnLine1:Line2:Line3
  • When the face initialises it sends the Intent uk.co.finebyte.pebbleglance.TASKERINIT
  • When the face stops it sends the Intent uk.co.finebyte.pebbleglance.TASKERSTOP
  • When a button is pressed it sends the Intent uk.co.finebyte.pebbleglance.TASKERKEY with the Extra key sent to TASKERTOP, TASKERMID and TASKERBOT as you would expect
  • When a button is long pressed it sends the Intent uk.co.finebyte.pebbleglance.TASKERKEY with the Extra key sent to TASKERLTOP, TASKERLMID and TASKERLBOT as you would expect
  • Use uk.co.pebbleglance.TASKERVIBE to make the pebble vibrate
  • Use uk.co.pebbleglance.TASKERMSGC to set the message count on the SMS counter
  • When the face thinks it needs to refresh the message count it sends the Intent uk.co.finebyte.pebbleglance.TASKERMSGCINIT
  • Launch Glance with intent uk.co.finebyte.pebbleglance.STARTGL

NOTE: In Tasker Intents are received in Profile->Event->System->Intent Received and sent in Task->Misc->Send Intent
Christopher Stein wrote some notes on howto use this feature here

Configuring Glance

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

  • SMS Presets – Opens the SMS Preset Editor
  • Service
    • 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
  • 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
    • 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
    • GMail Label for unread count : lists the labels for the
      selected gmail account.
  • 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). forecast.io can be used with an API key.
    • API Key: For forecast.io 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
    • 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

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: Does what is says for the main watch display
  • 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 settingsL 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:
glance-wfe-layouts-cropped
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:
glance-wfe-layers-cropped
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:
glance-wfe-layereditor-cropped
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 < 20 characters
    • Clock: Should contain the strftime format. Additional format of %2 which will display the time obeying the 12h/24h Pebble setting.
      Note: The srtftime %Z causes a pebble crash in some of the SDK2 betas, and Pebble doesn’t do timezones anyway…

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.