A complete Hyprland desktop environment profile for Fedpunk
Build your perfect keyboard-driven workspace with live theming, vim-style navigation, and modern development tools
Click to watch: Live theme switching, keyboard-driven workflow, and seamless module deployment
Hyprpunk is an external profile for Fedpunk that provides a complete Hyprland-based desktop environment with theming, development tools, and modern applications.
This is:
- ✅ A complete desktop environment profile
- ✅ 12 beautiful pre-configured themes
- ✅ 27 desktop-focused modules
- ✅ Custom plugins for enhanced functionality
- ✅ Multiple modes: desktop, laptop, container
This is NOT:
- ❌ A standalone desktop environment (requires Fedpunk core)
- ❌ A replacement for Fedpunk (it's a profile that uses Fedpunk)
# Install Fedpunk core engine
sudo dnf copr enable hinriksnaer/fedpunk
sudo dnf install fedpunk# Deploy hyprpunk desktop profile
fedpunk profile deploy [email protected]:hinriksnaer/hyprpunk.git --mode desktop# Deploy hyprpunk laptop profile (no NVIDIA, optimized for battery)
fedpunk profile deploy [email protected]:hinriksnaer/hyprpunk.git --mode laptop# Deploy minimal development environment (no GUI)
fedpunk profile deploy [email protected]:hinriksnaer/hyprpunk.git --mode container- Hyprland - Modern Wayland compositor
- Kitty - GPU-accelerated terminal
- Rofi - Application launcher
- Waybar - Status bar (coming soon)
- Hyprlock - Screen locker
- Neovim - Advanced text editor with LSP
- Tmux - Terminal multiplexer
- Lazygit - Git TUI
- Yazi - File manager TUI
- GitHub CLI - GitHub integration
- Claude Code - AI coding assistant
- Zen Browser - Privacy-focused browser
- Bitwarden CLI - Password manager
- Spotify - Music streaming (Flatpak)
- Discord - Communication (Flatpak)
- Slack - Team collaboration (Flatpak)
12 carefully curated themes with instant live-reload:
| Theme | Style | Best For |
|---|---|---|
| aetheria | Ethereal purple/blue gradients | Creative work |
| ayu-mirage | Warm desert tones | Extended coding sessions |
| catppuccin | Soothing pastel (mocha) | Low-light environments |
| catppuccin-latte | Light mode elegance | Bright workspaces |
| matte-black | Pure minimalism | Distraction-free focus |
| nord | Arctic cool tones | Scandinavian aesthetic |
| osaka-jade | Vibrant teal/green | Energizing workflow |
| ristretto | Rich espresso browns | Coffee-fueled coding |
| rose-pine | Soft rose/pine palette | Gentle on the eyes |
| rose-pine-dark | Deep rose/pine | Dark mode variant |
| tokyo-night | Deep blues with neon | Cyberpunk vibes |
| torrentz-hydra | Bold high contrast | Maximum readability |
Ayu Mirage - Warm desert tones for extended coding
Tokyo Night - Deep blues with neon accents
Torrentz Hydra - Bold high-contrast scheme
- Hyprland colors (borders, gaps, shadows)
- Kitty terminal colors (live reload via SIGUSR1)
- Rofi styling (launcher appearance)
- Btop theme (system monitor colors)
- Mako notifications (live reload via SIGUSR2)
- Neovim colorscheme (live reload via RPC)
- Waybar CSS (status bar theme)
- Custom wallpapers (per-theme backgrounds)
# List all themes
hyprpunk-theme-list
# Switch theme
hyprpunk-theme-set catppuccin
# Next/previous theme
hyprpunk-theme-next
hyprpunk-theme-prev
# Cycle wallpapers
hyprpunk-wallpaper-nextKeyboard shortcuts:
Super+T- Theme selector menuSuper+Shift+T- Next themeSuper+Shift+Y- Previous themeSuper+Shift+W- Next wallpaper
Full desktop environment with all features:
- Complete Hyprland setup
- All GUI applications
- NVIDIA support (optional)
- Audio and multimedia
- Bluetooth support
- WiFi management
Modules: 23 total
Optimized for laptops:
- Same as desktop
- Excludes NVIDIA drivers
- Includes Vertex AI plugin
- Battery optimized
Modules: 21 total
Minimal development environment:
- No GUI components
- Terminal tools only
- Neovim with full LSP
- Development utilities
- Claude Code integration
Modules: 9 total
Hyprpunk includes several custom plugins:
Theme switching and wallpaper management
- Live reload across all applications
- Rofi theme selector
- Per-theme wallpaper collections
Advanced Neovim configuration
- 40+ plugins
- Full LSP support
- Theme integration
- Custom keybindings
Google Vertex AI authentication for Claude Code
- Seamless Claude integration
- Secure credential management
Additional development tools
- Spotify, Discord, Slack (Flatpak)
- Devcontainer CLI
Aquacomputer Octo fan control
- Hardware-specific plugin
- Automated fan curves
LVM partition expansion utility
- One-time setup script
- Root partition expansion
Hyprpunk is built on Fedpunk's modular architecture:
hyprpunk/
├── modes/ # Desktop, laptop, container configurations
├── themes/ # 12 complete themes with wallpapers
├── modules/ # 27 desktop-focused modules
└── plugins/ # 6 custom plugins for enhanced functionality
How it works:
- Fedpunk core engine handles deployment
- Hyprpunk provides modules, themes, and plugins
- Mode selection determines which modules to deploy
- GNU Stow creates symlinks for instant configuration
- Lifecycle hooks handle post-installation setup
- OS: Fedora Linux 40+
- Arch: x86_64
- RAM: 8GB minimum, 16GB recommended
- Storage: ~2GB for desktop mode, ~500MB for container
- GPU: Any (NVIDIA support available)
- Display: Wayland-capable for desktop/laptop modes
Create custom Hyprland configs in ~/.config/fedpunk/hyprpunk/:
mkdir -p ~/.config/fedpunk/hyprpunk/hyprland
vim ~/.config/fedpunk/hyprpunk/hyprland/custom.confCopy and modify existing themes:
# Themes are in the hyprpunk repository after deployment
cd ~/.fedpunk/cache/external/github.com/hinriksnaer/hyprpunk/themes
cp -r nord my-custom-theme
vim my-custom-theme/kitty.conf
hyprpunk-theme-set my-custom-themeEdit your fedpunk.yaml to add more modules:
modules:
enabled:
- module: [email protected]:hinriksnaer/hyprpunk.git
mode: desktop
- module: https://github.com/user/custom-module.gitSuper+Return- TerminalSuper+Q- Close windowSuper+H/J/K/L- Focus windows (vim-style)Super+Shift+H/L- Cycle workspacesSuper+1-9- Switch workspaceSuper+Shift+1-9- Move window to workspaceSuper+V- Toggle floatingSuper+F- Toggle fullscreen
Super+Space- Application launcher (Rofi)Super+B- BrowserSuper+E- File manager
Super+T- Theme selectorSuper+Shift+T- Next themeSuper+Shift+Y- Previous themeSuper+W- Wallpaper selectorSuper+Shift+W- Next wallpaper
Print- Selection screenshotSuper+Print- Full screen screenshot
# Check logs
cat /tmp/hypr/$(ls -t /tmp/hypr/ | head -1)/hyprland.log
# Verify deployment
fedpunk module list
# Re-deploy
fedpunk profile deploy [email protected]:hinriksnaer/hyprpunk.git --mode desktop# Verify theme-manager is deployed
fedpunk module info theme-manager
# List available themes
hyprpunk-theme-list
# Check theme symlinks
ls -la ~/.config/hypr/themes/# Check NVIDIA module status
lsmod | grep nvidia
# Re-deploy NVIDIA module
fedpunk module deploy nvidiaContributions welcome! Areas for contribution:
- New themes
- Module improvements
- Bug fixes
- Documentation
See Fedpunk contributing guide
MIT License - See LICENSE file for details
Hyprpunk - A complete Hyprland desktop for Fedpunk
Star this repo if you find it useful!