Toggles, Idle & the Screensaver¶
A lot of what you change day to day isn't really a setting. It's a mode you flip on for an hour and off again: night light while you're working late, do not disturb while you're presenting, stay awake while you're watching something. OmarOS calls those toggles, and they all work the same way — a hotkey, a menu entry, and a command, all hitting the same switch.
The toggle menu¶
Super + Ctrl + O opens Trigger > Toggle directly, or you can walk there from the OmarOS menu (Super + Space). Everything in that list is a switch you can flip without thinking about where the state lives. Switches for how the desktop looks sit next to it, under Trigger > Appearance.
From the terminal, the same switches are omaros toggle <thing>. Run omaros toggle on its own to see the whole group.
| Toggle | Hotkey | Command |
|---|---|---|
| Night light | Super + Ctrl + N |
omaros toggle nightlight |
| Silence notifications | Super + Ctrl + , |
omaros toggle notification silencing |
| Stay awake (no idle lock) | Super + Ctrl + I |
omaros toggle idle |
| Screensaver | — | omaros toggle screensaver |
| Herdr theme sync | — | omaros toggle theme sync |
| Menu bar | Super + Shift + Space |
omaros toggle bar |
| Touchpad | XF86TouchpadToggle |
omaros toggle touchpad |
| Touchscreen | — | omaros toggle touchscreen |
| Suspend | — | omaros toggle suspend |
| Hybrid GPU | — | omaros toggle hybrid gpu |
The touchpad, touchscreen, and hybrid GPU switches live under Trigger > Hardware (Super + Ctrl + H) rather than under Toggle, since they only show up when you actually have that hardware. The touchpad and touchscreen ones survive a Hyprland reload — the disabled device's name is saved to a small state file that Hyprland reads on startup to disable it again.
Trigger > Appearance holds the menu bar and animations, plus a few things that aren't omaros toggle commands but behave the same: battery percentage in the bar, the default workspace layout, window gaps (Super + Shift + Backspace), and the 1-window square aspect (Super + Ctrl + Backspace).
Most of these are just a flag file under ~/.local/state/omaros/toggles/. If you want to branch on one in a script, omaros-toggle-enabled gives you an exit code instead of making you go looking:
The flags are named for the off state — screensaver-off, suspend-off, bar-off — so their presence means the feature is disabled.
Indicators in the bar¶
When a mode is on, you get a small glyph in the middle of the top bar next to the clock. That's the indicators widget, and it carries dictation, screen recording, pending reminders, night light, do not disturb, and stay awake.
Inactive indicators are hidden. Hover anywhere on the bar and they fade in dimmed, so you can click one to turn it on without knowing its hotkey. Clicking an active one turns it back off. If you'd rather see all of them all the time, set alwaysShow to true on the omaros.indicators entry in ~/.config/omaros/shell.json — see the top bar for how bar widgets are configured.
Night light¶
Super + Ctrl + N warms the screen to 4000K, and hitting it again puts it back to 6500K. It's driven by hyprsunset, which the toggle starts for you if it isn't already running.
By default hyprsunset does nothing to your screen at all. ~/.config/hypr/hyprsunset.conf ships with an identity profile precisely so the display stays untouched until you ask for warmth. If you'd rather have it switch by the clock, replace that with a time profile:
Then start hyprsunset at login by adding o.launch_on_start("hyprsunset") to ~/.config/hypr/autostart.lua. The 4000K/6500K pair used by the toggle is fixed, so the config file is where you go if you want a different temperature.
Do not disturb¶
Super + Ctrl + , silences notifications. No toasts pop up while it's on, and the crossed-out bell indicator sits in the bar to remind you why the desktop has gone quiet.
Nothing is lost, though. A silenced notification is written straight into your notification history, which is exactly the record you want when you come back and wonder what you missed. Open it with Super + Shift + Alt + ,. See notices for the rest of the notification story.
Two kinds of message still get through: OmarOS's own confirmation toasts for something you just did ("Theme changed", "Screenshot saved"), and critical alerts sent from the command line. Chat apps that mark everything critical to force their way in front of you don't qualify.
Idle¶
The OmarOS shell owns idle behavior, and the timings are a top-level idle block in ~/.config/omaros/shell.json:
Both numbers are seconds counted from the moment you went idle — not from each other. So with the defaults, the screensaver comes up after two and a half minutes and the lock screen takes over at five minutes, whether or not the screensaver ran. Save the file and the shell picks up the new timings right away.
If you dismiss the screensaver before the lock deadline, that counts as activity and the pending lock is cancelled. You don't get locked out for glancing at your machine.
To stop locking on idle entirely, Super + Ctrl + I — or omaros toggle idle — flips stay awake on, and the coffee cup indicator appears in the bar. That's the one to hit before a long presentation or a build you want to watch. Hit it again to go back to normal. omaros toggle idle status prints the current state as JSON if you need it from a script.
This is about locking and the screensaver, not power. Suspend and hibernation have their own setup in system sleep.
The screensaver¶
OmarOS's screensaver is ASCII art running through random text effects, one instance per monitor. Any key or mouse movement exits it.
You can start it on demand from System > Screensaver (Super + Esc), which forces it up even if you've turned the idle screensaver off. There's no hotkey bound to it by default.
omaros toggle screensaver is what turns the idle one off, if you'd rather go straight from working to locked. It needs a terminal it knows how to configure — Alacritty, Foot, Ghostty, or Kitty — and will tell you so if your default terminal is something else.
The logo it draws is yours to change, under Style > Screensaver. Upload a png or svg and OmarOS converts it to ASCII. See branding.
The lock screen¶
Super + Ctrl + L locks the machine. That runs the lock screen from the OmarOS shell, blanks the display, resets your keyboard layout to the first one so you're not typing your password in the wrong alphabet, and — if you have it running — locks 1Password on the way out.
The lock screen takes a password, and it'll take a fingerprint too once you've set one up. That, and the other ways to authenticate, are covered in hardware authentication.