English · Русский · 简体中文 · 日本語
Shut down, reboot, suspend or hibernate on a countdown you can always cancel.
The remaining time sits in the bar, a full-screen warning takes the last thirty
seconds, and every surface — popup, overlay, notification, CLI — speaks the same
language.
Install · Screenshots · Usage · Settings · How it works · Changelog
The popup became an instrument instead of a form.
- A dial you can operate three ways. Drag it and the value moves with your hand, not to where you pressed (one turn is an hour, Shift is the fine gear); scroll over it for one minute a notch, five with Shift; or type into two boxes that take minutes and seconds — no colon to hunt for.
- The presets moved around the dial — 15 / 30 / 45 on the left, 60 / 90 / 120 on the right — so a common time is one click and the centre stays clean.
- Seconds are real.
0+40starts a forty-second timer; the daemon grew aset-secscommand for it. - A metal knob, a two-tone arc, a minute scale — and the figure fits by
construction, so
11:59:58shrinks instead of crossing the ring. - The layout is tested, not eyeballed:
tools/acceptance.shchecks the dial, the input and the hint share one axis, that the preset columns mirror each other, and that nothing overflows in any section.
A timer you have to reopen a menu to read is a timer you forget. This one lives in the bar: the remaining time next to the power mark, a paused state that says so, and an urgent mark in the last minute — readable at a glance, without stealing focus.
- Four actions: power off, reboot, suspend, hibernate.
- Four ways to pick a time, all of them fast: the wheel (a notch is a
minute, Shift five) works anywhere in the popup and on the bar icon without
opening it; six presets sit around the dial; the ring drags relatively —
one turn is an hour, Shift is the fine gear; and two boxes take minutes and
seconds without a colon to type (
0+40is forty seconds). - Schedule: repeating timers per weekday (
once/daily/weekdays/weekends), listed and removable from the popup. - Conditions: wait for inhibitors (a film, a backup) and a low-battery guard before the action fires; the popup says when it is holding.
- History: the last runs with their outcome (
executed/cancelled), so last night is not a mystery. - Keyboard-first: arrows walk the popup,
Enter/Spaceactivates,xremoves the selected schedule,c/p/s/rcancel / pause / snooze / reset. The overlay takesEscandEnterdirectly. - Languages:
auto(system locale),en,ru— one setting, followed by the popup, the overlay, the notification and the CLI alike. - Contrast-checked: popup and overlay text auto-clears 4.5:1 against the
theme surface, light and dark alike;
reducedMotiondisables the pulse and the easing.
Left: a design render of the v3 popup. Right: the live popup in the Flexoki Light theme. The live one takes every colour from the theme, so it looks different in yours — the layout is the same.
One page, top to bottom, no tabs: the action (shut down, reboot, suspend, hibernate), the dial with the six presets around it, the exact boxes for minutes and seconds, repeat (once, daily, weekdays, weekends) with a one-click add schedule, four guards (don't act on battery, quiet, wait for downloads, dry run) and the history of the last runs.
Right-click the mark cancels a running timer; inside the popup the arrows and
Enter do the same work as the mouse.
The four states in motion (idle → active → warning → countdown → paused):
Bar states, cropped from real screenshots — dark (ristretto) on top, light
(Flexoki Light) below. Every frame is the widget's own slot, cut from the bar
by tools/screenshots.sh; nothing is drawn by hand:
| state | dark | light |
|---|---|---|
| idle | ![]() | ![]() |
| active | ![]() | ![]() |
| last 5 min | ![]() | ![]() |
| paused | ![]() | ![]() |
| countdown | ![]() | ![]() |
The countdown — the last thirty seconds, on top of everything, in the theme's own accent:
The same widget when the bar stands on the left:
The overlay is the part that earns the plugin: a large monospace countdown, a
progress line, Отмена / Cancel and +5 минут / +5 minutes, with Esc and
Enter wired straight to them. It is a layer-shell surface, so it appears
without moving your windows, and it follows the system theme.
The mark at real bar sizes — 16 / 20 / 24 / 32 px, dark on top, light below. If it reads at 16 px, it reads everywhere:
omarchy plugin add https://github.com/valerkaaa/omarchy-shutdown-timer --enableOr by hand, which is also how you would install a fork:
git clone https://github.com/valerkaaa/omarchy-shutdown-timer ~/.config/omarchy/plugins/honor.shutdown-timer
omarchy plugin enable honor.shutdown-timerThen click the power mark in the bar. The plugin also works straight from
~/.config/omarchy/plugins/; omarchy plugin validate <dir> checks the
manifest.
omarchy plugin update honor.shutdown-timer # pull the latest release
omarchy plugin disable honor.shutdown-timer # keep the files, hide the widget
omarchy plugin remove honor.shutdown-timer # uninstall (files + bar entry)Removal cleans the plugin directory and its bar entry; the runtime state under
~/.local/state/omarchy/plugins/shutdown-timer/ is left behind on purpose, so a
re-install finds its history. Delete it by hand for a full reset.
Nothing beyond a stock Omarchy: bash, jq-free parsing, systemd-inhibit and
upower used opportunistically — the daemon runs without either. The overlay
uses the shell's own qs.Ui components.
Click the mark to open the popup, pick an action and a time, launch.
- Left click — the popup. Right click — cancel a running timer, or refresh when idle.
- In the popup: arrows move the cursor,
Enteractivates,Esccloses. Before the first arrow press,Enterlaunches the timer straight away. - In the overlay:
Esc/ Отмена cancels,Enter/ +5 postpones.
cd ~/.config/omarchy/plugins/honor.shutdown-timer
./control.sh set 30 poweroff # 30 minutes from now
./control.sh at 23:30 # at 23:30 (tomorrow if already past)
./control.sh status # add --json for machine-readable output
./control.sh pause && ./control.sh resume
./control.sh snooze 5
./control.sh cancel
./control.sh schedule add 23:30 daily poweroff
./control.sh schedule list
./control.sh schedule remove <id>
./control.sh history
./control.sh override echo # dry run: firings are logged, the machine stays on
./control.sh override off # back to real power actions
./control.sh override # show the current mode| command | does |
|---|---|
set <min> <action> |
arm a timer, 1–1440 minutes |
at <HH:MM> [action] |
arm it for a clock time |
status [--json] |
state, action, time left |
pause · resume |
stop and restart the countdown |
snooze <min> |
add minutes to a running timer |
cancel · reset |
drop the timer, or drop it and clear the action |
schedule add|list|remove |
repeating timers |
history |
the last runs and their outcome |
override echo|off |
the dry-run switch |
| Key | Default | Meaning |
|---|---|---|
language |
auto |
auto follows the system locale; en / ru force one. |
refreshIntervalSec |
1 |
Poll interval. |
notifyEarlyMins |
5 |
Early warning; 0 disables it. |
overlaySeconds |
30 |
Length of the full-screen countdown. |
defaultAction |
poweroff |
Pre-selected action. |
snoozeMins |
5 |
Length of one "snooze" / "+N minutes". |
presets |
15,30,45,60,90,120 |
Quick-pick buttons in the popup. |
quiet |
false |
Suppress notifications while a timer is armed. |
batteryGuard |
false |
Do not run the action on low battery. |
batteryThreshold |
20 |
Low-battery threshold, percent. |
waitForInhibitors |
false |
Wait until inhibitors clear before firing. |
reducedMotion |
false |
Static icon, no progress-bar easing. |
The dry run switch is not a setting but a file (<state>/action-override):
while it holds a command, the daemon runs <command> <action> instead of the
power command. Toggle it from the menu (Advanced → Dry run) or with
control.sh override echo|off — the honest way to let a one-minute timer reach
zero without powering the machine off.
omarchy bar set honor.shutdown-timer language ru
omarchy bar set honor.shutdown-timer overlaySeconds 60 --jsonOne plugin, two kinds (manifest.json: bar-widget and overlay):
Panel.qml the bar mark and its popup
Overlay.qml the full-screen countdown (PanelWindow + WlrLayershell, IPC target honor.shutdown-timer:overlay)
Service.qml polls state.json, exposes set/cancel/pause/…, and tr()
Model.js formatting and the string table (STRINGS, t(), resolveLang())
TimerIcon.qml the power mark, drawn as a vector
daemon.sh owns the timer, writes state.json, fires the notification, summons the overlay
control.sh the CLI, and the fallback the overlay uses if the daemon is unreachable
State lives in ~/.local/state/omarchy/plugins/shutdown-timer/: state.json,
daemon.log, daemon.pid, control, settings.json, schedules.tsv.
The daemon is a small bash process. control.sh ensure starts it after a crash;
Service.qml restarts it if it is not there. A single flock guarantees one
daemon — the pid file is only a hint, the lock is the truth. Stopping follows
the same rule: daemon-stop signals the process that holds the lock, so a pid
left behind by a killed daemon (and later reused by an unrelated program) is
never mistaken for the daemon and never signalled.
The daemon owns the countdown, so it is written to survive whatever lands on its doorstep:
- The command channel is a file, not a socket: any process in the session
can write into it. Every command is therefore validated by the daemon itself
(not only by
control.sh): minutes must be 1..1440, the action one ofpoweroff|reboot|suspend|hibernate|lock,HH:MMin range, the snooze count a positive number, and schedule ids[0-9A-Za-z]+with weekdays 1..7. Anything else is logged and ignored — it used to be able to kill the daemon outright, and with it a pending shutdown. state.jsonis written atomically (tmp+mv), so a reader never sees a half-written file and akill -9in the middle leaves the previous state intact. An overdue timer re-opens the countdown window on restart instead of firing silently.settings.json,state.jsonandschedules.tsvare re-read on every tick, so a half-written or hand-edited file cannot take the timer down: numeric settings are validated and clamped to their documented range, every state field falls back to a safe default, and junk lines in the schedule file are skipped. Covered bytests/test_state_files.sh.- No network access, no
eval, nocurl | bash: the plugin is the files it ships plusbash.
omarchy-shell honor.shutdown-timer status # state + action + time left
omarchy-shell honor.shutdown-timer debugLayout # bar/popup/hero geometry numbers
omarchy-shell honor.shutdown-timer debugOverflow # children spilling out of the popup
omarchy-shell honor.shutdown-timer:overlay cancel # same path as the overlay buttondebugOverflow returns {"count":0,"items":[]} in every state when the layout
is clean; anything listed there is a real overflow, with the item path and side.
bash tests/run_all.sh # every test, one verdict: SUITE: ALL GREEN
bash tools/acceptance.sh # the acceptance list, for a human
python3 tools/contrast_report.py # text against the theme surface, 4.5:1The suite covers cancellation races, the absolute-time parser, the daemon's validation, schedules, state files, sleep and resume, and a performance budget. Most of it runs without a live shell, so it works over SSH.
- A new timer always overwrites the previous one — no confirmation dialog.
- Every path that executes a power action goes through the claim file: the
daemon only runs the action when it wrote
COUNTDOWNand the claim is still fresh, so a cancel that lands in the same second wins. - To test without powering off: wait for
COUNTDOWN, then cancel and checkstate.jsonis back atIDLE— or flip the dry-run switch (Advanced → Dry run) and let the timer actually reach zero. - A deadline that passes while the machine is suspended opens the countdown window on wake instead of firing into a black screen.
honor.shutdown-timer/
├── manifest.json declaration: two kinds, the settings schema (incl. language)
├── Panel.qml the bar mark and the popup
├── Overlay.qml the full-screen countdown
├── Service.qml polls state.json, exposes set/cancel/pause/…, tr()
├── Model.js formatting and i18n (STRINGS, t(), resolveLang())
├── TimerIcon.qml the power mark (canonical MDI geometry, bevel copies)
├── daemon.sh the timer daemon
├── control.sh the CLI
├── assets/ plugin-store icons, SVG twins of the mark, screenshots
├── tests/ the suite behind tests/run_all.sh
└── tools/ dev scripts: screenshots, geometry checks, contrast report
MIT — see LICENSE. Not affiliated with Omarchy; a plugin for it.














