diff --git a/docs/installation_Hypr.md b/docs/installation_Hypr.md index 939d97e..c67df76 100644 --- a/docs/installation_Hypr.md +++ b/docs/installation_Hypr.md @@ -1,63 +1,73 @@ # Hyprland & Critical Softwares -Now that our base system is set up with all the prerequisites, it's time to start transforming your setup with Hyprland. In this section, we'll walk you through installing Hyprland and essential software to ensure a smooth and efficient workflow. +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 the Hyprland Package: +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. Start the Hyprland Session: + **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. Once you are in, you will see a bar on top with a warning and commands to launch Kitty and exit Hyprland. - To remove the warning: - * Launch Kitty using the shortcut `(SUPER + Q)` - * Edit the configuration file located at `~/.config/hypr/hyprland.conf` and comment out or remove the line saying `autogenerated = 1`. +3. **Upon initial launch:** A top bar will display with a warning and commands to launch Kitty and exit Hyprland. +To remove the warning: - Some default keybindings to keep handy: - * `SUPER + C`: Kill the active window - * `SUPER + M`: Quit hyprland (but why would you want to?) + * Launch Kitty using the shortcut **`(SUPER + Q)`** + * Navigate to `~/.config/hypr/hyprland.conf` and either comment out or remove the line `autogenerated = 1`. -* How to access the web(this tutorial), open kitty and launch Firefox with `firefox` + Essential default keybindings: + * **`SUPER + C`:** Kill the active window + * **`SUPER + M`:** Quit hyprland (but why would you want to?) -4. Add the necessary environment variables to your `hyprland.conf`. - * - * - * - -### Critical Softwares -1. Install XDG Desktop Portal - The XDG Desktop Portal handles various desktop functionalities, such as file pickers and screensharing. +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 is used for managing system-wide privileges. + +2. **Install Polkit:** Polkit manages system-wide privileges. Install the KDE version for compatibility: ``` pacman -S polkit-kde-agent ``` - * To autostart Polkit, add the following line to your hyprland.conf: + + * To autostart Polkit, append the following to your `hyprland.conf`: + ``` exec-once=/usr/lib/polkit-kde-authentication-agent-1 ``` - * make sure you don't give space between `=` and `/`. -3. QT Wayland Applications Support - Install the necessary libraries for QT applications to work properly under Wayland. + * 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. Install a Notification Daemon: - A notification daemon is essential for handling system notifications. If you're unsure which to use, dunst is a worthy choice. + +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 ``` -### Restart Hyprland -After installing the critical software and making the necessary configurations, restart your Hyprland session to apply the changes. This will ensure that all new settings and software are properly loaded. + + * 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.