__ __ _ _ _ _
| \/ |_ _ | | | |_ _ _ __ _ __| | __ _ _ __ __| |
| |\/| | | | | _____ | |_| | | | | '_ \| '__| |/ _` | '_ \ / _` |
| | | | |_| | |_____| | _ | |_| | |_) | | | | (_| | | | | (_| |
|_| |_|\__, | |_| |_|\__, | .__/|_| |_|\__,_|_| |_|\__,_|
|___/ |___/|_|
My Hyprland desktop configuration recently updated to take advantage of Hyprland 0.55's Lua configuration.
This started out as my minimal extra configuration for the wonderful Omarchy, but when I moved to NixOs, I had to expand a bit.
- Lua-based modular config — each concern (keybinds, monitors, look & feel, windows, workspaces) lives in its own file under
.config/hypr/modules/ - 5 complete themes — Lovely Day, Catppuccin Mocha, Matte Black, Osaka Jade, Everforest — each with matched colors for Waybar, Rofi, VSCode, Neovim, and more
- Searchable keybinds — press
SUPER + Kto fuzzy-search every keybind in Rofi - Dual-monitor workspace layout — workspaces 1–5 on the right monitor, 9–10 on the left
- Touchpad gestures — 3-finger swipe to scroll windows or switch workspaces, 4-finger pinch to fullscreen
- Night light — automatic warm color temperature at sunset via
hyprsunset(toggle withSUPER + SHIFT + N) - Interactive wallpaper picker — browse and set wallpapers with thumbnail previews via Rofi (
SUPER + SHIFT + W); supports recursive directory selection - System control menu — lock, suspend, logout, reboot, or shutdown from a Rofi icon grid (
SUPER + SHIFT + S) - OSD feedback — volume, microphone, and brightness overlays via
swayosd - Auto-idle + lock — brightness dims at 5 min, screen locks at 10 min, display off at 15 min
- Clipboard history — persistent clipboard via
cliphist+wl-paste
| Theme | Preview |
|---|---|
| Lovely Day | .local/share/my/themes/lovely-day/backgrounds/ |
| Catppuccin Mocha | .local/share/my/themes/catppuccin-mocha/backgrounds/ |
| Matte Black | .local/share/my/themes/matte-black/backgrounds/ |
| Osaka Jade | .local/share/my/themes/osaka-jade/backgrounds/ |
| Everforest | .local/share/my/themes/everforest/backgrounds/ |
| Package | Purpose |
|---|---|
hyprland |
Wayland compositor |
hyprlock |
Lock screen |
hypridle |
Idle daemon |
hyprsunset |
Night light |
waybar |
Status bar |
rofi |
App launcher + keybind search |
swaync |
Notification daemon |
swayosd |
Volume / brightness OSD |
ghostty |
Terminal emulator |
brave |
Browser |
nautilus |
File manager |
obsidian |
Notes |
playerctl |
Media key control |
jq |
JSON parsing (used by keybind scripts) |
swww |
Wallpaper daemon |
cliphist |
Clipboard history |
wl-clipboard |
Wayland clipboard (wl-paste) |
imagemagick |
Image processing (wallpaper + screenshots) |
hyprpolkitagent |
Authentication agent |
gnome-keyring |
Secrets manager |
| Name | Description |
|---|---|
| my-shell | My shell dotfiles. |
| my-hyprland | My NixOS dotfiles. |
| my-neovim | My NeoVim dotfiles. |
| Package | Purpose |
|---|---|
| Nerd Fonts (JetBrainsMono) | Required by Rofi and Waybar themes |
These are dotfiles — stow or symlink them into your home directory. No installer script exists yet; manual placement is straightforward.
1. Clone the repo
git clone https://github.com/TylerDurham/my-hyprland.git
cd my-hyprland2. Copy (or symlink) config files into $HOME
# Using GNU stow (recommended)
stow --target="$HOME" .
# Or copy manually
cp -r .config .local ~3. Ensure the custom scripts are executable
chmod +x ~/.local/share/my/bin/hypr-*4. Add the scripts to your PATH
The Hyprland config automatically prepends ~/.local/share/my/bin to $PATH. To use the scripts outside of Hyprland, add this to your shell profile:
export PATH="$HOME/.local/share/my/bin:$PATH"
export MY_LIB_DIR="$HOME/.local/share/my/lib"5. Set an active theme
hypr-set-current-theme lovely-day # or catppuccin-mocha, matte-black, osaka-jade, everforest
hypr-set-current-theme # or omit the name to pick one from an fzf menu6. Install web apps (optional)
Installs a curated set of web apps (Excalidraw, Logos, Gitea, GitHub, Claude.ai) as standalone browser-backed desktop entries:
./install-webapps.sh7. Start Hyprland
HyprlandPress
SUPER + Kat any time to search keybinds interactively in Rofi.
| Keybind | Action |
|---|---|
SUPER + Return |
Open terminal (Ghostty) |
SUPER + Space |
Open app launcher (Rofi) |
SUPER + B |
Open browser (Brave) |
SUPER + E |
Open file manager (Nautilus) |
SUPER + N |
Open notes (Obsidian) |
SUPER + K |
Search keybinds |
SUPER + Q |
Close focused window |
| Keybind | Action |
|---|---|
SUPER + A |
Toggle notification center (swaync) |
SUPER + SHIFT + L |
Lock screen |
SUPER + SHIFT + N |
Toggle night light |
SUPER + SHIFT + S |
Open system control menu (lock, suspend, logout, reboot, shutdown) |
SUPER + SHIFT + W |
Select and set wallpaper |
SUPER + W |
Next wallpaper in the active theme |
SUPER + CTRL + W |
Previous wallpaper in the active theme |
SUPER + ALT + W |
Random wallpaper from the active theme |
| Keybind | Action |
|---|---|
SUPER + 1–9 |
Switch to workspace |
SUPER + [ |
Cycle to next non-empty window |
SUPER + SHIFT + [ |
Next non-empty workspace |
SUPER + SHIFT + ] |
Previous non-empty workspace |
| Keybind | Action |
|---|---|
SUPER + SHIFT + 1–9 |
Move window to workspace |
SUPER + SHIFT + ← |
Move workspace to left monitor |
SUPER + SHIFT + → |
Move workspace to right monitor |
SUPER + LMB drag |
Move window |
SUPER + SHIFT + LMB drag |
Resize window |
| Key | Action |
|---|---|
XF86AudioRaiseVolume |
Volume up |
XF86AudioLowerVolume |
Volume down |
XF86AudioMute |
Toggle mute |
XF86AudioMicMute |
Toggle mic mute |
XF86MonBrightnessUp |
Brightness up |
XF86MonBrightnessDown |
Brightness down |
XF86AudioNext |
Next track |
XF86AudioPlay |
Play / Pause |
XF86AudioPrev |
Previous track |
| Gesture | Action |
|---|---|
| 3-finger swipe left/right | Scroll / move windows |
| 3-finger swipe left/right + SHIFT | Switch workspaces |
| 3-finger swipe down + ALT | Close window |
| 4-finger pinch out | Toggle fullscreen |
Themes live under .local/share/my/themes/. Each theme contains:
theme-name/
├── backgrounds/ # Wallpaper variants
├── @palette.toml # Color palette (accent1/2, background, surfaces, …)
├── icons.theme # Icon set
├── btop.theme # btop system monitor
├── neovim.lua # Neovim colorscheme
├── vscode.json # VS Code theme
├── waybar.css # Waybar stylesheet (also read by SwayOSD)
├── rofi.rasi # Rofi stylesheet
├── hyprland.conf # Color vars — sourced by hyprlock, parsed by looknfeel.lua
├── ghostty.conf # Ghostty palette (included via ~/.config/my/theme)
└── nmtui.colors # nmtui palette (via NEWT_COLORS_FILE)
Every theme also ships stylesheets for GTK, Kitty, Ghostty, Alacritty, Zed, Zellij,
Mako, Wofi, Walker, Warp, Chromium, and Vencord. Some still carry a legacy flat
colors.toml alongside @palette.toml; nothing reads it except the fallback in
theme.lua.
Switch themes at runtime:
hypr-set-current-theme <theme-name> # or run it with no arguments to pick from an fzf menuThis updates the wallpaper and color symlinks, restarts Waybar and SwayOSD, reloads Ghostty (SIGUSR2), and reloads Hyprland — which re-reads the palette, so window border colors follow the theme too.
Hyprland's border colors are read at config-eval time by modules/lib/theme.lua, which
looks for hyprland.conf, then @palette.toml, then colors.toml in the active theme,
falling back to built-in defaults if none are present.
Cycle the active theme's wallpapers: SUPER + W (next), SUPER + CTRL + W
(previous), SUPER + ALT + W (random) — see hypr-cycle-wallpaper --help.
.
├── .config/
│ ├── hypr/
│ │ ├── hyprland.lua # Main entry point
│ │ ├── hypridle.conf # Idle / lock timeouts
│ │ ├── hyprlock.conf # Lock screen appearance
│ │ ├── hyprsunset.conf # Night light schedule
│ │ └── modules/
│ │ ├── autostart.lua # Startup applications
│ │ ├── globals.lua # Default programs and modifier key
│ │ ├── keybinds.lua # All keyboard bindings
│ │ ├── layouts.lua # Tiling layout config
│ │ ├── looknfeel.lua # Gaps, borders, blur, animations
│ │ ├── monitors.lua # Monitor layout and scaling
│ │ ├── windows.lua # Window rules and floats
│ │ ├── workspaces.lua # Workspace-to-monitor assignment
│ │ └── applications/ # Per-app window rules
│ ├── rofi/ # Rofi launcher themes and modules
│ │ └── modules/ # JSON module definitions (system, etc.)
│ └── swayosd/ # OSD styling
└── .local/share/my/
├── bin/ # Custom shell scripts
├── lib/ # Shared bash libraries
└── themes/ # Color themes
Default programs are defined in .config/hypr/modules/globals.lua:
g.programs = {
TERMINAL = "ghostty",
FILE_MANAGER = "nautilus",
APP_LAUNCHER = "~/.local/share/my/bin/hypr-launch-applications",
BROWSER = "brave",
NOTES = "obsidian",
}
g.keybinds = {
MAIN_MOD = "SUPER",
}MIT