🚀 Hyprland Dotfiles

A modern, keyboard-driven Wayland desktop environment for developers who love vim keybindings

📖 Table of Contents

✨ Features
🖼️ Screenshots
🎨 What's Inside
💻 Hardware
🔧 Installation
⚙️ Configuration
⌨️ Keybindings
🛠️ Troubleshooting
📚 Documentation
📜 Changelog

✨ Features

🎮 Hybrid GPU Zero-Lag Setup

Optimized for laptops with Intel + NVIDIA GPUs. Eliminates input lag on external displays through smart GPU routing.

📺 Internal display → Intel iGPU (direct rendering)
🖥️ External display → NVIDIA dGPU (direct rendering)
⚡ No cross-GPU frame copying = zero lag
📄 Full docs: NVIDIA_HYBRID_FIX.md

🎯 Smart Display Management

🔆 Auto brightness detection (internal vs external)
🎚️ F5/F6 for brightness control (5% steps)
🖥️ Super+P to toggle monitors
💡 Waybar brightness widget with scroll support

⌨️ Vim Everywhere

🎯 hjkl navigation throughout the system
🪟 Window management with vim bindings
📝 Consistent keybindings across all apps
🚀 Super (Windows) key as modifier

🎨 Beautiful & Fast

🌈 Gruvbox color scheme
🎭 Arc-Dark GTK theme
⚡ Buttery smooth animations
🖼️ Transparent terminal (0.8 opacity)

🖼️ Screenshots

🔒 Lock screen with blur effect
📊 Waybar status bar with custom modules
🖥️ Kitty terminal with Gruvbox theme

🎨 What's Inside

🪟 Core Desktop

Component	What I Use	Why
🗔 Compositor	Hyprland 0.53.3	Modern tiling Wayland compositor
📊 Bar	Waybar	Highly customizable status bar
💻 Terminal	Kitty	Fast, GPU-accelerated, Wayland-native
📥 Dropdown	Kitty (Super+C / F12)	Centered floating scratchpad terminal
🔍 Launcher	Rofi	Quick app launcher
🔔 Notifications	mako	Lightweight notification daemon
🔒 Lock	hyprlock	Beautiful lock screen with blur
📸 Screenshots	grim + slurp + swappy	Screenshot, select, edit, done!

🛠️ Development Stack

📝 Editors: Neovim + VS Code (Wayland-native)
🐍 IDE: PyCharm (native Wayland via WLToolkit)
🐚 Shell: ZSH with custom completions
📦 Dotfiles: Bare git repo (no symlinks!)

🔊 Audio & Media

🎵 Audio: PipeWire + WirePlumber (auto device switching)
🎧 USB-C headphones: Plug & play, auto-routes on connect/disconnect
🔊 Volume: wpctl with 100% cap (wpctl set-volume -l 1.0)
📄 PDF: Sioyek (replaced Zathura)
🎬 Video: mpv (Vulkan, gpu-next, uosc + thumbfast)

🎨 Theme & Appearance

🎨 GTK: Arc-Dark
🎭 Icons: Papirus-Dark
🔤 UI Font: Noto Sans 10
💻 Terminal Font: Hack 10
🌈 Colors: Gruvbox Dark Soft
- Terminal: #32302f
- Waybar: #1d2021

💻 Hardware

Device: ThinkPad X1 Extreme 2nd Gen (20QV0007US)

Component	Spec
🧠 CPU	Intel i7-9750H (6c/12t) @ 4.5GHz
🎮 iGPU	Intel UHD 630
🖥️ dGPU	NVIDIA GTX 1650 Mobile
📱 Internal	1920×1080 @ 60Hz (eDP-1)
🖥️ External	ASUS PA279CV 27" 4K @ 60Hz (DP-2, 1.5× scale)

🔧 Installation

📦 Prerequisites

# Core desktop
sudo pacman -S hyprland waybar kitty rofi mako swaybg grim slurp swappy

# Audio (PipeWire + WirePlumber for auto device switching)
sudo pacman -S pipewire pipewire-pulse wireplumber

# Fonts & themes
sudo pacman -S ttf-jetbrains-mono-nerd ttf-nerd-fonts-symbols
sudo pacman -S arc-gtk-theme papirus-icon-theme

