DiamondEyesFox's Hyprland Rice 🎨

A sleek, modern Hyprland configuration with Material You theming, featuring dynamic colors, powerful scratchpads, and beautiful animations.

✨ Features

🎨 Dynamic Theming

• Matugen - Material You color generation from wallpaper
• Automatic color synchronization across all apps
• Beautiful color-coordinated borders and UI elements

📦 Scratchpads (Pyprland)

Instant access to your most-used apps:

• Super + Space - Quick terminal
• Ctrl + Space - Claude Code AI assistant
• Super + K - Keybinds cheatsheet (this guide!)
• Super + B - System monitor (btop)
• Super + M - Music player (Plexamp)
• Super + Shift + V - Volume control

🪟 Window Management

• Hyprland - Wayland compositor with smooth animations
• Pyprland - Advanced scratchpad and window management
• Expose mode - macOS-style Mission Control (Super + A)

🎵 Media & Audio

• Cava - Audio visualizer in Waybar
• Playerctl - Media controls
• Plexamp integration

🔒 System

• Hyprlock - Beautiful lock screen with blur effects
• Hypridle - Idle management
• swaync - Notification center

📦 Dependencies

Core

sudo pacman -S hyprland waybar rofi kitty swaync

Additional Tools

yay -S pyprland matugen cava hyprlock hypridle

Optional

yay -S playerctl brightnessctl grim slurp wl-clipboard

🚀 Installation

1. Backup Your Current Configs

mkdir -p ~/.config-backup
cp -r ~/.config/hypr ~/.config-backup/
cp -r ~/.config/waybar ~/.config-backup/
# ... backup other configs

2. Clone This Repository

git clone https://github.com/DiamondEyesFox/hyprland-dotfiles.git
cd hyprland-dotfiles

3. Install Configs

cp -r hypr ~/.config/
cp -r waybar ~/.config/
cp -r kitty ~/.config/
cp -r rofi ~/.config/
cp -r swaync ~/.config/
cp -r matugen ~/.config/

4. Set Wallpaper

mkdir -p ~/Pictures/Wallpapers
cp wallpapers/wallpaper.jpg ~/Pictures/Wallpapers/current.jpg

5. Enable Services

systemctl --user enable --now swaync

6. Reload Hyprland

Press Super + Shift + R or restart Hyprland

⌨️ Keybindings

Launchers

• Super + Return - Terminal
• Alt + Space - Rofi launcher
• Super + E - File manager
• Super + N - Notification center

Window Management

• Super + Q - Kill active window
• Super + V - Toggle floating
• Super + F - Fullscreen
• Super + T - Toggle split direction
• Super + Arrow Keys - Move focus
• Super + Shift + Arrows - Move window

Workspaces

• Super + 1-9, 0 - Switch to workspace
• Super + Shift + 1-9, 0 - Move window to workspace
• Super + S - Toggle special workspace
• Super + Tab - Workspace overview
• Super + A - Mission Control (Expose)

Scratchpads

• Super + Space - Quick terminal
• Ctrl + Space - Claude Code AI
• Super + K - Keybinds cheatsheet
• Super + B - System monitor
• Super + M - Music player
• Super + Shift + V - Volume control

System

• Super + L - Lock screen
• Super + W - Wallpaper gallery
• Super + Shift + `` - Save session
• Super + Ctrl + `` - Restore session

Screenshots

• Alt + Shift + 3 - Full screenshot
• Alt + Shift + 4 - Region screenshot
• Alt + Shift + 5 - Screenshot menu
• Print - Quick screenshot

Media Controls

• XF86AudioNext - Next track
• XF86AudioPrev - Previous track
• XF86AudioPlay - Play/Pause
• XF86AudioRaiseVolume - Volume up
• XF86AudioLowerVolume - Volume down

Press Super + K anytime to see the full keybinds cheat sheet!

📁 Structure

dotfiles/
├── hypr/           # Hyprland configuration
│   ├── hyprland.conf
│   ├── hyprlock.conf
│   ├── hypridle.conf
│   ├── colors.conf
│   └── scripts/    # Custom scripts
├── waybar/         # Status bar
│   ├── config
│   ├── modules
│   ├── style.css
│   └── colors.css  # Auto-generated by matugen
├── kitty/          # Terminal
│   ├── kitty.conf
│   └── kitty-colors.conf
├── rofi/           # App launcher
│   └── theme.rasi
├── swaync/         # Notifications
│   └── colors.css
├── matugen/        # Color theming
│   ├── config.toml
│   └── templates/
└── wallpapers/     # Wallpaper
    └── wallpaper.jpg

🎨 Customization

Change Colors

The color scheme is automatically generated from your wallpaper using Matugen (Material You). Simply change your wallpaper and the colors will update automatically!

Modify Scratchpads

Edit ~/.config/hypr/pyprland.toml to customize scratchpad behavior.

Waybar Modules

Edit ~/.config/waybar/modules to add/remove Waybar modules.

🙏 Credits

• Hyprland - vaxerski
• Pyprland - hyprland-community
• Matugen - InioX
• Waybar config inspiration - JaKooLit
• Built with assistance from Claude Code AI

📸 Screenshots

Add screenshots here!

📝 License

MIT License - Feel free to use and modify!

---

Made with ❤️ and Claude Code