H
HyprL

Welcome to HyprL

HyprL is a complete Hyprland desktop environment designed to be beautiful, functional, and accessible to users of all skill levels. Whether you’re new to Linux or a seasoned Arch user, HyprL provides a polished, ready-to-use Wayland desktop experience.

What is HyprL?

HyprL takes the power of Hyprland and makes it approachable for everyone by providing:

  • 🚀 One-command installation - Get up and running in minutes
  • 🎓 Beginner-friendly guides - Comprehensive documentation and interactive tutorials
  • 🎨 Multiple themes - Choose from various beautiful presets
  • ⚡ Hardware optimization - Automatic performance tuning
  • 🔧 Easy customization - Interactive configuration tools
  • 📱 Modern workflow - Tiling window management with smooth animations

Key Features

Complete Desktop Environment

  • Hyprland - Modern Wayland compositor with tiling window management
  • Waybar - Customizable status bar with multiple themes
  • Rofi - Application launcher and window switcher
  • Super + Q - Open terminal
  • Dunst & SwayNC - Beautiful notification system
  • Hyprlock - Secure lock screen with custom styling

Beginner-Friendly Experience

  • Interactive installer with step-by-step guidance
  • Hardware detection and automatic optimization
  • Theme recommendations based on your system
  • Interactive tutorial for first-time users
  • Comprehensive documentation with examples

Advanced Features

  • Multiple configuration presets for different use cases
  • Performance optimization tools for various hardware
  • Testing and validation suite to ensure everything works
  • Backup and restore system for safe configuration management

Who is HyprL For?

Complete Beginners

If you’re new to Linux or tiling window managers, HyprL provides:

  • Step-by-step installation guidance
  • Interactive tutorials to learn the basics
  • Comprehensive glossary of terms
  • Troubleshooting guides for common issues

Experienced Users

If you’re familiar with Linux but new to Hyprland:

  • Express installation options
  • Advanced configuration tools
  • Performance optimization utilities
  • Extensible scripting system

Power Users

If you’re already using Hyprland:

  • Modular configuration system
  • Multiple theme and layout options
  • Advanced customization capabilities
  • Community contribution opportunities

Quick Start

Ready to get started? Here are your options:

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

This guided installer will:

  • Explain each step of the process
  • Detect your hardware automatically
  • Recommend themes based on your system
  • Create backups of existing configurations

Express Installation (For Experienced Users)

bash <(curl -sL https://raw.githubusercontent.com/Manpreet113/hyprL/master/main/setup.sh)

This automated installer will:

  • Install all required packages
  • Configure the complete desktop environment
  • Apply optimizations for your hardware
  • Set up all tools and utilities

What’s Next?

After installation, we recommend:

  1. Complete the tutorial - Learn the basics of using HyprL
  2. Learn Basic Commands - Get familiar with essential Arch Linux and Hyprland commands.
  3. Understand Your Configuration - Dive into how HyprL is set up and how to customize it.
  4. Troubleshoot Common Issues - Find solutions to frequently encountered problems.
  5. Explore configuration options - Customize your desktop
  6. Join the community - Get help and share your setup

New to Hyprland? Check out our beginner’s guide to understand what makes tiling window managers special. Confused by terms? Check our Glossary for definitions.

System Requirements

Minimum Requirements

  • OS: Arch Linux (or Arch-based distribution)
  • RAM: 4GB (8GB+ recommended)
  • GPU: Any graphics card with Vulkan support
  • Storage: 5GB free space
  • Network: Internet connection for installation

Supported Hardware

  • NVIDIA GPUs: Full support with driver optimizations
  • AMD GPUs: Native support with Mesa drivers
  • Intel Graphics: Integrated graphics support
  • Virtual Machines: Optimized settings for VMs

Getting Help

If you need assistance:

  • 📚 Browse this documentation for comprehensive guides
  • 💬 Join our Discord for real-time community support
  • 🐛 Report issues on GitHub for bugs or feature requests
  • 🧪 Run diagnostics with hyprL-test to check your installation

Welcome to the HyprL community! We’re excited to help you create the perfect desktop experience.