HyprInit provides a complete, ready-to-use configuration for a minimal and functional Arch Linux desktop using the Hyprland compositor. It automates the entire setup process—from installing packages to symlinking configurations with GNU Stow—allowing you to get up and running with a beautiful Hyprland workflow in minutes.

• Compositor: Hyprland - Dynamic tiling Wayland compositor with smooth animations
• Display Manager: SDDM - Modern Qt-based display manager
• Status Bar: Waybar - Highly customizable Wayland status bar
• Application Launcher: Rofi - Versatile application launcher with emoji support
• Terminal: Alacritty - Fast, GPU-accelerated terminal emulator
• File Manager: Dolphin - Powerful KDE file manager
• Browser: Brave - Privacy-focused Chromium-based browser
• Editors: Neovim + VS Code - Modern text editing
• Shell: Zsh with Zinit + Powerlevel10k
• Notifications: Mako - Lightweight Wayland notification daemon
• Screenshots: Grim + Slurp + Swappy
• Wallpapers: SWWW - Efficient animated wallpaper daemon
• Lock Screen: Hyprlock - Secure screen locker for Hyprland
• Audio: PipeWire - Modern multimedia framework
• Fonts: JetBrains Mono Nerd Font, Noto Fonts, Font Awesome
• Media: VLC for video playback
• Config Management: GNU Stow - Symlink farm manager for dotfiles

Coming soon...

Setting up your Hyprland environment is simple. The install.sh script handles everything automatically.

• A fresh Arch Linux installation (minimal profile recommended)
• git installed
• Active internet connection
• AMD GPU (script includes AMD-specific drivers)

# Install git if not present
sudo pacman -S git

# Clone the repository
git clone https://github.com/Hasib-4174/hyprinit.git
cd hyprinit

# Make scripts executable
chmod +x install.sh

# Run the installer
./install.sh

# Reboot when complete
sudo reboot

1. ✅ Installs AUR helper (yay) if not present
2. ✅ Installs all packages via pacman and AUR
3. ✅ Copies configs to ~/configfiles/
4. ✅ Symlinks configs using GNU Stow to ~/.config/
5. ✅ Enables services (NetworkManager, Bluetooth, SDDM, PipeWire)
6. ✅ Runs verification to confirm everything is set up

After reboot, SDDM will greet you. Select Hyprland from the session dropdown.

Keybindings are configured in ~/.config/hypr/keybinds.conf. The main modifier is ALT.

All configurations use GNU Stow for symlink management:

hyprinit/
├── install.sh              # Main installer
├── vars.conf               # User settings (edit before install)
├── README.md               # This file
│
├── packages/               # Package lists
│   ├── base.txt            # System essentials
│   ├── hypr.txt            # Hyprland stack
│   ├── apps.txt            # Desktop applications
│   └── dev.txt             # Development tools
│
├── config/                 # Stow-compatible configs
│   ├── hypr/               # → ~/.config/hypr/
│   │   └── .config/hypr/
│   │       ├── hyprland.conf
│   │       ├── keybinds.conf
│   │       ├── appearance.conf
│   │       └── ...
│   ├── waybar/             # → ~/.config/waybar/
│   ├── rofi/               # → ~/.config/rofi/
│   ├── alacritty/          # → ~/.config/alacritty/
│   ├── mako/               # → ~/.config/mako/
│   ├── swww/               # → ~/.config/swww/
│   ├── zsh/                # → ~/.zshrc
│   ├── sddm/               # → /etc/sddm.conf.d/
│   └── scripts/            # → ~/.local/bin/
│
└── scripts/                # Installation scripts
    ├── install_packages.sh
    ├── setup_configs.sh
    ├── enable_services.sh
    └── sanity_check.sh

Configs are stored in ~/configfiles/ and symlinked to their destinations.

# Your configs live here:
~/configfiles/
├── hypr/
├── waybar/
├── rofi/
└── ...

# Symlinked to:
~/.config/hypr → ~/configfiles/hypr/.config/hypr
~/.config/waybar → ~/configfiles/waybar/.config/waybar
# etc.

To edit configs: Modify files in ~/configfiles/ — changes apply immediately!

Edit vars.conf before running the installer:

# AUR helper (yay or paru)
AUR_HELPER=yay

# Default shell
DEFAULT_SHELL=zsh

# Service toggles
ENABLE_NETWORKMANAGER=true
ENABLE_BLUETOOTH=true
ENABLE_SDDM=true

# Requires post-install setup (browser auth)
ENABLE_TAILSCALE=false

sudo systemctl enable sddm.service
sudo systemctl start sddm.service

systemctl --user enable --now pipewire pipewire-pulse wireplumber

killall waybar
waybar &

cd ~/configfiles
stow --restow --target=$HOME hypr waybar rofi alacritty

yay -S package-name

Contributions are welcome! Feel free to:

• 🐛 Report bugs
• 💡 Suggest features
• 🔧 Submit pull requests

This project is open-source and available under the MIT License.