simple-hyprland/docs/installation_Hypr.md

Hyprland & Critical Softwares

With the prerequisite base system established, we proceed to the core of this guide. This section delineates the process of installing Hyprland and configuring critical system software to ensure a robust and efficient workflow.

Hyprland Installation

1. Install Hyprland:

   pacman -S hyprland
   

   Pro Tip: If you're feeling adventurous, you can always grab the bleeding-edge version from the AUR for the latest features and fixes.

2. Initiate Hyprland: As we installed SDDM before, you can also start the session through it.

   Hyprland
   

3. Upon initial launch: A top bar will display with a warning and commands to launch Kitty and exit Hyprland. To remove the warning:

   • Launch Kitty using the shortcut (SUPER + Q)
   • Navigate to ~/.config/hypr/hyprland.conf and either comment out or remove the line autogenerated = 1.

   Essential default keybindings:

   • SUPER + C: Kill the active window
   • SUPER + M: Quit hyprland (but why would you want to?)

To access web resources, open Kitty and execute brave-browser to launch the Brave browser.

Critical System Components

1. XDG Desktop Portal: The XDG Desktop Portal is crucial for handling desktop functionalities such as file dialogs and screensharing.

   pacman -S xdg-desktop-portal-hyprland
   

2. Install Polkit: Polkit manages system-wide privileges. Install the KDE version for compatibility:

   pacman -S polkit-kde-agent
   

   • To autostart Polkit, append the following to your hyprland.conf:

     exec-once=/usr/lib/polkit-kde-authentication-agent-1
     

   • Note: Ensure there's no whitespace between = and /.

3. QT Wayland Support: Install the necessary libraries for QT applications to function correctly under Wayland:

   pacman -S qt5-wayland qt6-wayland
   

4. Notification Daemon: A notification daemon is essential for managing system notifications. Many apps may freeze without one running. Dunst is a lightweight, customizable option:

   pacman -S dunst
   

   • To autostart dunst, append the following to your hyprland.conf:

     exec-once=/usr/bin/dunst
     

Hyprland Session Reload

After installing the critical software components and making the necessary configurations, restart your Hyprland session to ensure all new settings and software are properly initialized and integrated.

Next: Basic Configuration