# Hybrid GPU support
sudo pacman -S nvidia-open-lts brightnessctl ddcutil

# Development tools
sudo pacman -S neovim zsh fzf ripgrep

📥 Clone Dotfiles

# Clone as bare repo
git clone --bare https://github.com/funnydman/my-dot-files.git $HOME/.cfg

# Setup alias
alias config='/usr/bin/git --git-dir=$HOME/.cfg/ --work-tree=$HOME'

# Checkout configs
config checkout master

# Hide untracked files
config config --local status.showUntrackedFiles no

🚀 Post-Install

# NVIDIA setup
sudo systemctl enable --now nvidia-persistenced
sudo udevadm control --reload-rules && sudo udevadm trigger

# Fonts
fc-cache -fv

# Launch Hyprland
Hyprland

⚙️ Configuration

📁 Key Config Files

🗔 Hyprland Configs

~/.config/hypr/hyprland.conf (460 lines) - Main configuration
~/.config/hypr/hypridle.conf - Idle management
~/.config/hypr/hyprlock.conf - Lock screen config
~/.config/hypr/hyprpaper.conf - Wallpaper settings
~/.config/hypr/NVIDIA_HYBRID_FIX.md - GPU docs

📊 Status Bar

~/.config/waybar/config (120 lines) - Modules & layout
~/.config/waybar/style.css (285 lines) - Gruvbox styling

💻 Terminal

~/.config/kitty/kitty.conf (105 lines) - Kitty config (also used as dropdown terminal)
~/.claude/keybindings.json - Claude Code keybindings (image paste on Ctrl+Shift+V)

Copy/Paste Setup (IDE-style):

Ctrl+C - Copy if text selected, SIGINT if not (copy_and_clear_or_interrupt)
Ctrl+V - Paste text from clipboard
Ctrl+Shift+V - Paste image (in Claude Code only)
Remote control enabled (allow_remote_control socket-only) for TUI app compatibility

🎨 Theme

~/.config/gtk-3.0/settings.ini - GTK3 theme
~/.config/gtk-4.0/settings.ini - GTK4 theme
~/.gtkrc-2.0 - GTK2 legacy
~/.config/fontconfig/fonts.conf - Font rendering
~/.Xresources - Xft settings

📝 Development

~/.config/nvim/init.vim (209 lines) - Neovim config
~/.ideavimrc - Vim bindings for PyCharm
~/.config/code-flags.conf - VS Code Wayland flags
~/.zshrc (184 lines) - Shell config

🔧 Custom Scripts

📊 Smart Brightness (~/.config/scripts/brightness-adjust.sh)

Auto-detects which display is active
Internal: brightnessctl for laptop screen
External: ddcutil for monitor (DDC/CI)

🖥️ Monitor Toggle (~/.config/scripts/monitor-toggle.sh)

Switch between internal/external displays
Bound to Super+P
Auto-runs on startup

🔊 Volume Control (direct in hyprland.conf)

Uses wpctl set-volume -l 1.0 @DEFAULT_AUDIO_SINK@ 5%+ directly
Legacy volume.sh script no longer used by media keys

⌨️ Keybindings

Note: Mod = Super (Windows key)

🪟 Window Management

Keys	Action
`Mod + Return`	💻 Launch terminal
`Mod + Q`	❌ Close window
`Mod + F`	⛶ Toggle fullscreen
`Mod + Shift + Space`	🎈 Toggle floating
`Mod + hjkl` / `Arrows`	🧭 Focus windows
`Mod + Shift + hjkl` / `Arrows`	🚚 Move windows

📑 Workspaces

Keys	Action
`Mod + 1-9, 0`	🔢 Switch workspace 1-10
`Mod + Shift + 1-9, 0`	📦 Move window to workspace
`Mod + Tab`	⏮️ Previous workspace

📋 Copy/Paste (IDE-style)

Keys	Action
`Ctrl + C`	📋 Copy (if selected) / SIGINT (if not)
`Ctrl + V`	📋 Paste text from clipboard
`Ctrl + Shift + V`	🖼️ Paste image (Claude Code)
`Shift + Insert`	📋 Paste text (alternative)

