dotfiles/waybar/.github/README.md

🤖 mechabar

A mecha-themed, modular Waybar configuration.

Themes

Catppuccin:

Mocha (default)

Macchiato

Frappe

Latte

Requirements

1. Waybar

Warning

Version 0.14.0 has an issue with wildcard includes. Use the fix/v0.14.0 branch as a temporary workaround.

2. A terminal emulator (default: Kitty)

Important

If you use a different terminal emulator (e.g., Ghostty), you need to replace all instances of kitty with your terminal command:

- "on-click": "kitty -e ..."
+ "on-click": "ghostty -e ..."

Installation

1. Back up your current configuration:

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

2. Clone the repository:

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

   For Waybar v0.14.0:

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

3. Run the install script:

   ~/.config/waybar/install.sh
   

   This makes the 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
   (checkupdates) pacman-contrib	Contributed scripts and tools for pacman systems
   pipewire-pulse	Low-latency audio/video router and processor - PulseAudio replacement
   ttf-0xproto-nerd	Patched font 0xProto from nerd fonts library

Customization

• To change the theme, copy the file with your preferred theme (e.g., catppuccin-latte.css) to theme.css:

  cd ~/.config/waybar
  cp themes/catppuccin-latte.css theme.css
  

Documentation

• Waybar wiki

• Man page:

  man waybar
  

Credits

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