Focus Timer

Pomodoro cycles, countdowns and a stopwatch. Notifies when a phase ends.

At a glance

OutputLiveRendered by the engine and streamed over Bluetooth as its data changes (about 5–9 frames a second).

Settings8every one editable live in the studio, or by an agent with update_app_settings

ButtonsStart/Pause · Reset · Skipstudio buttons, or app_action over MCP

Sourcetimer.pysrc/deskdot/apps/timer.py

Settings
Setting	Type	Default	Options / range
Mode`mode`	choice	Pomodoro	PomodoroCountdownStopwatch
Focus (min)`focus`	whole number	25	1 – 180
Break (min)`short_break`	whole number	5	1 – 60
Long break (min)`long_break`	whole number	15	1 – 90
Rounds before long break`rounds`	whole number	4	1 – 12
Countdown (min)`countdown`	whole number	10	1 – 999
Focus colour`focus_color`	colour	#ff1e5a	any colour (#rrggbb)
Break colour`break_color`	colour	#00ff8c	any colour (#rrggbb)

render a frame to PNG (no panel needed)

$ uv run deskdot preview timer --settings '{"mode":"countdown"}' --out timer.png

show it on your panel (engine running)

$ curl -X POST http://127.0.0.1:8765/api/apps/timer/activate

Or ask your agent: “Show Focus Timer on my panel”. It calls show_app with "timer". New here? Set up DeskDot first.

Up to three daily habits with a 7-day dot row, today's tick and a streak flame.

LIVE/REC badges with elapsed time, current scene and dropped frames from OBS Studio.

Share your Wi-Fi, a link or a note as a scannable QR code (encoder written from scratch).

HTTP and TCP checks with latency sparklines, a status grid and outage alerts.