H
HyprL

Installation

HyprL offers multiple installation methods to suit different user preferences and experience levels. Choose the method that best fits your needs.

System Requirements

Before installing HyprL, ensure your system meets these requirements:

Hardware Requirements

  • GPU: Modern GPU with Vulkan support (NVIDIA, AMD, or Intel)
  • RAM: Minimum 4GB, recommended 8GB+
  • Storage: At least 10GB free space
  • CPU: Any modern x86_64 processor

Software Requirements

  • Operating System: Arch Linux or Arch-based distribution
  • Display Server: Wayland (will be configured automatically)
  • Bootloader: systemd-boot or GRUB

Installation Methods

🚀 Interactive Installation (Recommended for Beginners)

The interactive installer guides you through every step with explanations and automatic hardware detection.

curl -sL https://raw.githubusercontent.com/Manpreet113/hyprL/master/tools/interactive-installer.sh | bash

Features:

  • Hardware detection and optimization
  • Theme selection with previews
  • Automatic backup creation
  • Step-by-step guidance
  • Error recovery

⚡ Express Installation (For Experienced Users)

Quick one-command installation with sensible defaults:

curl -sL https://raw.githubusercontent.com/Manpreet113/hyprL/master/main/install.sh | bash

🔧 Manual Installation (For Advanced Users)

  1. Clone the repository:

    git clone https://github.com/yourusername/hyprL.git
cd hyprL

  2. Make the installer executable:

    chmod +x install.sh

  3. Run the installer:

    ./install.sh

Installation Process

Step 1: System Preparation

The installer will:

  • Update system packages
  • Install required dependencies
  • Create necessary directories
  • Backup existing configurations

Step 2: Core Installation

  • Install Hyprland and related packages
  • Configure Wayland session
  • Set up PipeWire audio system
  • Install fonts and themes

Step 3: HyprL Configuration

  • Deploy HyprL configuration files
  • Set up keybindings and shortcuts
  • Configure Waybar status bar
  • Install wallpapers and themes

Step 4: Post-Installation Setup

  • Enable essential services
  • Configure user directories
  • Set up first-boot tutorial
  • Verify installation integrity

Included Packages

Core Components

  • Hyprland: The tiling window manager
  • Waybar: Status bar and system information
  • Rofi: Application launcher and menu system
  • Dunst: Notification daemon
  • Hyprpaper: Wallpaper manager

Audio & Media

  • PipeWire: Modern audio system
  • WirePlumber: Session manager
  • Pavucontrol: Audio control GUI
  • Playerctl: Media player control

Utilities

  • Kitty: Terminal emulator
  • Nautilus: File manager
  • Firefox: Web browser
  • VS Code: Code editor (optional)

Fonts & Themes

  • JetBrains Mono Nerd Font: Programming font
  • Inter: UI font
  • Papirus: Icon theme
  • Catppuccin: Color scheme

Troubleshooting Installation

Common Issues

NVIDIA Graphics Card:

# Install NVIDIA drivers before installation
sudo pacman -S nvidia nvidia-utils

Missing Dependencies:

# Update package database
sudo pacman -Syu

Permission Errors:

# Ensure user is in required groups
sudo usermod -aG video,audio,input $USER

Verification Steps

After installation, verify everything works:

# Run the test script
./test-installation.sh

# Check Hyprland version
hyprland --version

# Verify audio system
pactl info

Post-Installation

First Boot

  1. Log out of your current session
  2. At the login screen, select “Hyprland” session
  3. Log in with your credentials
  4. The first-time tutorial will start automatically

Next Steps

Uninstallation

If you need to remove HyprL:

# Run the uninstaller (if available)
./uninstall.sh

# Or manually remove configurations
rm -rf ~/.config/hypr
rm -rf ~/.config/waybar
rm -rf ~/.config/rofi

Need Help? Visit our Support page or join our Discord community for assistance.