A comprehensive collection of dotfiles and configurations for creating a beautiful, efficient Hyprland desktop environment on Arch Linux
🚀 Quick Install • 📸 Screenshots • 🔧 Features • 📖 Documentation • 🤝 Contributing
For detailed documentation and preferences, visit: https://hyprflux.dev
HyprFlux is a meticulously crafted collection of configuration files designed to transform your Arch Linux installation into a stunning, productive desktop environment. Built around the modern Hyprland compositor, it provides a seamless blend of aesthetics and functionality.
- 🎨 Beautiful Design: Carefully curated themes and color schemes
- ⚡ Performance Optimized: Lightweight and fast configurations
- 🔧 Fully Automated: One-command installation with intelligent setup
- 🎯 Developer Focused: Optimized for productivity and development workflows
- 🌈 Customizable: Easy to modify and extend according to your preferences
- Operating System: Arch Linux (minimal installation recommended)
- Architecture: x86_64
- Memory: Minimum 4GB RAM (8GB+ recommended)
- Storage: At least 10GB free space
- Network: Active internet connection for package downloads
- Fresh Arch Linux installation with minimal profile
- Basic system utilities (curl, git, sudo)
- User account with sudo privileges
sh <(curl -fsSL https://hyprflux.dev/install)
⚠️ Important: This script will modify your system configuration. Make sure to backup any existing dotfiles before proceeding.
- Run the installation command - The script will automatically download and execute
- Enter sudo password when prompted
- Follow the interactive setup - Select your preferred options:
Essential Components (Recommended):
- ✅
sddm- Display manager for login screen - ✅
sddm_theme- Beautiful custom SDDM theme - ✅
gtk_themes- GTK theme integration - ✅
bluetooth- Bluetooth support - ✅
thunar- File manager - ✅
xdph- Desktop portal for Hyprland - ✅
zsh- Enhanced shell with Oh My Zsh - ✅
dots- Core dotfiles and configurations
Optional Components:
QuickShell- QuickShell for Desktop-Like OverviewPokemon- Add Pokemon color scripts to your terminalRog- Download and Install Pre-configured for ROG Laptops
During installation, you'll be prompted to configure:
| Setting | Options | Description |
|---|---|---|
| Keyboard Layout | Various layouts | Select your preferred keyboard layout |
| Text Editor | nano, nvim, vim | Choose your default terminal editor |
| Hyprlock Resolution | Multiple resolutions | Set lock screen resolution |
| Clock Format | 12h / 24h | Choose time display format |
| SDDM Wallpaper | Multiple options | Select login screen background |
| Extra Wallpapers | Yes / No | Download additional wallpapers (~1GB) |
The installer will request sudo password 2-3 times during the process:
- Once for initial system setup
- Once for Zsh configuration
- Once for wallust installation
- Additional prompts for optional packages
- Hyprland: Modern Wayland compositor with smooth animations
- Waybar: Highly customizable status bar
- Rofi: Application launcher and window switcher
- SDDM: Beautiful login manager with custom theme
- Material Design: Deep Ocean color scheme
- Papirus Icons: Comprehensive icon theme with cyan accents
- Future Black Cursors: Custom cursor theme
- GTK Integration: Seamless theme integration across applications
- Neovim: Fully configured with plugins and LSP support
- Tmux: Terminal multiplexer with custom layouts
- Zsh: Enhanced shell with Oh My Zsh and custom theme
- Git Integration: Pre-configured Git settings
- Thunar: File manager with custom configurations
- Kitty, Foot, Alacritty: Terminal options
- VLC, OBS Studio: Media and content creation tools
- Obsidian, VS Code: Productivity applications
Automated setup of Progressive Web Apps (PWAs) for:
- Netflix, YouTube, Spotify
- GitHub, Vercel, Figma
- ChatGPT, Claude, Grok
- WhatsApp, Discord, Slack
- And many more...
After installation completes:
- Reboot your system when prompted
- Login through SDDM with your user credentials
- Enjoy your new desktop environment!
- Wallpapers: Located in
~/Pictures/wallpapers/ - Configurations: Found in
~/.config/ - Themes: Available in
~/.themes/ - Backup: Original configs backed up to
~/dotfiles_backup/
HyprFlux/
├── .config/ # Application configurations
│ ├── hypr/ # Hyprland configuration
│ ├── waybar/ # Status bar configuration
│ ├── rofi/ # Application launcher
│ └── ...
├── .themes/ # GTK themes
├── wallpapers/ # Wallpaper collection
├── utilities/ # Additional tools and themes
├── install.sh # Main installation script
├── dotsSetup.sh # Dotfiles setup script
└── README.md # This file
~/.config/hypr/hyprland.conf- Hyprland window manager settings~/.config/waybar/config- Status bar configuration~/.config/rofi/config.rasi- Application launcher styling~/.zshrc- Zsh shell configuration~/.tmux.conf- Terminal multiplexer settings
- 📋 Check the Issues page
- 💬 Join our community discussions
- 📧 Contact: ahmad9059@example.com
We welcome contributions! Here's how you can help:
- Check existing issues
- Create a new issue with detailed information
- Include system information and error logs
- Open a feature request issue
- Describe the feature and its benefits
- Provide implementation ideas if possible
- Fork the repository
- Create a feature branch:
git checkout -b feature-name - Make your changes and test thoroughly
- Submit a pull request with detailed description
- Improve README and documentation
- Add configuration examples
- Create tutorials and guides
This project is licensed under the MIT License - see the LICENSE file for details.
Special thanks to:
- Hyprland Community - For the amazing compositor
- Arch Linux Team - For the robust foundation
- Open Source Contributors - For the tools and themes used
- Community Members - For feedback and contributions
Made with ❤️ by ahmad9059
⭐ Star this repository if you found it helpful! ⭐