🤖 mechabar

Themes

Catppuccin Mocha (Default)

Catppuccin Macchiato

Catppuccin Frappe

Catppuccin Latte

Variants

pac-man (Pac-Man)

Variants also come in 4 themes.

More variants soon!

Requirements

• waybar

  Version 0.14.0 has an issue that breaks modular configs (#31). As a temporary fix, clone the fix/v14 branch instead:

  git clone -b fix/v14 https://github.com/sejjy/mechabar.git ~/.config/waybar

• kitty (optional)

  If you use a different terminal emulator (e.g., ghostty), replace all invocations of kitty with its executable name.

  Example:

  // modules/bluetooth.jsonc:
  "on-click": "ghostty -e ~/.config/waybar/scripts/bluetooth.sh"

Installation

1. Backup your current config:

   mv ~/.config/waybar{,.bak}

2. Clone the repository:

   • Default:

     git clone https://github.com/sejjy/mechabar.git ~/.config/waybar

   • Variant:

     # git clone -b <variant> https://github.com/sejjy/mechabar.git ~/.config/waybar
     # Example:
     git clone -b pac-man https://github.com/sejjy/mechabar.git ~/.config/waybar

3. Run the install script:

   ~/.config/waybar/install.sh

   This makes scripts executable and installs all dependencies listed below:

   Package	Description
   bluez	Daemons for the bluetooth protocol stack
   (bluetoothctl) bluez-utils	Development and debugging utilities for the bluetooth protocol stack
   brightnessctl	Lightweight brightness control tool
   fzf	Command-line fuzzy finder
   (nmcli) networkmanager	Network connection manager and user applications
   pipewire-pulse	Low-latency audio/video router and processor - PulseAudio replacement
   ttf-0xproto-nerd	Patched font 0xProto from nerd fonts library

Tip

To enable battery notifications, see the instructions in battery-state.sh.

Credits

• Font: 0xProto
• Icons: Nerd Fonts
• Themes: Catppuccin