Named timers and Pomodoro sessions in a small floating widget for Omarchy. Native Rust and GPUI, black and charcoal surfaces, light gray type and bright orange actions.
| Stack | Dial | All timers | Mini |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
curl -fsSL https://raw.githubusercontent.com/last-refuge/focus/main/install.sh | bashThis installs the latest release under ~/.local (no root): the focus command, a launcher entry and an icon. Run the same line again to update. The prebuilt binary is for x86_64 Linux with a current glibc (2.44 or newer, as on an up-to-date Omarchy or Arch) and is checked against its published SHA-256. On any other system the installer builds the same release from source instead, which needs git and Rust through rustup (sudo pacman -S rustup && rustup default stable) and takes a few minutes.
Then, on Hyprland, once:
focus setup-hyprland # borderless, no Omarchy title bar, pinned above other windows from the first frameSet these before bash to change what gets installed, for example curl -fsSL … | FOCUS_VERSION=1.0.0 bash:
| Variable | Effect |
|---|---|
FOCUS_VERSION |
A release such as 1.0.0, or a branch such as main (built from source). Default: the latest release |
FOCUS_FROM_SOURCE=1 |
Build from source even when a binary is available |
PREFIX |
Where to install. Default: ~/.local |
From a checkout, ./install.sh builds and installs that checkout. An Arch package is described in packaging/PKGBUILD (cd packaging && makepkg -si). The binary is self-contained: the Inter font, icons and completion chime are built in.
focus open the widget (starts Focus if needed)
focus toggle show or hide it, for a Hyprland binding
focus hide hide it; timers keep running and still alert you
focus new open the widget with the new timer editor
focus quit quit; running timers resume when Focus opens again
focus stop stop finished timers and their repeating alarm
focus --hidden start in the background, for example at login
focus --demo explore the five reference timers in a disposable profile
One instance runs at a time; later invocations hand their request to it over a local socket. Closing the window hides it. When a timer finishes it glows and pulses orange and the chime repeats until you press Stop (or Escape, the notification's Stop, or focus stop). Mini shows every running and finished timer in compact rows. The widget always floats on top of other windows (including fullscreen ones) on every workspace, has no title bar, and reopens where you last left it; drag it by its header.
| Keys | Action |
|---|---|
| Ctrl N | New timer |
| Space | Start, pause or resume the selected timer |
| Up / Down (or J / K) | Choose a timer |
| Alt Up / Alt Down | Reorder |
| E or F2, Delete, Ctrl D, R | Edit, remove, duplicate, reset |
| Enter | Activate the focused control; submit a sheet |
| Escape | Close a menu or sheet and restore focus; otherwise stop finished timers |
| Tab / Shift Tab | Move between controls |
| Ctrl M, Ctrl Shift C | Mini widget, collapse all rows |
| Ctrl , / Ctrl W / Ctrl Q | Settings / hide / quit |
Durations accept 25m, 90s, 1h 30m, 4:30 (minutes and seconds) and a bare number of minutes, up to 99:59:59.
| Path | Contents |
|---|---|
$XDG_STATE_HOME/focus/state.json |
Timers, presets and selection: versioned JSON, atomic writes, state.json.bak as the last good copy |
$XDG_CONFIG_HOME/focus/config.toml |
Preferences (layout, sound, notifications, theme, corners…) |
$XDG_RUNTIME_DIR/focus/ |
Instance lock and command socket |
--profile DIR keeps all of these under one directory.
cargo test # timer, Pomodoro, storage, IPC and preference tests
cargo clippy --all-targets
cargo run -- --demo --layout list
FOCUS_FRAME_STATS=1 cargo run --release -- --demo # per-frame CPU time and interval on stderrNative checks that need a compositor (display scales, monitor removal, IME, AT-SPI, notification failures and buttons, a suspend stand-in) live in scripts/native-checks/. They run in a nested Hyprland and a private D-Bus session, so they leave the desktop's settings alone.
To cut a release, bump the version in Cargo.toml and packaging/PKGBUILD, commit and tag it vX.Y.Z, run scripts/release.sh, and attach the two files from dist/ to a GitHub release. The installer picks up the newest one.
GPUI is pinned to one Zed revision for both gpui and gpui_platform (see Cargo.toml), the toolchain to Rust 1.99. Source layout:
src/main.rs command line, single instance, app start
src/app.rs app lifetime, timer scheduling, effects (save, notify, sound)
src/timer/ timer model, commands, deadlines, durations, clock
src/pomodoro.rs phase settings and progression
src/persistence.rs versioned state, recovery, atomic writes
src/preferences.rs config.toml
src/platform/ paths, IPC, Hyprland adapter, completion sound
src/theme.rs semantic tokens, Focus and Omarchy palettes
src/ui/ widget, featured and list layouts, sheets, text field
See docs for the build plan, interaction specification and validation record, and branding for the design references.



