Skip to content
last-refugePublic

About

A small floating timer widget for Omarchy, built in Rust and GPUI. It runs named timers and Pomodoro cycles side by side and stays pinned above your windows on Hyprland. Finished timers glow and repeat a chime until you stop them. Timers keep counting through suspend, restart and reboot.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

Focus

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
Stack Dial All timers collapsed Mini

Install

curl -fsSL https://raw.githubusercontent.com/last-refuge/focus/main/install.sh | bash

This 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 frame

Set 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.

Use

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.

Where things live

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.

Develop

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 stderr

Native 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.

About

A small floating timer widget for Omarchy, built in Rust and GPUI. It runs named timers and Pomodoro cycles side by side and stays pinned above your windows on Hyprland. Finished timers glow and repeat a chime until you stop them. Timers keep counting through suspend, restart and reboot.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages