A complete configuration for multiple Wayland compositors on Linux desktops
Brokies Land is a ready-to-use configuration designed for Linux users who want a functional and aesthetic desktop environment without spending hours on configuration. It supports multiple Wayland compositors including Hyprland, Niri, and SwayFX, all combined with modern Wayland components and a carefully curated selection of applications and utilities.
✨ Features
- Multiple Compositor Support - Works with Hyprland, Niri, and SwayFX
- Simple Setup - Easy installation and configuration process
- Modern Aesthetic - Clean, minimal interface with thoughtful design
- Performance Focused - Optimized for efficiency on various hardware
- Fully Integrated - All components work together seamlessly
- Customizable - Easy to modify and adapt to your preferences
- 100% Free - Open source and freely available
Configuration Includes
The complete desktop setup includes configuration for:
- Hyprland compositor with multi-monitor support
- Waybar status bar with custom modules
- Notification system with Dunst
- Tofi application launcher
- Hyprlock screen locker
- Wallpaper management with smooth transitions
- Media player controls with visual feedback
- Power management and system monitoring
- Screenshot utilities with various capture options
- Clipboard history management
Core Components
hyprland- Wayland compositorxdg-desktop-portal-hyprland- XDG portal for Hyprland
Interface
waybar- Status bar for showing system informationtofi- Minimal and fast application launcherdunst- Lightweight notification daemon
Terminal & File Management
kitty- Fast, feature-rich GPU-based terminal emulatorghostty- Modern, GPU-accelerated terminal alternativenautilus- GNOME's file manager with Wayland support
System Tools
hyprlock- Secure screen locker for Hyprlandhypridle- Idle management daemonwlogout- Wayland logout menuswww- Efficient wallpaper daemon with smooth transitionsgrimblast- Screenshot utility with built-in editor
Appearance
nwg-look- GTK settings manager for Waylandkvantum- SVG-based Qt theme enginenoto-fonts-cjk- Google Noto CJK fontsbibata-cursor-theme- Modern cursor themefluent-icon-theme-git- Fluent design icon theme- Orchis-theme - Modern GTK theme based on Material Design
Additional Utilities
cliphist- Wayland clipboard managerqt5-wayland&qt6-wayland- Wayland support for Qt applicationspolkit-kde-agent- Authentication agent for system permissionsbrightnessctl- Brightness control utilityplayerctl- Media player controllerpavucontrol- PulseAudio volume controlbluez&bluez-utils- Bluetooth protocol stack and utilitiesjamesdsp- Sound effects processor for PipeWire/PulseAudiognome-clocks- Alarms, timers, and world clock application
Applications
zen-browser- Web browservisual-studio-code- Code editorzed-preview- Alternative code editor
# Install all dependencies with paru
paru -S hyprland xdg-desktop-portal-hyprland qt5-wayland qt6-wayland waybar kitty dunst tofi nautilus polkit-kde-agent swww brightnessctl grimblast-git hyprlock hypridle wleave-git wlogout playerctl pavucontrol cliphist nwg-look kvantum zen-browser-bin visual-studio-code-bin zed-preview-bin noto-fonts-cjk bluez bluez-utils ghostty jamesdsp bibata-cursor-theme fluent-icon-theme-git gnome-clocks# Install Niri (column-based Wayland compositor)
paru -S niri-git
# Install SwayFX (enhanced Sway with visual effects)
paru -S swayfx-gitYou can substitute
paruwithyayif preferred
# Clone the repository
git clone https://github.com/ultimatebrok/brokies_land.git
# Copy configuration files
cp -r brokies_land/.config/* ~/.config/# Start Hyprland (default)
Hyprland# Install Niri first if not already installed
# paru -S niri-git
# Start Niri
niri# Install SwayFX first if not already installed
# paru -S swayfx-git
# Start SwayFX
swayfxHyprland
Hyprland is the primary compositor for Brokies Land with full feature support including:
- Dynamic tiling with dwindle layout
- Smooth animations and rounded corners
- Blur effects and shadows
- Special workspaces feature
- Performance mode script integration
The configuration is extensively documented in .config/hypr/hyprland.conf
Niri
Niri is a modern Wayland compositor with a column-based layout system:
- Simple and predictable window management
- Clean, minimalist approach
- Spring-based animations
- Streamlined configuration with KDL format
The configuration can be found in .config/niri/config.kdl
Note: Some Hyprland-specific features might not be available in Niri due to architectural differences.
SwayFX
SwayFX is an enhanced fork of Sway with additional visual effects:
- Traditional i3-like tiling
- Enhanced blur and visual effects
- Compatibility with most Sway configurations
- Stable and reliable performance
The configuration can be found in .config/sway/config
Note: Keyboard shortcuts may differ slightly from the Hyprland defaults.
Common Shortcuts (Available in all compositors)
| Shortcut | Function |
|---|---|
SUPER + Return |
Open terminal (Ghostty) |
SUPER + E |
Open file manager (Nautilus) |
SUPER + B |
Open browser (Zen Browser) |
SUPER + C |
Open code editor (Zed) |
SUPER + T |
Open Trading View |
SUPER + A |
App launcher (Wofi/Tofi) |
SUPER + Q |
Close active window |
SUPER + F |
Toggle fullscreen |
SUPER + Space |
Toggle floating window |
SUPER + Arrow Keys |
Navigate between windows |
SUPER + SHIFT + Arrow Keys |
Move window in direction |
SUPER + 1-0 |
Switch to workspace |
SUPER + SHIFT + 1-0 |
Move window to workspace |
SUPER + L |
Lock screen |
SUPER + V |
Show clipboard history |
Print |
Screenshot full screen |
CTRL + Escape |
Restart Waybar |
Hyprland-Specific Shortcuts
| Shortcut | Function |
|---|---|
SUPER + S |
Toggle special workspace |
SUPER + SHIFT + S |
Move to special workspace |
SUPER + M |
Exit Hyprland |
SUPER + N |
Change wallpaper |
SUPER + ALT + P |
Toggle performance modes |
SUPER + Print |
Screenshot current output |
SUPER + SHIFT + Print |
Screenshot active window |
SUPER + ALT + Print |
Screenshot selected area |
SUPER + ESCAPE |
Show logout menu |
Niri-Specific Notes
Niri uses a column-based layout system rather than the dynamic tiling of Hyprland.
- Window movement in Niri often moves entire columns of windows
- Niri doesn't have special workspaces like Hyprland
- To exit Niri, use
SUPER + M
Full keybinding details can be found in .config/niri/config.kdl
SwayFX-Specific Notes
SwayFX follows the i3-style keyboard shortcuts with some additions.
- Layout management uses
SUPER + Eto toggle between split layouts - Resize mode can be entered with
SUPER + R - To exit SwayFX, use
SUPER + SHIFT + E
Full keybinding details can be found in .config/sway/config
Brokies Land is designed to be easily customized. Here are some quick customization tips:
- Wallpapers: Add your own wallpapers to
.config/assets/backgrounds - Waybar: Edit
.config/waybar/config.jsoncto modify the status bar - Keybindings: Adjust
.config/hypr/hyprland.conffor custom shortcuts - Notifications: Configure
.config/dunst/dunstrcfor notification appearance - Colors: Most components use Catppuccin Mocha theme colors by default
Contributions are welcome! If you have improvements, configurations, or bug fixes, please feel free to fork the repository and submit a pull request.
MIT License. See LICENSE file for details.
A minimal, efficient Hyprland configuration for Linux enthusiasts