A lean Arch Linux desktop: Hyprland (Lua) + original Quickshell widgets + conventional plumbing (systemd, pacman, NetworkManager, PipeWire, greetd, UWSM).
This repository is a kickstart, not a locked ISO. You install Arch. Then either you or an agent copies this tree and runs the installer. Versions float with Arch extra.
You do first: machine + Arch + user + network + SSH
This repo does: desktop packages, session, recoverable config
An agent can: continue from docs/AGENT.md after you hand off
Omarchy and DankMaterialShell are references only. Do not run their installers.
HyprArch itself has two install paths. VirtualBox is a Windows guest beside that desktop, not a third way to install HyprArch.
| Track | Who it is for | Status |
|---|---|---|
| Full install | Bare metal or a generic Linux VM | Expressed from the working desktop; monitor uses preferred |
| Parallels VM | Apple Silicon Mac + Parallels | This is the path that was actually built |
| VirtualBox + Windows | A Windows guest beside HyprArch | Not tested. Written so you can try it without pretending we did. |
Start with docs/USER.md. Agents start with AGENTS.md.
- greetd + tuigreet on VT1, Hyprland via UWSM
- Quickshell bar: workspaces, launcher, calendar, settings, power menu
- Thunar, Mousepad, Neovim, Foot, Chromium, nsxiv (via an imv-named wrapper)
- Papirus folders remapped to the color palette (Hyprarch icon overlay)
- Adwaita-dark, Inter, JetBrains Mono
- Optional later: niri or mango as extra F3 login sessions. Not in the installer; docs/OPTIONAL-SESSIONS.md is the guide. Hyprland stays daily.
git clone https://github.com/eimg/hyprarch.git
cd hyprarch
# metal:
bash scripts/install-desktop.sh --track metal
# Parallels on Apple Silicon:
bash scripts/install-desktop.sh --track parallelsUse a visible terminal for sudo. Then reboot and log in at the HyprArch greeter. Recovery: Ctrl+Alt+F2.
docs/USER.md first steps (human)
docs/AGENT.md full handover (agent)
docs/STACK.md locked choices and bans
docs/CURRENT.md desktop as it exists today
docs/OPTIONAL-SESSIONS.md niri / mango beside Hyprland (hints only)
docs/tracks/ metal / parallels / virtualbox-windows
config/ files that land in $HOME and /etc
scripts/ installer and user helpers
extras/parallels/ Retina monitor, Tools, greeter font
MIT. See LICENSE.