hyprland-dot-files

My personal Hyprland dotfiles. Primarily for my own use — shared publicly as a reference.

---

Overview

Hyprland is a dynamic tiling Wayland compositor. This repo holds the full set of configs I run with it, including the compositor itself, status bar, notifications, terminals, editor, shell, and system-level stuff.

---

Structure

.config/
  alacritty/           — Alacritty terminal config
  btop/                — btop resource monitor config
  cava/                — Cava audio visualiser config
  cliamp/themes/       — CLI audio player themes
  dconf/               — dconf/GSettings dumps
  fastfetch/           — Fastfetch system info config
  fish/                — Fish shell config and functions
  fontconfig/          — Font rendering config
  foot/                — Foot terminal config
  ghostty/             — Ghostty terminal config
  gtk-3.0/             — GTK3 theme settings
  gtk-4.0/             — GTK4 theme settings
  hypr/                — Core Hyprland config (hyprland.conf, hyprpaper, hypridle, hyprlock)
  ironbar/             — Ironbar status bar config
  kitty/               — Kitty terminal config
  lazygit/             — Lazygit config
  mako/                — Mako notification daemon config
  nvim/                — Neovim config
  nwg-dock-hyprland/   — nwg-dock panel config
  omarchy/             — Omarchy theme/framework config
  spicetify/           — Spicetify Spotify theme overrides
  swayosd/             — SwayOSD on-screen display config
  systemd/user/        — Systemd user services
  tmux/                — tmux config
  uwsm/                — UWSM session manager config
  walker/              — Walker app launcher config
  waybar/              — Waybar status bar config
  wayvibes/            — Wayvibes keyboard sound config
  QtProject.conf       — Qt platform theme settings
  starship.toml        — Starship shell prompt config
  user-dirs.dirs       — XDG user directory definitions
etc/                   — System-level config files (fonts, udev, etc.)
home/                  — Additional home directory dotfiles
local_share/           — ~/.local/share overrides (themes, icons, etc.)
oh-my-zsh-themes/      — Custom oh-my-zsh themes
.zshrc                 — Zsh config

---

Stack

Role	Program
Compositor	Hyprland
Status bar	Waybar / Ironbar
Terminal	Ghostty / Kitty / Foot / Alacritty
Shell	Fish / Zsh (Starship prompt)
Editor	Neovim
Notifications	Mako
App launcher	Walker
Dock	nwg-dock-hyprland
System info	Fastfetch
Multiplexer	tmux
Music client	Spotify + Spicetify
Audio visualiser	Cava
Keyboard sounds	Wayvibes
OSD	SwayOSD
Wallpaper	Hyprpaper
Lock screen	Hyprlock
Idle daemon	Hypridle
Session manager	UWSM

---

Installation

This is not a standalone installer. These configs are tuned to my specific setup and will likely need adjustments for yours.

git clone https://github.com/fiveclankers/Hyprland-Dot-Files.git

# Back up your existing configs
cp -r ~/.config ~/.config.bak

# Copy selectively — don't wholesale overwrite
cp -r Hyprland-Dot-Files/.config/hypr ~/.config/hypr
cp -r Hyprland-Dot-Files/.config/waybar ~/.config/waybar
# ... and so on for what you actually want

The etc/ directory contains system-level files. Copy those manually to their respective paths under /etc/ and make sure you know what each one does before applying.

---

Notes

• Main Hyprland config is at .config/hypr/hyprland.conf — keybinds, monitor setup, window rules, animations.
• Hyprpaper, Hypridle, and Hyprlock each have their own config files in .config/hypr/.
• starship.toml controls the shell prompt; works with both Fish and Zsh.
• Neovim config is in .config/nvim/ — uses a plugin manager, you'll need to run the install step on first launch.
• local_share/ mirrors ~/.local/share/ — contains icon/theme data; copy to the appropriate path.
• Waybar and Ironbar configs are independent — use whichever you prefer, not both.

---

Gallery

No screenshots yet.

---

Take what's useful.