Rina's Hyprland Theme - Setup Guide

A custom Hyprland configuration themed with Catppuccin Mocha throughout, Waybar, Kitty, Dunst, Hyprlock, Tofi, and Wlogout all share the same palette.

This will be updated to time to time with new features and updates, we will provide a update.md whenever we do update to help migrate to the latest versions.

---

What's included

Area	Tool
Compositor	Hyprland
Status bar	Waybar (custom scripts + notification panel + VPN menu)
Terminal	Kitty
Launcher	Tofi
Notifications	Dunst + custom GTK history panel
Wallpapers	Hyprpaper + Waypaper GUI
Screen lock	Hyprlock + Hypridle (auto-lock)
Logout menu	Wlogout
Clipboard	cliphist
Screenshots	Grimblast
File manager	Dolphin
Image viewer	Gwenview
Video player	VLC
Text editor	KWrite
PDF viewer	Evince
Archive manager	Ark
Font manager	font-manager
Bluetooth	blueman
Theme	Catppuccin Mocha Mauve (GTK + Kvantum + Kitty + Hyprlock)
Font	JetBrainsMono Nerd Font

---

Guide sections

1. Prerequisites - what you need before anything else
2. Installation - every package you need to install
3. Theming - GTK, Qt, Kvantum, icons, and fonts
4. Configuration - deploying the config files
5. Waybar - status bar setup and the custom notification panel
6. Keybinds - full keybinding reference

---

Repo structure

.
├── configs/               ← all config files, copy to ~/.config/
│   ├── hypr/              ← Hyprland, Hyprlock, Hyprpaper, Hypridle + wallpapers
│   ├── waybar/            ← Waybar config, CSS, and custom scripts
│   │   └── scripts/       ← cpu, gpu, mullvad, notifications, bluetooth scripts
│   ├── kitty/             ← terminal config + Catppuccin theme
│   ├── dunst/             ← notification daemon config + sound script
│   ├── tofi/              ← launcher config
│   ├── wlogout/           ← logout menu layout + CSS
│   ├── waypaper/          ← wallpaper picker config
│   ├── Kvantum/           ← Catppuccin Kvantum theme pack (Qt styling)
│   ├── gtk-3.0/           ← GTK3 settings
│   ├── kdeglobals         ← KDE app settings (terminal, colour scheme)
│   └── mimeapps.list      ← default app associations (images, video, PDF, archives)
├── docs/                  ← this guide
    ├── README.md
    ├── prerequisites.md
    ├── installation.md
    ├── theming.md
    ├── configuration.md
    ├── waybar.md
    └── keybinds.md

Clone the repo:

git clone https://git.arcaneneko.com/Rinanyae/Rinas-Hyperland-Guide
cd Rinas-Hyperland-Guide

Then follow the Installation guide to install dependencies, followed by Configuration to copy the configs into place.

---

Notes

• Designed for Arch Linux (pacman + AUR helper). (Tested on CachyOS)
• Built for a dual-monitor setup (DP-1 primary, HDMI-A-1 secondary). Single-monitor users will need minor edits, see Configuration.
• GPU monitoring uses amdgpu_top, AMD GPU only. Nvidia users should disable the GPU widget in the Waybar config.
• VPN widget assumes Mullvad. If you don't use it, remove custom/vpn from waybar/config.jsonc.
• Some of the keybinds might not be great for everyone, you may want to change them in the hyperland config.

---

Next: Prerequisites →