Skip to content

README.md

Latest commit

 

History

History
51 lines (41 loc) · 2.28 KB

README.md

File metadata and controls

51 lines (41 loc) · 2.28 KB
Raw

Timer → LED

Count-up or countdown timer rendered as a level bar. Green while there's plenty of time left, fading to red as the deadline nears. A cyan ↔ magenta strobe plays for 3 s when the run finishes.

Unlike claude/ and gitlab/, this integration ships no JSON profile — it fires led raw level directly, the right pattern when parameters are computed on the fly (here: a percentage and an RGB gradient interpolated per tick in Python).

Usage

led timer 5m                # count up:   0 → 5m  (default)
led timer --up 5m           # explicit count-up
led timer --countdown 5m    # count down: 5m → 0

<duration> accepts 30, 30s, 5m, 1h30m, …

How it works

  • Per-tick STATE, not TRANSIENT. Each tick is a persistent state update under a per-invocation session id (timer-<pid>); the latest level always wins. A TRANSIENT (3 s TTL) would flicker if a tick ever arrived late.
  • finally + SIGTERM handler. Ctrl-C the timer, or have systemd/ launchd stop it, and the finally block still fires --end-session, so the strip goes dark instead of freezing on a partial level.
  • Color logic independent of direction. Both modes feed elapsed fraction into the gradient: 0% green → 100% red. Countdown inverts the level (100% → 0%) but not the color — "red" always means "near the end", whichever way the bar moves.
  • raw level bypasses JSON profiles entirely. The CLI assembles the wire line from --rgb/--level and sends it byte-for-byte — same daemon path as a state-keyed call, just without the lookup.
  • Drift-free scheduling. Each tick targets start + N * TICK_INTERVAL rather than sleeping a flat TICK_INTERVAL, so per-tick overhead (the led socket call, subprocess spawn) doesn't accumulate into seconds of overshoot on long runs.

Requires the daemon running and led on $PATH (pipx install . && led service install).

Files

File Purpose
timer.py The timer logic (entry point: led timer)
integration.json Manifest declaring timer.py as the run script
README.md This file