Skip to content

4. Components

Jump to bottom
BeetleBot edited this page Mar 26, 2026 · 1 revision

BrewLand Wiki: Component Guides

BrewLand consists of several tightly integrated components. This guide provides a technical overview of how each one is configured and how they interact.

1. Hyprland (The Compositor)

Hyprland is modularized for clarity and ease of maintenance. The main configuration (hyprland.conf) simply sources smaller configuration files from the HLconfigs/ directory.

Directory Structure: ~/.config/hypr/HLconfigs/

File Responsibility
autostart.conf Launched on startup (Waybar, SwayNC, hypridle, etc.)
env.conf Environment variables (GTK_THEME, QT_QPA_PLATFORM, etc.)
input.conf Keyboard layout, mouse sensitivity, and touch settings.
keybindings.conf The master list of all keyboard and mouse shortcuts.
lookandfeel.conf Visual settings: Borders, Gaps, Rounding, Animations, and Blur.
monitors.conf Screen resolution, refresh rate, and positioning.
myprograms.conf Default application definitions ($terminal, $fileManager, etc.)
windowsandworkspaces.conf Floating rules, layer rules (for blur), and workspace assignments.
theme-colors.conf A dynamic link to the current Catppuccin flavor (Mocha or Latte).

2. Waybar (The Status Bar)

Waybar is the central hub for system information. It uses a clean JSONC configuration and custom CSS.

Custom Modules

  • custom/start: A stylized Arch logo that opens the Rofi drun menu.
  • custom/logo: A notification icon that toggles SwayNC. Middle-clicking toggles 'Do Not Disturb'.
  • custom/pomodoro: Integrates with the pomodoro.sh script to show a timer in the bar.
  • group/hardware: A compact, expandable drawer containing volume, backlight, battery, and network status.

3. Rofi (The Command Center)

Rofi acts as both an application launcher and a powerful script runner. BrewLand uses a custom Rofi configuration with specialized sub-menus.

Specialized Menus (~/.config/rofi/scripts/)

  • Clipboard Manager: Powered by cliphist.
  • Emoji Picker: Powered by rofimoji.
  • Wallpaper Switcher: A visual grid to change backgrounds using awww.
  • Music Menu: Controls playerctl and mpd.
  • Package Menu: A GUI for system updates and package management.
  • Audio Switcher: Quickly switch between input and output devices.

4. SwayNC (The Notification Center)

SwayNC handles all system notifications and provides a control center sidebar.

  • Style: Matches the Catppuccin theme.
  • Functionality: Accessible via the notification icon in Waybar or $mainMod+N (if configured).
  • Interaction: Click to dismiss, right-click for actions, or use the "Clear All" button in the sidebar.

Maintained by BeetleBot.

Clone this wiki locally