🎨 HYPRARCH
A minimal, beautiful Hyprland rice for Arch Linux with Nord color scheme.
✨ Features
- 🪟 Hyprland - Dynamic tiling Wayland compositor with smooth animations
- 📊 Waybar - Minimal status bar with Nord styling
- 🚀 Rofi - Beautiful app launcher
- 🖥️ Kitty - GPU-accelerated terminal
- 🔔 Dunst - Clean notification daemon
- 🖼️ SWWW - Animated wallpaper daemon
- 🔒 Hyprlock - Stylish lock screen
- 🎨 Nord Theme - Cohesive color scheme throughout
📸 Screenshots
Coming soon
⚡ Quick Install
# Clone the repository
git clone https://git.cribdev.com/crib/hyprarch.git ~/hyprarch
# Run the install script
cd ~/hyprarch
chmod +x install.sh
./install.sh
# Log out and select Hyprland, or start from TTY:
Hyprland
That's it! The script handles everything automatically.
📦 What Gets Installed
Core
- Hyprland, Hyprpaper, Hyprpicker, Hypridle, Hyprlock
- Waybar, Rofi, Dunst, SWWW
- XDG Desktop Portal for Hyprland
Utilities
- Kitty (terminal)
- Thunar (file manager)
- PipeWire (audio)
- NetworkManager, Blueman (connectivity)
CLI Tools
- Neovim, Zsh, Starship prompt
- eza, bat, fzf, ripgrep, fd
Applications
- Firefox, MPV, Zathura (PDF)
⌨️ Keybindings
| Key | Action |
|---|---|
SUPER + Return |
Terminal (Kitty) |
SUPER + D |
App Launcher (Rofi) |
SUPER + Q |
Close Window |
SUPER + E |
File Manager |
SUPER + V |
Toggle Floating |
SUPER + F |
Fullscreen |
SUPER + L |
Lock Screen |
SUPER + M |
Exit Hyprland |
SUPER + 1-9 |
Switch Workspace |
SUPER + SHIFT + 1-9 |
Move to Workspace |
SUPER + SHIFT + S |
Screenshot (select) |
Print |
Screenshot to file |
📁 File Structure
hyprarch/
├── install.sh # Main install script
├── README.md # This file
├── .config/
│ ├── hypr/
│ │ ├── hyprland.conf # Main Hyprland config
│ │ └── hyprlock.conf # Lock screen config
│ ├── waybar/
│ │ ├── config # Waybar modules
│ │ └── style.css # Nord themed styling
│ ├── rofi/
│ │ ├── config.rasi # Rofi config
│ │ └── nord.rasi # Nord theme
│ ├── kitty/
│ │ └── kitty.conf # Terminal config
│ └── dunst/
│ └── dunstrc # Notification config
└── wallpapers/ # Wallpaper collection
🎨 Color Scheme (Nord)
| Color | Hex | Usage |
|---|---|---|
| Polar Night | #2e3440 |
Background |
| Snow Storm | #eceff4 |
Foreground |
| Frost | #88c0d0 |
Accent/Active |
| Aurora Red | #bf616a |
Critical/Error |
| Aurora Green | #a3be8c |
Success |
| Aurora Yellow | #ebcb8b |
Warning |
🔧 Customization
Change Wallpaper
swww img ~/Pictures/wallpapers/your-wallpaper.jpg --transition-type grow
Edit Configs
# Hyprland
nvim ~/.config/hypr/hyprland.conf
# Waybar
nvim ~/.config/waybar/config
nvim ~/.config/waybar/style.css
# Rofi
nvim ~/.config/rofi/nord.rasi
# Kitty
nvim ~/.config/kitty/kitty.conf
Change Theme Colors
Edit the color variables in:
~/.config/waybar/style.css~/.config/rofi/nord.rasi~/.config/kitty/kitty.conf~/.config/dunst/dunstrc
🔍 Troubleshooting
Hyprland won't start
# Check if running Wayland
echo $XDG_SESSION_TYPE
# Check Hyprland logs
cat /tmp/hypr/*/hyprland.log
Waybar not showing
# Restart waybar
killall waybar
waybar &
No sound
# Check PipeWire
systemctl --user status pipewire pipewire-pulse wireplumber
# Restart audio
systemctl --user restart pipewire pipewire-pulse wireplumber
Wallpaper not loading
# Check if swww daemon is running
pgrep swww
# Start daemon and set wallpaper
swww-daemon &
sleep 1
swww img ~/Pictures/wallpapers/default.jpg
Rofi not opening
# Test rofi
rofi -show drun
# Check if rofi-wayland is installed
pacman -Qs rofi
🔄 Updating
cd ~/hyprarch
git pull
./install.sh
Your custom configs will be backed up before updating.
🗑️ Uninstall
# Remove configs
rm -rf ~/.config/hypr
rm -rf ~/.config/waybar
rm -rf ~/.config/rofi
rm -rf ~/.config/kitty
rm -rf ~/.config/dunst
# Optionally remove packages (be careful!)
# sudo pacman -Rns hyprland waybar rofi kitty dunst swww
📚 Resources
🤝 Credits
- Hyprland by vaxerski
- Nord Theme by Arctic Ice Studio
- Nordic Wallpapers
📄 License
MIT License - Feel free to use and modify!
Made with 💙 for the Arch + Hyprland community