A comprehensive, aesthetic, and functional Hyprland configuration featuring a Gruvbox Material theme. These dotfiles are designed to be plug-and-play while offering high customization.

• Window Management: Dwindle layout with custom animations and window rules.
• Status Bar: Custom waybar configuration with interactive modules.
• Notifications: swaync for beautiful and functional notifications.
• App Launcher: rofi with a matching Gruvbox theme.
• Lock Screen: Fully configured hyprlock, just set up your profile picture and you're good to go.
• Idle Management: hypridle - just works, so it's cool
• Terminal: kitty + zsh configuration (you can change it to anything else, but this is preconfigured already).
• File Manager: yazi (terminal-based) and nautilus (GUI).
• Image Viewer: imv for a lightweight and scriptable experience.
• PDF Viewer: zathura with a minimalist interface and Vim-like controls.
• System Monitor: btop with gruvbox theme
• Custom Scripts: Includes gamemode script for performance optimization.
• Window Tools: Integrated support for niflveil - you can minimize and restore windows with a shortcut.
• Themes & Settings: nwg-look for GTK theme management, nwg-displays for output configuration. Includes Gruvbox-GTK-Theme.

An installation script is provided to automate the setup process. It supports Arch Linux-based distros the best (including derivatives like Manjaro, EndeavourOS, CachyOS), with experimental support for Fedora and limited support for Debian/Ubuntu.

1. Run the one-line installer:

   bash <(curl -s https://raw.githubusercontent.com/terminal-index/hyprland-dotfiles/refs/heads/main/install.sh)

   This will clone the repository to ~/hyprland-dotfiles and start the installation script.

If you prefer to clone manually:

git clone https://github.com/terminal-index/hyprland-dotfiles.git
cd hyprland-dots
chmod +x install.sh
./install.sh

The script will:

• Autodetect your distro
• Install required dependencies (official & AUR/external).
• Prompt you to select an AUR helper (yay or paru) if not found (Arch only).
• Automatically compile and install niflveil (Arch only).
• Backup your existing configurations.
• Symlink the new dotfiles to ~/.config.

If you prefer to install dependencies manually, here is the list of required software:

Core:

• hyprland
• hyprlock, hypridle, hyprpaper
• xdg-desktop-portal-hyprland
• polkit-kde-agent (or hyprpolkitagent)

UI & Utilities:

• waybar, swaync
• rofi
• kitty
• nautilus (or your preferred file manager)
• imv (image viewer)
• zathura (pdf viewer)
• wl-clipboard, cliphist
• grim, slurp (screenshots)
• btop, yazi
• brightnessctl, playerctl
• wireplumber
• wlogout (logout menu)
• waypaper (wallpaper utility)
• hyprpaper (wallpaper daemon)
• nwg-look, nwg-displays (Appearance & Display settings)
• wl-paste (clipboard manager)

Used GTK Theme:

• Gruvbox-GTK-Theme: GitHub Repository.

Used fonts:

• ttf-jetbrains-mono-nerd

External Tools:

• NiflVeil: GitHub Repository (Requires rust, cargo (both for compiling) and eww)
• xwaylandvideobridge: For screen sharing possibility.

This configuration relies on nwg-displays to generate the monitor configuration.

1. Run nwg-displays (from terminal or launcher).
2. Configure your monitors (resolution, position, scale).
3. Click "Apply" to save the configuration to ~/.config/hypr/monitors.conf.

Windows/Cmd key (SUPER) is the main key (as always!)

• .config/hypr/: Main Hyprland configuration
• .config/waybar/: Status bar style and config
• .config/rofi/: App launcher theme
• .config/swaync/: Notification center config
• .config/kitty/: Terminal setup
• .config/btop/: System monitor theme

If you encounter any problems, please open an issue on the GitHub repository.

• Theme Inspiration: Gruvbox
• Alexays for his work on Waybar: GitHub Repository
• Hyprland: The Hyprland Community
• Mauitron for his great work on NiflVeil: GitHub Repository
• Fausto-Korpsvart for his work on Gruvbox GTK Theme: GitHub Repository
• JetBrains' Mono Font: Website