Skip to content
This repository has been archived by the owner on May 7, 2024. It is now read-only.

Creating Themes

benjymous edited this page Oct 1, 2012 · 1 revision

themes

Creating a theme

  • Download the Example theme zip from below, and unzip it
  • Edit the bitmaps as you see fit. Make sure to not change the names, and to keep the files the correct format, and in black and white.
  • You can delete any files that you haven't modified - the app will automatically use the default ones.
  • Create a 512x128 pixel banner for your theme, and save it as theme_banner.png
  • Edit theme.xml to match your new theme
  • Re-zip your files, ensuring that everything lives at the root of the zip (i.e. contains no subfolders)

Testing your theme

  • As long as you've run MetaWatch Community Edition at least once, the themes folder will be created automatically at /Android/data/org.metawatch.manager/Files/Themes/
  • Drop your zipfile into that folder
  • In the preferences screen, use the Themes picker to select your theme
  • MW-CE will automatically use the bitmaps from the zip when it next refreshes the watch (if you replace the zip, it will also automatically reload the assets, so you can keep tweaking the bitmaps)

Distributing your theme

Notes

  • Any assets not found in your theme zip will fall back to the built-in assets, so you can omit the assets you haven't modified.
  • Note the additional special xml files - theme.xml contains the description and author info displayed in the theme picker and the gallery, notification.xml and notification_sticky.xml let you modify the layout of the notifications.

Sample zips

TODO

  • Add more layout files, so that themes can modify the way widgets/screens are laid out
  • Change the extension of themes, and make MWM a handler (so themes can automatically be installed to the right place when downloaded)
Clone this wiki locally