 |
 |
|---|---|
 |
 |
 |
 |
 |
 |
- 🍀 Base — Arch
- 🌼 Wayland Compositor — Hyprland
- ✨ Bar — Waybar
- 💦 GUI File Manager — Thunar
- 🗄️ CLI File Manager — Yazi
- 🌷 Terminal — Foot
- 🍄 Shell — Zsh
- 🪵 Notifications — Mako
- 🌻 Launcher — Rofi (Lbonn Fork)
- 🚀 Dmenu Program — Rofi (Lbonn Fork)
- 🍁 Wallpaper — Swww
- 🌐 Browser — Zen Browser
- ❄️ Screen Locker — Hyprlock
- ⏬ Download Manager — Aria2
- 🤖 System Fetch — Nitch
Install all components listed above, then the following:
| Package | Purpose |
|---|---|
matugen |
Wallpaper-based color palette generation |
xdg-desktop-portal-hyprland |
Better Wayland compatibility |
cava |
Audio visualizer |
polkit-gnome |
Authentication agent |
grimblast-git + wl-clipboard |
Screenshot utility |
brightnessctl |
Monitor and keyboard brightness control |
mpv |
Media player |
pavucontrol |
Volume control panel |
xorg-xwayland |
Support for non-Wayland apps and games |
pipewire + pipewire-pulse + pipewire-alsa |
Audio playback |
wireplumber |
Session manager for Pipewire |
bleachbit |
Required for the cleaner script |
cmus |
Terminal audio player |
btop |
Resource monitor |
nmcli |
Network connection manager |
bluez-tools |
Bluetooth manager |
advcpmv (AUR) |
Improved cp and mv with progress |
eza |
Modern replacement for ls |
fd |
Fast alternative to find |
Fonts: JetBrains Mono Nerd Font, Awesome Fonts, Icomoon Feather, Nerd Font Symbols
Note
Colorscheme changes dynamically based on your wallpaper via Matugen. 😉
Caution
The installer backs up existing files before overwriting, but only for paths present in this repo. No unrelated configs are touched. I am not responsible for any lost configs — back up your own stuff first if you're unsure.
git clone https://github.com/Cybersnake223/Hypr
cd Hypr
chmod +x install.sh
./install.shThe installer will:
- ✅ Check for required dependencies (
cp,mkdir,find,date) - 🗂️ Back up any existing files it will overwrite into a timestamped folder
- 📁 Copy configs, scripts, icons, themes, fonts and root dotfiles into
$HOME - 🔒 Mark all scripts in
~/.local/bin/scriptsas executable - 🔤 Rebuild the font cache via
fc-cache -f - 🛤️ Optionally add
~/.local/binto your PATH in~/.zshrc
Note
Backups are saved to:
~/.local/share/hypr-dotfiles-backups/<timestamp>/
(or $XDG_DATA_HOME/hypr-dotfiles-backups/<timestamp>/ if $XDG_DATA_HOME is set)
| Flag | Description |
|---|---|
--dry-run |
Preview all actions without making any changes |
--yes |
Non-interactive, skip all prompts |
--no-backup |
Skip backup entirely (dangerous) |
--uninstall |
Remove installed files and restore originals from the latest backup |
Examples:
# Preview without changing anything
./install.sh --dry-run
# Non-interactive install
./install.sh --yes
# Install without backup
./install.sh --yes --no-backup
# Uninstall and restore previous configs
./install.sh --uninstallIf you prefer not to use the installer:
cp -r .config/* "$HOME/.config"
cp -r .local/bin/scripts "$HOME/.local/bin"
cp -r .icons "$HOME/.icons"
cp -r .themes "$HOME/.themes"
cp -r .fonts "$HOME/.fonts"
cp .Xresources "$HOME/.Xresources"
cp .gtkrc-2.0 "$HOME/.gtkrc-2.0"
fc-cache -fImportant
Make sure ~/.local/bin is in your PATH, otherwise the custom scripts
(wallpaper switching, media downloads, etc.) won't work as intended.
Add this to your ~/.zshrc:
export PATH="$HOME/.local/bin:$PATH"Note
.gtkrc-2.0 may be silently overwritten by nwg-look. Re-copy it from the
repo if your GTK 2 theming breaks after running it.
Note
This setup is primarily tuned for laptops. Desktop users may want to
review and adjust auto-cpufreq settings in .config/.
This project is licensed under the MIT License — see LICENSE for details.