Nuance: Kitty intercepts Ctrl+V for text paste before TUI apps see it. Claude Code's image paste is remapped to Ctrl+Shift+V via ~/.claude/keybindings.json. Kitty's default Ctrl+Shift+V is cleared so it passes through to Claude Code.

🚀 Applications

Keys	Action
`Mod + D`	🔍 Launch Rofi
`Mod + C` / `F12`	📥 Toggle kitty dropdown
`Mod + Escape`	🔒 Lock screen

🖥️ System Controls

Keys	Action
`Mod + P`	🖥️ Toggle monitor
`F5` / `F6`	🔆 Brightness down/up
`Print`	📸 Screenshot region
`Shift + Print`	📸 Screenshot fullscreen
`XF86Audio*`	🔊 Volume/media controls

🎯 Advanced Modes

Keys	Mode
`Mod + R`	📏 Resize mode (hjkl/arrows to resize)
`Mod + X`	🚪 Exit mode (L=logout, R=reboot, S=shutdown)
`Mod + Shift + G`	📐 Gap mode (O=outer, I=inner)

📖 Full keybindings: ~/.config/hypr/hyprland.conf (lines 209-393)

🛠️ Troubleshooting

🐌 Input lag on external monitor?

Symptoms: 0.1-0.3s delay when typing/moving mouse

Fix: Apply the GPU configuration from NVIDIA_HYBRID_FIX.md

Creates stable GPU device symlinks
Routes each display to its physically-connected GPU
Eliminates cross-GPU frame copying

🔤 Fonts look weird?

# Rebuild font cache
fc-cache -fv

# Verify Nerd Fonts are installed
pango-list | grep -i nerd

# Check config
cat ~/.config/fontconfig/fonts.conf

❌ Waybar icons not showing?

# Install fonts
sudo pacman -S ttf-jetbrains-mono-nerd ttf-nerd-fonts-symbols

# Restart waybar
killall waybar && waybar &

🔆 Brightness keys don't work?

Internal display: Check brightnessctl -l

External display: Verify DDC/CI support

ddcutil detect

🔄 SDDM login loop?

Check GPU configuration in ~/.config/hypr/hyprland.conf:

Verify AQ_DRM_DEVICES setting
See troubleshooting in NVIDIA_HYBRID_FIX.md

🐍 PyCharm terminal vim-mode broken?

PyCharm 2026's reworked terminal engine breaks zsh vi-mode. Fix:

Disable "Move focus to editor with Esc" — Settings → Tools → Terminal, uncheck it. Intercepts ESC before zsh vi-mode can receive it.
Disable Shell integration — Settings → Tools → Terminal, uncheck Shell integration. Still intercepts input even after the ESC fix.

🔒 Can't type password on lock screen?

If keyboard was on Russian layout when screen locked, hyprlock inherits that layout and you can't type your password. Already fixed: hyprctl switchxkblayout all 0 runs before hyprlock in both hyprland.conf and hypridle.conf.

🔍 Debug Logs

# Hyprland logs
cat ~/.hyprland.log

# Check which GPU is rendering
cat /proc/$(pgrep -x Hyprland)/maps | grep -E "nvidia|i915"

# Waybar debug
killall waybar && waybar

📚 Documentation

📖 Detailed Guides

🎮 NVIDIA_HYBRID_FIX.md - Complete hybrid GPU setup guide
- Root cause analysis of input lag
- Step-by-step fix with udev rules
- Verification commands
⌨️ IDEAVIM_GUIDE.md - IdeaVim configuration & plugins
- Available plugins (20+ options)
- Recommended additions (which-key, NERDTree, exchange)
- Modern best practices (2025-2026)
- Action mappings for refactoring & testing
🔆 brightness-auto-detection.md - DDC bus auto-detection for external monitor brightness
🍎 mac-setup.md - MacBook Pro M4 Pro setup (display, sleep, audio, KVM)
🪑 flexispot-e7-plus-memory.md - FlexiSpot E7 Plus memory presets

🔧 Quick Reference

Managing dotfiles:

# Add new config
config add ~/.config/newapp/config.conf
config commit -m "Add newapp config"
config push

# Check status
config status

# List tracked files
config ls-files

Config locations:

