A Quickshell preferences window for Omarchy. It follows the active theme and writes through omarchy commands and Hyprland drop-ins. Settings live in ~/.config.
./bin/atmosEvery launch opens its own window: run it twice and two windows open, each with its own engine. Open windows stay in sync through the files they share — a change in one appears in the other — and concurrent writes serialize on disk, so they cannot tear a config file. Pass a page if you want a window to land somewhere specific:
./bin/atmos appearance
./bin/atmos windows/bindings
./bin/atmos network/wifiHubs include home, monitor, favorites, appearance, displays, windows, bar, notifications, input, accessibility, sound, capture, hardware, drivers, disks, network, power, idle, defaults, applications, software, hooks, security, accounts, and system.
curl -fsSL https://raw.githubusercontent.com/csfh/atmos/alpha/install.sh | bashThat copies the launcher into ~/.local/bin, the QML app into ~/.local/share/atmos, and the desktop file plus Hypr drop-in into the usual XDG config dirs. From a clone, ./install.sh does the same thing. System → Atmos follows the alpha git branch for Check and Update.
See CHANGELOG.md for every alpha tag.
npm install
./tests/run./tests/run lints and checks formatting with oxlint and oxfmt, parses scripts/*.py, then runs the parser tests. npm run lint and npm run fmt run those tools on their own.
npm install points Git at .githooks/, so commits run oxlint, oxfmt --check, and tests/compile-python first. git commit --no-verify skips that. From a clone that already has node_modules, run scripts/install-git-hooks.sh.
Pull requests and pushes to main and alpha run ./tests/run on GitHub Actions (.github/workflows/tests.yml). The live Omarchy snapshot step is skipped on those runners.
MIT. See LICENSE. Copyright (c) 2026 Christoffer Hallas.
UI glyphs in icons/ are from Remix Icon, Remix Icon License v1.0. See icons/NOTICE.
If you send a pull request or other contribution, you agree to the CLA.