HYPRLAND

The ultimate Hyprland configuration (A Desktop Environment Like Experience)

Overview

Hyprland is a dynamic tiling Wayland compositor based on wlroots that doesn't sacrifice on its looks.

• Operating System : Archcraft
• Window Manager : Hyprland (0.29.0)
• Status Bar : Waybar
• Launcher : Rofi / Wofi
• Session Manager : Rofi / Wlogout
• Notifications : Mako
• Terminal : Foot
• File Manager : Thunar
• Text Editor : Geany
• Web Browser : Firefox

Installation

• Get the files from : Ko-fi ☕ ^{Why Paid}
• Extract The file hyprland.tar.gz with : tar -xzvf hyprland.tar.gz
• If you are using Archcraft (Required: 2023 or later) as your OS, You can just install one of the provided package with : sudo pacman -U archcraft-hyprland-4.0-2-any.pkg.tar.zst or sudo pacman -U archcraft-hyprland-catppuccin-4.0-2-any.pkg.tar.zst whichever style you like.
• If you want to install this setup on Arch Linux or on any other distro, follow the points below :
  • Install the following programs on your computer: hyprland, swaybg swayidle swaylock wlroots wl-clipboard waybar wofi foot mako grim slurp wf-recorder light yad thunar geany mpv mpd mpc viewnior imagemagick xfce-polkit xorg-xwayland xdg-desktop-portal-wlr playerctl pastel python-pywal alacritty rofi pulsemixer
  • After installing programs above, Create hypr directory in ~/.config : mkdir -p ~/.config/hypr
  • Copy Everything from dotfiles/STYLE to ~/.config/hypr : cp -r ./dotfiles/dark/* ~/.config/hypr/
  • Logout and login to your amazingly configured Hyprland WM.

Hyprland now available in Arch Linux Repos, So Arch Linux users can install it via pacman.

For other distro, If you don't want to build hyprland, You can install compiled hyprland binaries from hyprland releases

sudo install -Dm 755 dotfiles/hypr-bin/hyprctl /usr/bin/hyprctl
sudo install -Dm 755 dotfiles/hypr-bin/Hyprland /usr/bin/Hyprland
sudo install -Dm 755 dotfiles/hypr-bin/libwlroots.so.12032 /usr/lib/libwlroots.so.12032
sudo install -Dm 644 dotfiles/hypr-bin/hyprland.desktop /usr/share/wayland-sessions/hyprland.desktop

Appearance

Install the following theme, icon pack, cursors and fonts for overall appearance.

• GTK Theme : Manhattan gtk theme
• Icon Theme : Luv icon theme
• Cursor Theme : Qogir cursor theme
• Fonts : JetBrainsMono Nerd Font, Iosevka Nerd Font, Icomoon Feather, Archcraft

Config Structure

~/.config
└── hypr               : Hyprland config directory
    ├── alacritty     : Alacritty Terminal config
    ├── foot          : Foot Terminal config
    ├── mako           : Notification daemon config
    │   └── icons      : Notification icons
    ├── rofi           : Rofi config files
    ├── scripts        : Various scripts for functionality
    ├── theme         : Current Theme and Pywal Themes
    ├── wallpapers     : Wallpapers
    ├── waybar         : Statusbar config
    ├── wlogout        : Wlogout config
    │   └── icons      : Session icons
    ├── wofi           : Launcher config
    ├── hyprland.conf  : Hyprland config file
    └── hyprtheme.conf : Colors and theme elements file

By default, rofi is used as app launcher.

But, If you want to use wofi instead of rofi, Edit the config file ~/.config/hypr/hyprland.conf and uncomment wofi keybindings (and, comment the rofi stuff as well).

By default, MPD is used on waybar for music.

But, If you want to use Spotify instead of MPD, Edit the config file ~/.config/hypr/waybar/config and uncomment the spotify module (and, comment the MPD module as well).

Nvidia

If you're on Archcraft and install the provided package, There's nothing else you need to do in order to run it on Nvidia machine. The package's post_installation script does it all, And the compositor should work fine.

If you're running any other distribution and want to install this setup on your Nvidia machine, You need to do some tweaking. In this guide, I'm assuing you're using Arch Linux. Follow the steps below to make this wayland compositor work on Nvidia :

• Install Nvidia Drivers on your system. NVIDIA
• Edit /etc/mkinitcpio.conf file and add nvidia kernel modules

MODULES="nvidia nvidia_modeset nvidia_uvm nvidia_drm"

• In the same file, Remove kms hook from hooks array if present.
• Rebuild your initrd file with : sudo mkinitcpio -P linux
• Edit /etc/default/grub file and add nvidia_drm.modeset=1 kernel parameter for Nvidia

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash nvidia_drm.modeset=1 ..."

• Update your grub config file with : sudo grub-mkconfig -o /boot/grub/grub.cfg
• Reboot your Nvidia Machine and login to your wayland compositor, It should work now.

More Information: NVIDIA#Installation, NVIDIA#DRM_kernel_mode_setting

Keybindings

Screenshots

Dark Version

Screenshot 1	Screenshot 2	Screenshot 3	Screenshot 4

Catppuccin Version

Screenshot 1	Screenshot 2	Screenshot 3	Screenshot 4

See Also

archcraft-sway	archcraft-wayfire	archcraft-river	archcraft-newm