Skip to content

sejjy/mechabar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

216 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 mechabar

A mecha-themed, modular Waybar configuration

Preview
Themes

Catppuccin:

Mocha (default)
Catppuccin Mocha
Macchiato
Catppuccin Macchiato
Frappe
Catppuccin Frappe
Latte
Catppuccin Latte

Feel free to open a pull request to add new themes! :^)

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 (6)
    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
    networkmanager nmcli Network connection manager and user applications
    pacman-contrib checkupdates Contributed scripts and tools for pacman systems
    otf-commit-mono-nerd Patched font Commit Mono from nerd fonts library

Configuration

Terminal emulator

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

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

Theme

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

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

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": {
	// Run your own script
	"on-click": "/path/to/your/script",
	// Restart Waybar
	"on-click-right": "pkill -SIGUSR2 waybar",
}

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.

References

About

A mecha-themed, modular Waybar configuration

Topics

Resources

License

Stars

852 stars

Watchers

12 watching

Forks

Contributors