pawbar

A kitten-panel based desktop panel for your desktop

Why?

Due to the existence of modern terminal standards (especially in kitty), a tiny terminal windows support true colors, text-sizing, images, mouse support (clicking, dragging, hover and scrolling), etc. Which makes it a viable option for a status bar, instead of a GUI Toolkits (like GTK). Kitty enables this using its panel mode/kitten, through which it offers all the customization/capabilities of a kitty terminal window but as a status bar on top of your screen.

Installing

A basic install script is there (you need to compile pawbar before running the script):

go build ./cmd/pawbar
./install.sh

Though fair caution it installs to /usr/local/bin

Note

I will add other installation methods when I am satisfied with this project.

Usage

Run bar by calling the bar script after using the install.sh script:

bar

By default the bar is configured with only a clock and a battery. You can add modules by editing $HOME/.config/pawbar/pawbar.yaml.

It has 11 modules with two of them being hyprland specific:

• clock: A simple date-time module (format changable on click)
• battery: A battery module with dynamic icons and colors
• backlight: A screen brightness indicator
• ram: RAM usage
• cpu: CPU usage
• disk: Disk usage (format changable on click)
• locale: Current locale
• hyprws: A dynamic workspace switcher (with mouse events) (change workspace on click)
• hyprtitle: A window class & title display
• space: A single space
• sep: A full height vertical bar and a space on either side

A typical(my) config looks like:

left:
  - hyprws
  - hyprtitle

right:
  - battery
  - space
  - sep
  - space
  - clock

Roadmap

• Running
• Modules and Services:
  • volume (service is done, module remaining)
  • wifi
  • bluetooth
  • tray
  • workspace and title for more WMs
  • Suggest more
• Extended module config
• Extended bar config
• Menu support

Contribution

Project is in very early stages, any contribution is very much appreciated.