A minimal, productivity-focused Arch + Hyprland setup

 

This is my setup. It's opinionated — the tools I chose because I like them. You might too, or you might not. Either way, it works.

Includes prompt to set up for Nvidia GPUs.

Tested on Arch (Fresh install, not fully tested on systems that already have DE/WM).

Showcase

screenrecording-2026-05-17_04-13-17.mp4

---

Install

Caution

These install scripts are meant for a minimal, fresh install of Arch Linux

curl -fsSL https://raw.githubusercontent.com/caviarcbr/symphony/refs/heads/main/boot.sh | bash

boot.sh installs git and gum if needed, clones the repo, and runs the installer. Run it again anytime to update.

Manual install:

git clone https://github.com/caviarcbr/symphony ~/symphony
cd ~/symphony && ./install.sh

Existing configs are backed up to ~/.config/symphony/backups/ before overwriting.

---

Usage

symphony switch          # pick a theme
symphony switch [theme]  # switch directly
symphony switch -r       # random theme
symphony list            # show available themes
symphony reload          # reapply current theme
symphony restore         # roll back from backup
symphony fresh-setup     # reclone + reinstall
symphony help            # show all commands

Theme picker GUI: Super + Ctrl + Shift + Space

---

Keybindings

Tweak them in config/hypr/bindings.lua.

Apps

Key	Action
Super + Return	Terminal
Super + Space	App Launcher
Super + W	Browser
Super + E	Yazi
Super + M	RMPC
Super + B	Btop

Menus

Key	Action
Alt + ,	Clipboard
Alt + .	Emoji Picker
Super + Ctrl + Space	Matugen Theme
Super + Alt + Space	Wallpaper Picker
Super + Ctrl + Shift + Space	Theme Switcher

Windows

Key	Action
Super + Q	Close
Super + ALT + K	Kill
Super + H,J,K,L	Focus
Super + Shift + H,J,K,L	Move
Super + 1-9	Workspace
Super + Shift + 1-9	Send to Workspace
Super + F	Fullscreen
Super + V	Toggle Split

System

Key	Action
Super + Escape	Power Menu
Super + N	Notifications
Super + P	Screenshot
Super + CTRL + R	Record
Super + Shift + R	Record + Mic
Super + Shift + P	Color Picker
Ctrl + Alt + Space	Random Wallpaper
Super + Alt + ←/→	Cycle Wallpapers

---

Components

Component	Tool
Compositor	Hyprland
Bar	Waybar
Launcher	Rofi
Terminal	Kitty / Ghostty
Notifications	SwayNC
Lock screen	Hyprlock
Theme engine	Matugen
Music	MPD + RMPC
Visualizer	Cava
Editor	Neovim + NvChad
Shell	Fish or zsh + Starship

---

Troubleshooting

Install failed halfway? Re-run the failed script:

./install/packages.sh
./install/deploy.sh
./install/services.sh

Theme broken? symphony fix then symphony reload. Still broken? symphony switch sakura.

Waybar missing? Remove xdg-desktop-portal-gnome (keep xdg-desktop-portal-gtk), reboot.

SDDM black screen? Ctrl+Alt+F3, login, run ./install/post-setup.sh.

Want to start over? symphony fresh-setup — backs up, nukes, reclones, reinstalls. Type "fresh" to confirm.

Still stuck? Open an issue.

---

Credits

Learned (and borrowed) from:

• vyrx-dev/symphony
• HyDE-Project/HyDE
• JaKooLit/Hyprland-Dots
• basecamp/omarchy
• uiriansan/SilentSDDM
• bjarneo/aether.nvim

---