Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Noro18/linux-ricing-dotfiles/llms.txt

Use this file to discover all available pages before exploring further.

These dotfiles are built for Arch Linux and assume you are already running a base Arch installation with a working internet connection. The setup uses a curated set of packages across Hyprland, Waybar, Rofi, and several theming tools — all available from the AUR or official repositories.

​
Required packages

The following tools are used across this setup and must be installed before you log into Hyprland for the first time.
PackageRole
hyprlandWayland compositor — the core window manager
waybarStatus bar
rofiApplication launcher and menu system
kittyTerminal emulator
swaynotificationcenterNotification center (swaync)
swwwWallpaper daemon with smooth transitions
matugenMaterial You color token generator
wallustTerminal and app color scheme generator
fastfetchSystem info display with custom ASCII logos
starshipShell prompt
nwg-displayGUI display/monitor configuration tool
hyprlockLock screen
hypridleIdle daemon that triggers the lock screen
hyprsunsetBlue light filter
btopSystem monitor
cavaAudio visualizer
yaziTerminal file manager
neovimText editor (used as nvim)
ttf-jetbrains-mono-nerdJetBrainsMono Nerd Font — required for icons in the bar and terminal
python-pywalPywal color scheme support

​
Installation

1

Install an AUR helper

If you do not already have yay or paru installed, install one now. yay is used in the commands below, but paru works as a drop-in replacement.
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si
If you prefer paru:
git clone https://aur.archlinux.org/paru.git
cd paru
makepkg -si
2

Install required packages

Install all dependencies in a single command. This covers every package listed in the table above.
yay -S hyprland waybar rofi kitty swaynotificationcenter swww matugen wallust \
  fastfetch starship nwg-display hyprlock hypridle hyprsunset btop cava yazi \
  neovim ttf-jetbrains-mono-nerd python-pywal
3

Clone the repository

Clone the dotfiles to a location of your choice. Your home directory works fine.
git clone https://github.com/Noro18/linux-ricing-dotfiles
4

Deploy the dotfiles

Copy the config files into your home directory and make the scripts executable.
cp -r dotfiles/.config/* ~/.config/
cp -r dotfiles/.local/bin/* ~/.local/bin/
chmod +x ~/.local/bin/*
This places all component configs under ~/.config/ and all utility scripts under ~/.local/bin/, which must be on your $PATH for the menus and theming pipeline to work.
5

Log in to Hyprland

Start Hyprland from a TTY or select it from your display manager. From a TTY the standard command is:
exec Hyprland
On first login, wallset-backend-startup runs automatically. It picks a random wallpaper from ~/.config/wallpapers/ and runs the full theming pipeline — generating color tokens with matugen and wallust, then applying them across Waybar, Rofi, Kitty, Hyprland, and swaync.
Files marked ⚠️ in the file structure guide are auto-generated and overwritten on every wallpaper change. Never edit them directly. Make your changes in the templates at ~/.config/matugen/templates/ or ~/.config/wallust/templates/ instead.
Place your wallpapers in ~/.config/wallpapers/. That directory is what the wallpaper selector scans when you open it — any image not in that folder will not appear in the menu.
If you use VS Code or Cursor, install the Wallust extension in both editors. It reads the active wallust color scheme and applies it to the editor UI, keeping your editor in sync with the rest of the desktop automatically.

Build docs developers (and LLMs) love

Get started for freeTalk to us