🤖 mechabar

 🎨 Themes

Catppuccin

Gruvbox

 🚀 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.

See the sway-classic branch for Sway support.

Classic vs Animated

You can choose between two styles:

• Classic:

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

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

• Animated:

  Clone the animated branch, which includes 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 directories and installs all dependencies, config files, and scripts.

Manual

Dependencies

sudo pacman -S bluez-utils brightnessctl pipewire pipewire-pulse 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
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 other packages, you may need to modify the scripts and config files to match your setup.

Installation

1. Copy config files:

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

   mkdir -p ~/.config/waybar/themes
   cp -r themes/* ~/.config/waybar/themes

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

2. Set up scripts:

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

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

3. Restart Waybar:

   killall waybar; waybar & disown

   Or specify the config paths:

   killall waybar
   waybar --config "$HOME/.config/waybar/config.jsonc" --style "$HOME/.config/waybar/style.css" &
   disown

Customization

• You can switch between predefined css, jsonc, and rasi themes by clicking the leftmost module. To use your own theme, add a file in each directory following its format.

• You can replace modules with ones from the modules folder. For a complete list of available modules, see the Waybar Wiki.

• To change the bar height manually, see the notes in style.css

• To set up battery notifications, follow the instructions in battery-level.sh and battery-state.sh.

Roadmap

Here are some features and improvements planned for future versions:

• Add Sway support
• Theme switcher
• Style switcher
• Add more themes

Credits

• Font icons: ryanoasis / nerd-fonts
• Color palette: catppuccin / catppuccin, morhetz / gruvbox
• 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
• Special thanks to JustLap for helping me organize font sizes into a dedicated section.

Footnotes

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