🤖 mechabar

A customizable, modular Waybar configuration

Themes

Catppuccin Mocha (default)

Catppuccin Macchiato

Catppuccin Frappe

Catppuccin Latte

Requirements

1. waybar

2. A terminal emulator (default: kitty)

   If you use a different terminal emulator, see the Configuration section below.

Installation

1. Back up your current Waybar configuration:

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

2. Clone the repository:

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

3. Install the dependencies and restart Waybar:

   ~/.config/waybar/install

   Dependencies (7)

   Package	Command	Description
   bluez-utils	bluetoothctl	Development and debugging utilities for the bluetooth protocol stack
   brightnessctl	brightnessctl	Lightweight brightness control tool
   fzf	fzf	Command-line fuzzy finder
   libnotify	notify-send	Library for sending desktop notifications
   networkmanager	nmcli	Network connection manager and user applications
   pacman-contrib	checkupdates	Contributed scripts and tools for pacman systems

   Optional:

   Package	Description
   otf-commit-mono-nerd	Patched font Commit Mono from nerd fonts library

   If you prefer a different font, see the Configuration section below.

Configuration

Terminal

If you use a different terminal emulator, replace every instance of kitty in the module files. For example:

// ~/.config/waybar/modules/custom/power.jsonc

"custom/power": {
	// "on-click": "kitty -e ~/.config/waybar/scripts/power",
	"on-click": "ghostty -e ~/.config/waybar/scripts/power",
}

Fonts

Different fonts render characters in different sizes, which can affect the layout. Import your preferred font file from the fonts directory to style.css. For example:

/* @import "styles/fonts/commit-mono.css"; */
@import "styles/fonts/jetbrains-mono.css";

Themes

To change the theme, import your preferred theme file from the themes directory to style.css. For example:

/* @import "styles/themes/catppuccin-mocha.css"; */
@import "styles/themes/catppuccin-latte.css";

Icons

You can search for icons on Nerd Fonts: Cheat Sheet ↗. For example:

gentoo

Matches: nf-dev-gentoo, nf-linux-gentoo, nf-md-gentoo*

*Most modules use Material Design Icons (nf-md-*) for consistency.

Custom module

The leftmost module has no default function and is left for you to configure. For example:

// ~/.config/waybar/modules/custom/user.jsonc

"custom/user": {
	"on-click": "/path/to/your/script", // Run your own script
	"on-click-right": "pkill -SIGUSR2 waybar", // Restart Waybar
}

References

• Waybar wiki
• Nerd Fonts wiki: Glyph Sets