Dotfiles — Hyprland on Arch

Personal Hyprland configuration for Arch Linux

Screenshots

Neofetch

Neovim

Spotify

---

Stack

Category	Tool
Compositor	Hyprland 0.54
Bar	Waybar
Launcher	Wofi
Notifications	SwayNC
Terminal	Kitty
Shell	Zsh + Oh My Zsh + Starship
Shell history	Atuin
File manager	Nemo
Editor	VSCodium
Browser	Zen Browser
Wallpaper	awww
Music	MPD + Spotify
Bluetooth	Blueman
Logout	Wlogout
Boot splash	Plymouth — proxzima theme
Bootloader	GRUB — boo theme
Login manager	GDM

---

Keybindings

Applications

Keybind	Action
SUPER + RETURN	Terminal (Kitty)
SUPER + W	Browser (Zen)
SUPER + SHIFT + W	Browser alt (Brave)
SUPER + E	Editor (VSCodium)
SUPER + F	File manager (Nemo)
SUPER + M	Spotify
SUPER + D	Discord
SUPER + G	Gmail (Geary)
SUPER + O	OnlyOffice
SUPER + SHIFT + O	Obsidian
SUPER + B	Bluetooth (Blueman)
SUPER + T	Floating terminal
SUPER + ALT + RETURN	Fullscreen terminal

Window management

Keybind	Action
SUPER + Q	Close window
SUPER + H/J/K/L	Move focus
SUPER + ←/↑/↓/→	Move focus (arrows)
SUPER + SHIFT + H/J/K/L	Move window
SUPER + CTRL + H/J/K/L	Resize window
SUPER + S	Toggle floating
SUPER + P	Toggle pseudo-tile
SUPER + A	Toggle split
SUPER + ALT + M	Fullscreen
SUPER + ALT + C	Center window
SUPER + SHIFT + G	Toggle group
SUPER + CTRL + TAB	Cycle group

Workspaces

Keybind	Action
SUPER + TAB	Next workspace
SUPER + SHIFT + TAB	Previous workspace
SUPER + 1-9	Go to workspace
SUPER + SHIFT + 1-9	Move window to workspace
SUPER + Mouse wheel	Cycle workspaces
SUPER + Mouse drag	Move/resize window

Visual toggles

Keybind	Action
SUPER + Z	Toggle animations
SUPER + ALT + Z	Toggle clean mode (removes all transparency and blur)

Wallpaper

Keybind	Action
SUPER + ]	Next wallpaper
SUPER + [	Previous wallpaper

Wallpapers are read from ~/Pictures/Wallpapers/. The last used wallpaper is remembered across reboots.

Utilities

Keybind	Action
SUPER + SPACE	App launcher
SUPER + SUPER_L	App launcher (drun)
SUPER + V	Clipboard history
SUPER + N	Notification center
SUPER + SHIFT + S	Screenshot (region)
Print	Screenshot (full)
SUPER + SHIFT + C	Color picker
SUPER + .	Emoji picker
SUPER + ESC	Logout screen
SUPER + ALT + L	Lock screen
SUPER + SHIFT + R	Reload Waybar
ALT + TAB	Cycle windows

Media & brightness

Keybind	Action
XF86AudioRaiseVolume	Volume up
XF86AudioLowerVolume	Volume down
XF86AudioMute	Mute
XF86MonBrightnessUp/Down	Brightness
SUPER + SHIFT + P	Play/pause
SUPER + SHIFT + ]	Next track
SUPER + SHIFT + [	Previous track

---

Installation

Base dependencies

sudo pacman -Syy \
  base-devel mtpfs \
  gvfs gvfs-mtp gvfs-gphoto2 \
  gnome-keyring \
  jq unzip unrar \
  bluez bluez-utils \
  zsh neovim git

Hyprland and core tools

yay -S \
  hyprland xdg-desktop-portal-hyprland wayland-protocols \
  waybar wlogout wofi \
  awww swaync grim slurp \
  qt5-base qt5-wayland qt6-base qt6-wayland qt5ct qt6ct polkit-gnome \
  pipewire pipewire-alsa pipewire-pulse pipewire-jack wireplumber \
  brightnessctl playerctl pavucontrol-gtk3 mpd mpd-mpris \
  blueman network-manager-applet libinput-gestures \
  cava kitty starship tty-clock-git btop geany bat cliphist \
  reflector \
  --needed

Shell

# Oh My Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# Plugins
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-completions ${ZSH_CUSTOM:=~/.oh-my-zsh/custom}/plugins/zsh-completions

# Atuin (shell history)
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

Fonts

sudo pacman -S \
  noto-fonts noto-fonts-cjk noto-fonts-emoji \
  ttf-cascadia-code ttf-cascadia-code-nerd \
  ttf-jetbrains-mono ttf-jetbrains-mono-nerd \
  ttf-font-awesome ttf-nerd-fonts-symbols-mono

fc-cache -fv

GTK Theme — Tokyonight

cd ~/Downloads
git clone https://github.com/Fausto-Korpsvart/Tokyonight-GTK-Theme.git
cd Tokyonight-GTK-Theme/

# GTK 3
cp -r themes/Tokyonight-Dark-BL-LB ~/.themes
# GTK 4
cp -r themes/Tokyonight-Dark-BL-LB ~/.config/gtk-4.0
# Icons
sudo cp -r icons/Tokyonight-Moon /usr/share/icons/

Cursor — Layan

# Available in AUR
yay -S layan-cursor-theme-git

---

Boot & login

Thanks to PROxZIMA for the GRUB and Plymouth themes.

yay -S boo-grub-git proxzima-plymouth-git

GRUB

Edit /etc/default/grub:

GRUB_THEME="/usr/share/grub/themes/boo/theme.txt"
GRUB_CMDLINE_LINUX_DEFAULT="loglevel=3 quiet splash"

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

Plymouth

Add plymouth to the HOOKS in /etc/mkinitcpio.conf, after udev:

HOOKS=(base udev plymouth autodetect ...)

Set the theme and rebuild initramfs:

sudo plymouth-set-default-theme -R proxzima
sudo mkinitcpio -P

GDM cursor fix

To prevent a ghost cursor from the login screen appearing over Hyprland:

sudo mkdir -p /etc/dconf/db/gdm.d/
sudo tee /etc/dconf/db/gdm.d/01-cursor << 'EOF'
[org/gnome/desktop/interface]
cursor-theme='Layan-cursors'
cursor-size=24
EOF
sudo dconf update

---

Structure

dotfiles/
├── hypr/           → Hyprland config
│   └── .config/hypr/
│       ├── hyprland.conf
│       └── configs/
│           ├── autostart       → startup script
│           ├── decorations.conf
│           ├── animations.conf
│           ├── keybindings.conf
│           ├── rules.conf
│           ├── env.conf
│           ├── monitor.conf
│           └── override.conf   → runtime toggles (clean mode, etc.)
├── dotscripts/     → shell scripts (~/.scripts/ and ~/.config/scripts/)
├── waybar/         → Waybar config and styles
├── wofi/           → Wofi launcher styles
├── kitty/          → Kitty terminal config
├── zsh/            → Zsh config and aliases
├── swaync/         → Notification center config
├── wlogout/        → Logout screen
├── nvim/           → Neovim config
├── starship/       → Starship prompt
└── gtk/            → GTK settings