BrewLand v2.0

A refined Hyprland configuration centered around the Catppuccin Mocha and Latte palettes. BrewLand prioritizes a minimalist workflow, smooth animations, and consistent system-wide aesthetics.

Important

We have migrated our configuration to Hyprland Lua, providing compatibility with Hyprland 0.55 and later versions.

Core Concepts

• Dynamic Theming: Swap between Mocha (Dark) and Latte (Light) on-the-fly. The system-wide colors are controlled by brewland/themes/colors.json.
• Workflow: Optimized for a scrolling-stack layout with a dedicated "Magic Shelf" (special workspace) for background tasks.
• Modularity: Configurations for Hyprland, Waybar, and SwayNC are split into logical modules for easy modification.

Installation

Remote Install (Recommended)

This clones the repository to ~/BrewLand, records the installation path for future updates, and launches the installer.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/BeetleBot/BrewLand/main/setup.sh)"

Manual Install

git clone https://github.com/BeetleBot/BrewLand.git
cd BrewLand && ./install.sh

Essential Keybindings

Key	Action
Super + Return	Terminal (Kitty)
Super + Space	App Launcher (Rofi)
Super + Shift + Z	Toggle Theme (Dark/Light)
Super + Shift + P	Package & Update Menu
Super + S	Toggle Magic Shelf
Super + R	Reload UI (Waybar/SwayNC)
Super + Q	Close Active Window

Full keybinds are defined in hypr/hyprland.lua.

System Management

Updating

BrewLand can be updated directly from the UI:

1. Open the Package Menu (Super + Shift + P).
2. Select UPDATE PACKAGES -> BREWLAND. This will pull the latest code and re-apply configurations automatically.

Health Check

If you experience issues, run the verification tool:

./brewland/brewland-doctor.sh

It verifies package dependencies, configuration symlinks, and the status of background services.

Customization

• Main Configuration: hypr/hyprland.lua
• Bar Layout: waybar/config.jsonc
• Global Colors: brewland/themes/colors.json

---

Maintained by BeetleBot.