Skip to content

Themes

Jump to bottom
Maciej Janiszewski edited this page Mar 9, 2019 · 1 revision

Users can personalize their MS Bands by using themes. Themes have two elements.

  • Color Scheme
  • Me Tile background

Color Scheme

A set of 6 colors encoded as cuint32. I provided default values from Cargo for reference.

  • Base Color (#7842cf)
  • Highlight (#8b61f2)
  • Lowlight (#693fbc)
  • Secondary Text (#a7a7aa)
  • High Contrast (#885af9)
  • Muted (#482d8c)

Me Tile background

Device can also display a wallpaper image on Me tile. Image is encoded as bgr565 without headers. For Cargo, there are 156 default wallpapers - 12 styles, 13 colors schemes. Only current image, style ID and wallpaper ID is stored on device. While Health app could probably fetch image from device from preview, it's only using IDs to display one of default images.

Image Size

Different Bands require different image sizes.

  • Cargo: 310 x 102,
  • Envoy: 310 x 128.

Personalization Flow

  1. Phone sends CargoInstalledAppListStartStripSyncStart command to block the UI.
  2. Band displays Syncing screen.
  3. Phone sends CargoThemeSetFirstPartyTheme command with 6 uint16 numbers (colors) as payload.
  4. Phone sends CargoFireballWriteMeTileImageWithID command with background ID as argument.
  5. Phone sends CargoInstalledAppListStartStripSyncEnd command to unblock the UI.
  6. Band goes back to home screen.
Clone this wiki locally