ArmoryOS docs
Everything there is to know about the project — what it is, how it is built and how it is maintained. Private beta: informational only, no downloads or repositories are published at this stage.
01 — overview
ArmoryOS is an opinionated desktop environment layer for Arch Linux, built around the Hyprland Wayland compositor. It is not a distribution: it is a curated configuration system — packages, dotfiles, theming and operational tooling — that turns a clean Arch install into a coherent trading-terminal workstation in a single automated run.
The project is developed and maintained by QUANTARMY. It started as a fork of a community dotfiles set and was rewritten around one idea: one aesthetic, zero noise, everything maintained on purpose.
02 — philosophy
- One curated look. Bar, prompt, fetch, notifications, launcher and lock screen share a single visual language. There are no theme menus — the aesthetic ships finished.
- Everything is a feed. The bar, the prompt and the fetch behave like data terminals: dense, monochrome-first, with signal-colored accents only where something needs attention.
- 0-day compositor tracking. Hyprland is followed the day it releases; breaking changes are absorbed by the config, never by the user.
- No blind upgrades. Upstream changes are reviewed and merged by hand into the ArmoryOS release line.
- Reversible by design. Every automated change is preceded by a timestamped backup.
03 — the spec
| LAYER | WHAT YOU GET |
|---|---|
| Base | Arch Linux, linux-zen kernel, btrfs root |
| Compositor | Hyprland ≥ 0.56 (Wayland), Lua-IPC native configuration, hypridle / hyprlock / hyprsunset stack |
| Bar | waybar (git track) with data-feed modules and click/scroll actions |
| Shell | zsh + powerlevel10k dashboard prompt, autosuggestions, syntax highlighting, kitty terminal |
| Theming | single palette across bar, prompt, fetch, swaync, rofi, lock screen and Qt applications |
| Wallpaper | awww daemon with self-healing watchdog, curated palette locking |
| Hardware | ultrawide-ready display stack, AirPods battery + ANC
control via librepods |
04 — the playbook
A clean Arch install becomes ArmoryOS through a four-stage automated playbook. It is idempotent — safe to re-run after every update:
| STAGE | WHAT IT DOES |
|---|---|
| 00 · check | Environment and sanity gates: OS, privileges, connectivity. |
| 01 · packages | Official repos + AUR, including the git-track bar required by current Hyprland. |
| 02 · deploy | Configuration rollout with a timestamped backup of everything it touches; machine-specific display data is preserved. |
| 03 · post | Theming, default wallpaper, final wiring and a readiness summary. Relog, and the desktop is coherent. |
05 — maintenance & updates
- Release line. ArmoryOS versions its own releases independently of
upstream dotfiles. The current line is
v1.0.0-armoryos. - Update channel. The desktop itself notifies when a new ArmoryOS release exists; applying it never breaks a running session.
- Upstream merges. Community dotfiles changes are fetched, reviewed for regressions (IPC changes, pruned components, branding) and merged manually.
- Live-to-repo sync. Changes made on a running system can be pulled back into the source of truth with a diff-first workflow.
06 — faq
Is ArmoryOS a Linux distribution?
No. It is a configuration and theming layer plus an automated provisioning playbook, applied on top of a standard Arch Linux install.
Can I download or install it?
Not at this stage. ArmoryOS is in private beta: this site and these docs are informational only. When the feed opens, it will be announced here.
Is it open source?
Yes — os.quantarmy.com is open source, built on open source. ArmoryOS applies layers of curation, personalization and system control over the projects it stands on, and honors their licenses.
Why Hyprland ≥ 0.56 specifically?
Hyprland moved its IPC and dispatch layer to Lua. ArmoryOS migrated its entire config surface — keybinds, scripts, bar modules — to the new model, and tracks the compositor the day it releases.