🤖 mechabar

See the assets folder for more preview images.

 🚀 Menus

Wi-Fi

Bluetooth

Power

A mecha-themed Waybar configuration initially designed for Hyprland, but also compatible with Sway¹ and other wlroots-based compositors with minimal adjustments.

Classic vs Animated

You can choose between two (2) styles:

• Classic:

  Clone the main branch (default) for the classic, non-animated bar.

    git clone https://github.com/sejjy/mechabar.git
    cd mechabar

• Animated:

  Clone the animated branch to try the new launch animations.

    git clone -b animated https://github.com/sejjy/mechabar.git
    cd mechabar

Installation (Arch Linux)

Automatic

1. Run the install script:

   ./install.sh

   This backs up existing folders and installs all dependencies, configuration files, and scripts.

Manual

I. Dependencies

sudo pacman -S bluez-utils brightnessctl pipewire pipewire-pulse python ttf-jetbrains-mono-nerd wireplumber

yay -S bluetui rofi-lbonn-wayland-git

Package	Description
bluetui	TUI for managing bluetooth devices
bluez-utils	Development and debugging utilities for the bluetooth protocol stack
brightnessctl	Lightweight brightness control tool
pipewire	Low-latency audio/video router and processor
pipewire-pulse	Low-latency audio/video router and processor - PulseAudio replacement
python	The Python programming language
rofi-lbonn-wayland-git	A window switcher, application launcher and dmenu replacement (fork with Wayland support)
ttf-jetbrains-mono-nerd	Patched font JetBrains Mono from the nerd fonts library
wireplumber	Session/policy manager implementation for PipeWire

Important

If you use alternatives, you may need to modify the scripts and configuration files accordingly.

II. Installation

1. Copy configuration files:

   mkdir -p ~/.config/waybar/
   cp config.jsonc style.css theme.css ~/.config/waybar/

   mkdir -p ~/.config/rofi
   cp rofi/* ~/.config/rofi/

2. Setup scripts:

   mkdir -p ~/.config/waybar/scripts/
   cp scripts/* ~/.config/waybar/scripts/

   chmod +x ~/.config/waybar/scripts/*

3. Restart Waybar to apply the changes:

   killall waybar
   nohup waybar >/dev/null 2>&1 &

Customization

• You can change the colors in theme.css and theme.rasi to match your system theme.
• You can replace existing modules or add new ones from the modules folder. For a complete list of available modules, visit the Waybar Wiki.
• See the instructions in battery-level.sh and battery-state.sh to manually set up battery-related notifications.

Roadmap

Here are some features and improvements planned for future versions:

• Theme switcher
• Style switcher

Credits

• Font icons: ryanoasis / nerd-fonts
• Color palette: catppuccin / catppuccin (Mocha)
• The original files in the modules folder are from prasanthrangan / hyprdots.
• The original versions of battery-level.sh and battery-state.sh are from ericmurphyxyz / dotfiles

Footnotes

1. Waybar configuration guide for Sway:
   https://github.com/Alexays/Waybar/wiki/Module:-Sway ↩