🏠 Brokies Land 🏠

A complete configuration for multiple Wayland compositors on Linux desktops

🎬 See It In Action

Check out this video tour of Brokies Land:

Video_2025-04-11_21-17-51.mp4

🌟 Overview

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

🗂️ Components

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 compositor
• xdg-desktop-portal-hyprland - XDG portal for Hyprland

Interface

• waybar - Status bar for showing system information
• tofi - Minimal and fast application launcher
• dunst - Lightweight notification daemon

Terminal & File Management

• kitty - Fast, feature-rich GPU-based terminal emulator
• ghostty - Modern, GPU-accelerated terminal alternative
• nautilus - GNOME's file manager with Wayland support

System Tools

• hyprlock - Secure screen locker for Hyprland
• hypridle - Idle management daemon
• wlogout - Wayland logout menu
• swww - Efficient wallpaper daemon with smooth transitions
• grimblast - Screenshot utility with built-in editor

Appearance

• nwg-look - GTK settings manager for Wayland
• kvantum - SVG-based Qt theme engine
• noto-fonts-cjk - Google Noto CJK fonts
• bibata-cursor-theme - Modern cursor theme
• fluent-icon-theme-git - Fluent design icon theme
• Orchis-theme - Modern GTK theme based on Material Design

Additional Utilities

• cliphist - Wayland clipboard manager
• qt5-wayland & qt6-wayland - Wayland support for Qt applications
• polkit-kde-agent - Authentication agent for system permissions
• brightnessctl - Brightness control utility
• playerctl - Media player controller
• pavucontrol - PulseAudio volume control
• bluez & bluez-utils - Bluetooth protocol stack and utilities
• jamesdsp - Sound effects processor for PipeWire/PulseAudio
• gnome-clocks - Alarms, timers, and world clock application

Applications

• zen-browser - Web browser
• visual-studio-code - Code editor
• zed-preview - Alternative code editor

Installation Command

# 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

Optional Compositor Packages

# Install Niri (column-based Wayland compositor)
paru -S niri-git

# Install SwayFX (enhanced Sway with visual effects)
paru -S swayfx-git

You can substitute paru with yay if preferred

🚀 Quick Start

# Clone the repository
git clone https://github.com/ultimatebrok/brokies_land.git

# Copy configuration files
cp -r brokies_land/.config/* ~/.config/

Starting Hyprland

# Start Hyprland (default)
Hyprland

Starting Niri

# Install Niri first if not already installed
# paru -S niri-git

# Start Niri
niri

Starting SwayFX

# Install SwayFX first if not already installed
# paru -S swayfx-git

# Start SwayFX
swayfx

🔄 Compositor-Specific Information

Hyprland

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.

⌨️ Keyboard Shortcuts

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 + E to 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

🎨 Customization

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.jsonc to modify the status bar
• Keybindings: Adjust .config/hypr/hyprland.conf for custom shortcuts
• Notifications: Configure .config/dunst/dunstrc for notification appearance
• Colors: Most components use Catppuccin Mocha theme colors by default

💖 Contributing

Contributions are welcome! If you have improvements, configurations, or bug fixes, please feel free to fork the repository and submit a pull request.

📜 License

MIT License. See LICENSE file for details.

---

A minimal, efficient Hyprland configuration for Linux enthusiasts