Getting Started ​

Timer definitions in Thymer are entered as TOML in the phone-side settings page. While it can be useful for quick changes, I don't recommend editing your timers extensively in that small input box. Personally, I copy paste my configuration from my note taking app, where I make changes on my computer that are synced to my phone.

The app parses the TOML configuration on the phone, validates it, and sends a normalized timer model to the watch. Some additional appearance settings can be configured direction in the phone-side settings page.

The parser accepts # comments. It also rejects unsupported keys instead of ignoring them, so typos in timer fields and inline tables fail fast.

Thymer is on the Pebble Appstore.

Start with one timer ​

Every config needs at least one named timer section under timers.*.

toml
[timers.focus]
trigger = { tap = "top" }
time = "00:25:00"
warn-at = "00:05:00"

That example uses:

  • a named timer key, focus
  • a required trigger
  • a required time or pattern
  • time values written as HH:MM:SS

What lives at the top level ​

Only these top-level sections are part of the current config model:

  • [vibration]
  • [timers.<name>]

Appearance settings ​

The settings UI also exposes watch-side appearance toggles for icon display, background display, and timer accent. Those toggles are not part of the TOML config. They are stored separately from the timer definition.

Next steps ​

  • Read Config Format for the supported top-level structure.
  • Read Timers for per-timer fields.
  • Read Cookbook for worked recipes and longer configs.