Omahub
Sign in with GitHub
← All plugins
A

Screen Time

by agx

Tracks daily screen time per app, shows today's total in the bar, and summarizes usage patterns

GitHub
Install
$ omarchy plugin add https://github.com/ax1g/quickshell-screentime-plugin --enable
Productivity #Hyprland #bar #quickshell

Screen Time

Per-app screen time for the Omarchy bar. A lightweight service tracks how long each app keeps focus, the bar shows today's total, and a popup breaks the day down into a donut chart with a 7-day usage trend.

<p align="center"> <img src="assets/panel.png" width="47%" alt="Screen Time panel: today's total, donut and legend"/> <img src="assets/patterns.png" width="47%" alt="Panel with the usage-patterns section expanded"/> </p>

Features

  • Per-app tracking — focus time is accrued per app; idle, locked and desktop time is never counted.
  • Terminal-aware — with a terminal focused, resolve_app.py reports what is actually running inside it (opencode, not foot), re-resolving every few seconds. Browser subprocesses are canonicalized into one app.
  • Donut chart — today's apps as a ring with a legend and the day's total in the centre. Apps beyond the six biggest fold into an "Other" slice.
  • Usage patterns — press p (or click PATTERNS) to unfold a 7-day trend strip, top app, today vs. yesterday, and your busiest day.
  • Icon-only mode — right-click the bar widget to collapse it to a single glyph; the choice is remembered.
  • Private by design — history is local append-only JSON, pruned after 31 days, and colours are generated from your theme's accent.

Usage

Click the bar widget to open the panel. Esc closes it, p toggles the patterns section, and j / k (or arrows) scroll if the panel overflows. Right-click the widget to switch between "glyph + time" and glyph-only.

Install

omarchy plugin add https://github.com/ax1g/quickshell-screentime-plugin.git
omarchy plugin enable agx.screen-time

Requires Omarchy, Hyprland, and a Nerd Font for the glyphs.

Data

History is stored at ~/.config/omarchy/screen-time/history.json as { "days": { "<YYYY-MM-DD>": { "total": <ms>, "apps": { "<appId>": <ms> } } } }. Focus is credited to the day it started on, so a session spanning midnight still lands on the right day. Delete the file to reset tracking.

Development

The plugin hot-reloads on save, so you can iterate through a symlink:

ln -s "$PWD" ~/.config/omarchy/plugins/agx.screen-time
node --check Model.js && node --test tests/model.test.js
python3 -m unittest discover -s tests

CI runs the same checks on every push.

License

MIT