Hyprland Dotfiles

A comprehensive Hyprland configuration with custom scripts, themes, and optimizations for Arch Linux.

🖼️ Screenshots

✨ Features

• Hyprland - Dynamic tiling Wayland compositor
• Waybar - Highly customizable status bar
• Rofi - Application launcher with custom themes
• Kitty - GPU-accelerated terminal emulator
• Mako/SwayNC - Notification daemon
• Greenclip - Clipboard manager
• Fastfetch - System information tool
• Custom scripts - Automation and utilities
• Consistent theming - Unified look across all applications

📋 Requirements

System Requirements

• OS: Arch Linux (primary support)
• Display Server: Wayland
• GPU: Any GPU with Vulkan support (recommended)

Dependencies

Essential Packages

# Core Hyprland ecosystem
hyprland waybar rofi kitty mako

# System utilities
fastfetch ranger vim git

# Audio/Media
pulseaudio pamixer

# Additional tools
greenclip xpad telegram-desktop google-chrome

Optional Packages

# Notification alternatives
swaync dunst

# Terminal alternatives
alacritty

# System monitoring
htop neofetch cava

# Display management
ly picom

🚀 Installation

Quick Install

1. Clone the repository

   cd ~/
   git clone https://github.com/TolaMironcenko/hyprland_dotfiles.git dotfiles
   cd ~/dotfiles
   

2. Run the installation script

   ./install_scripts/install.sh
   

Manual Installation

If you prefer to install components individually:

# Hyprland configuration
ln -s ~/dotfiles/hypr ~/.config/hypr

# Waybar configuration
ln -s ~/dotfiles/waybar ~/.config/waybar

# Terminal configuration
ln -s ~/dotfiles/kitty ~/.config/kitty

# Other configurations
ln -s ~/dotfiles/mako ~/.config/mako
ln -s ~/dotfiles/ranger ~/.config/ranger
ln -s ~/dotfiles/fastfetch ~/.config/fastfetch
ln -s ~/dotfiles/vimrc ~/.vimrc

Full System Installation (Arch Linux)

For a complete Arch Linux installation with this configuration:

1. Customize the installation script

   vim install_scripts/install-arch.sh
   # Edit variables: disk, hostname, normal_user, etc.
   

2. Run the installer (as root)

   ./install_scripts/install-arch.sh
   

⌨️ Keybindings

Key Combination	Action
Alt	Main modifier key
Alt + Q	Close window
Alt + V	Toggle floating window
Alt + Return	Open terminal (Kitty)
Alt + D	Open Rofi launcher
Alt + Shift + P	Open Rofi power menu
Alt + C	Open Rofi clipboard (Greenclip)
Alt + B	Lock screen (Hyprlock)
Alt + Shift + C	Screenshot to clipboard
Alt + [1-0]	Switch to workspace [1-10]
Alt + X	Open Xpad
Alt + Shift + X	Open new note in Xpad
Alt + A	Open Telegram
Alt + G	Open Google Chrome

Additional Keybindings

• Window Management: Alt + H/J/K/L for directional focus
• Workspace Movement: Alt + Shift + [1-0] to move window to workspace
• Resize Mode: Alt + R to enter resize mode
• Fullscreen: Alt + F to toggle fullscreen

🎨 Customization

Themes

The configuration uses a consistent color scheme across all applications:

• Primary: Blue accent (#33ccff)
• Secondary: Green accent (#00ff99)
• Background: Dark theme optimized for OLED displays

Waybar Modules

Current modules (left to right):

• Left: Launcher, CPU, Memory, Temperature, Disk, Weather, Updates, Window title
• Center: Workspaces
• Right: Audio, Media, Backlight, Keyboard, Language, Battery, Clock, Tray, Power

Rofi Themes

Multiple Rofi configurations included:

• Application launcher
• Power menu
• Clipboard manager
• Emoji picker (rofimoji)

🔧 Configuration Structure

dotfiles/
├── hypr/                 # Hyprland configuration
│   ├── hyprland.conf    # Main configuration
│   ├── keybinds.conf    # Keybinding definitions
│   ├── startup.conf     # Startup applications
│   └── windowrules.conf # Window rules
├── waybar/              # Status bar configuration
├── rofi/                # Application launcher themes
├── kitty/               # Terminal configuration
├── mako/                # Notification daemon
├── ranger/              # File manager
├── shell/               # Shell aliases and functions
├── bin/                 # Custom scripts
└── install_scripts/     # Installation automation

🛠️ Troubleshooting

Common Issues

1. Hyprland won't start

   • Check GPU drivers: lspci -k | grep -A 2 -E "(VGA|3D)"
   • Verify Wayland support: echo $XDG_SESSION_TYPE

2. Waybar not showing

   • Check if running: pgrep waybar
   • Restart: killall waybar && waybar &

3. Audio issues

   • Check PulseAudio: pulseaudio --check
   • Restart audio: pulseaudio -k && pulseaudio --start

4. Rofi not launching

   • Check configuration: rofi -dump-config
   • Test with: rofi -show drun

Log Files

• Hyprland: ~/.local/share/hyprland/hyprland.log
• Waybar: Check journal: journalctl --user -u waybar

📝 Shell Aliases

The configuration includes numerous helpful aliases:

System Management

• p - pacman
• pi - install package
• psyu - system upgrade
• sctl - systemctl
• ff - fastfetch

Development

• g - git
• ga - git add
• gc - git clone
• gst - git status

Docker

• dr - docker run
• dpa - docker ps -a
• ds - docker start

[Full alias list in shell/source.sh]

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Hyprland - Amazing Wayland compositor
• Waybar - Flexible status bar
• Rofi - Application launcher
• The Arch Linux community for excellent documentation

📞 Support

• Issues: GitHub Issues
• Wiki: Project Wiki
• Email: Contact

---

Note: This configuration is primarily tested on Arch Linux. While it may work on other distributions, you may need to adjust package names and paths accordingly.