🗔 Hyprland: ~/.config/hypr/
📊 Waybar: ~/.config/waybar/
🔧 Scripts: ~/.config/scripts/
📄 Docs: ~/.config/*.md

📜 Changelog

Version History

Version	Date	Changes
v2.2	2026-03	🔧 Media & Fixes
		- Added Sioyek PDF viewer (replaced Zathura)
		- Added mpv with Vulkan, uosc, thumbfast
		- Fixed hyprlock Russian layout lockout (auto-switch to EN before lock)
		- Volume keys now use wpctl directly (replaced broken volume.sh)
		- Fixed monitor-toggle detection for disabled displays
		- WirePlumber priority config for stable audio defaults
		- Waybar startup race condition fix (delayed start)
		- Kitty Ctrl+F search in terminal
v2.1	2026-02	🔧 Polish & Modernization
		- Replaced Guake with Kitty dropdown (Super+C, centered float)
		- Per-app scratchpads (Telegram, KeePass)
		- PipeWire + WirePlumber (auto USB-C audio switching)
		- Fixed font rendering with croscore metric-compatible fonts
		- Focus follows mouse
v2.0	2025-02	🎉 Hyprland/Wayland Migration
		- Switched from i3 to Hyprland
		- X11 → Wayland (native)
		- polybar → Waybar
		- st → Kitty (Wayland-native)
		- i3lock-fancy → hyprlock
		- dunst → mako
		- Fixed NVIDIA hybrid GPU input lag
		- Preserved vim keybindings & workflow
v1.0	2020	🚀 Initial i3/X11 setup

🔄 Key Preserved Features

Despite the major migration, these features remained unchanged:

⌨️ Vim-style hjkl navigation
🔢 Workspace numbers (1-10)
📥 Dropdown terminal (now Kitty instead of Guake)
📐 Negative gaps (i3-style: 4px inner, -4px outer)
🎨 Arc-Dark + Gruvbox theme combination

🆕 New in v2.0

⚡ Zero-lag external display support
🎮 Hybrid GPU optimization
🔆 Smart brightness control
🖥️ Monitor toggle (Super+P)
📸 Modern screenshot workflow (grim + slurp + swappy)
🎭 Native Wayland app support

🙏 Credits

Hyprland - Amazing Wayland compositor
Waybar - Highly customizable status bar
Gruvbox - Retro groove color scheme
Arc Theme - Flat GTK theme
Nerd Fonts - Icon fonts for developers

📄 License

Personal dotfiles - use freely, modify as needed! 🎉

Name		Name	Last commit message	Last commit date
Latest commit History 200 Commits
.config		.config
.Xresources		.Xresources
.bashrc		.bashrc
.gdbinit		.gdbinit
.git_aliases		.git_aliases
.gtkrc-2.0		.gtkrc-2.0
.ideavimrc		.ideavimrc
.zshrc		.zshrc
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

🚀 Hyprland Dotfiles

📖 Table of Contents

✨ Features

🎮 Hybrid GPU Zero-Lag Setup

🎯 Smart Display Management

⌨️ Vim Everywhere

🎨 Beautiful & Fast

🖼️ Screenshots

🎨 What's Inside

🪟 Core Desktop

🛠️ Development Stack

🔊 Audio & Media

🎨 Theme & Appearance

💻 Hardware

🔧 Installation

📦 Prerequisites

📥 Clone Dotfiles

🚀 Post-Install

⚙️ Configuration

📁 Key Config Files

🔧 Custom Scripts

⌨️ Keybindings

🪟 Window Management

📑 Workspaces

📋 Copy/Paste (IDE-style)

🚀 Applications

🖥️ System Controls

🎯 Advanced Modes

🛠️ Troubleshooting

🐌 Input lag on external monitor?

🔤 Fonts look weird?

❌ Waybar icons not showing?

🔆 Brightness keys don't work?

🔄 SDDM login loop?

🐍 PyCharm terminal vim-mode broken?

🔒 Can't type password on lock screen?

🔍 Debug Logs

📚 Documentation

📖 Detailed Guides

🔧 Quick Reference

📜 Changelog

Version History

🔄 Key Preserved Features

🆕 New in v2.0

🙏 Credits

📄 License

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages