# Hyprland Setup & Configuration

A guide to setup Hyprland as your Arch Linux desktop with my dotfiles.

Before reading

This configuration is based on my dotfiles repository. You can use it with yadm:

sudo pacman -S yadm
yadm clone -b dotfiles git@github.com:pstron/dotfiles.git

If you don’t need to sync or keep up with the latest, you can also just git clone and manually copy the files.

CLI configuration

Install necessary CLI packages

sudo pacman -S bat btop chafa eza fastfetch fd fzf lsd ripgrep yazi tmux

Change to zsh

Change to zsh and load zinit, starship, etc automatically

chsh -s /bin/zsh
zsh

Neovim

Install Neovim:

sudo pacman -S neovim

then launch Neovim to automatically install and load plugins:

nvim

After loading, you will have a well-prepared neovim with NvChad.

Other

Tools like tmux, btop, yazi, etc. are also ready to use.

Desktop

Install Hyprland and other packages

sudo pacman -S hyprland hyprlock hyprpolkitagent hyprshot polkit uswm waybar wl-clipboard wofi mako ghostty alacritty xdg-desktop-portal-hyprland xdg-user-dirs

sudo pacman -S blueberry bluez bluez-utils brightnessctl pipewire pipewire-audio pipewire-alsa pipewire-pulse wireplumber alsa-utils alsa-firmware alsa-ucm-conf alsa-pugins pamixer pavucontrol pulseaudio-alsa

sudo pacman -S ark dolphin firefox gwenview mpv neovide timeshift papirus-icon-theme ttf-jetbrains-mono-nerd wqy-zenhei noto-fonts-cjk noto-fonts-emoji noto-fonts-extra

then enable some services:

sudo systemctl enable bluetooth
sudo systemctl --user enable waybar.service
sudo systemctl enable sddm

Press Meta + Enter to open an alacritty terminal. You can bat ~/.config/hypr/hyprland.conf and check the KEYBINDINGS section to learn how to use.

Install sddm theme

I would recommend Catppuccin Macchiato.

Install dependencies:

pacman -Syu qt6-svg qt6-declarative qt5-quickcontrols2

Download your chosen flavour + accent zip file from the latest GitHub release. Unzip the file and move the resulting directory to /usr/share/sddm/themes/.

Create and edit:

sudo vim /etc/sddm.conf.d/theme.conf

[Theme]
Current=catppuccin-macchiato-mauve

Install GRUB theme

Clone this repository locally and enter the cloned folder:

git clone https://github.com/catppuccin/grub.git && cd grub

Copy your selected theme from src folder to /usr/share/grub/themes/

Uncomment and edit following line in /etc/default/grub to your selected theme:

GRUB_THEME="/usr/share/grub/themes/catppuccin-[flavor]-grub-theme/theme.txt"

Update grub:

sudo grub-mkconfig -o /boot/grub/grub.cfg

Change Hyprland wallpaper

I use a hacky way to do this:

Prepare a loadwall.sh, replace /path/to/wall.png with yours, and then chmod +x loadwall.sh.

#!/bin/bash
sudo rm /usr/share/hypr/wall0.png
sudo rm /usr/share/hypr/wall1.png
sudo rm /usr/share/hypr/wall2.png

sudo cp /path/to/wall.png /usr/share/hypr/wall0.png
sudo cp /path/to/wall.png /usr/share/hypr/wall1.png
sudo cp /path/to/wall.png /usr/share/hypr/wall2.png

Now you can change Hyprland wallpaper by sudo ./loadwall.sh.

My wallpaper:

You can download it from my GitHub repository.

IME

Install packages needed:

sudo pacman -S paru # if you don't have an AUR helper
sudo pacman -S fcitx5-im fcitx5-rime
paru -S rime-ice-git

Install Catppuccin theme:

git clone https://github.com/catppuccin/fcitx5.git
mkdir -p ~/.local/share/fcitx5/themes/
cp -r ./fcitx5/src/* ~/.local/share/fcitx5/themes

1. Navigate to Fcitx5 Configuration application through your application launcher.
2. Select the Addons Tab.
3. Select the setting icon (gear-wheel) for Classical User Interface, located to the right.
4. Apply Catppuccin as the desired fcitx5 theme by navigating to Theme and later selecting Catppuccin Flavour Accent.

Reboot

After doing all the above steps, you can reboot and enjoy your Arch Linux with a fancy Hyprland!