Screen Time

iOS-style digital wellbeing for Omarchy v4: how long each application actually held your focus today, with proportion bars and a week-at-a-glance chart.

Two parts in one plugin:

• an always-on tracker service that accumulates focus spans from the compositor's own event stream (no polling) and writes one small JSON file per day under ~/.local/state/omarchy/screen-time/;
• a summonable panel with today's per-app breakdown (live — the open span counts up as you watch) and the last seven days.

AFK is handled honestly: an idle monitor that deliberately ignores idle inhibitors closes the span after two minutes without input — walking away during a video does not count as usage.

Install

omarchy plugin add https://github.com/devmobasa/omarchy-screen-time --enable

Open the panel:

omarchy-shell shell toggle community.screen-time '{}'

Scripting

omarchy-shell community.screen-time status   # live tracker state + top apps
omarchy-shell community.screen-time flush    # force a write now

Privacy

Everything stays on disk in your state directory as plain JSON — no titles are recorded, only app ids and timestamps. Delete the directory to forget everything.

Tests

OMARCHY_PATH=/path/to/omarchy ./test/all

License

MIT