DEV Community

vlensys
vlensys

Posted on

hyprbole - a hyprland config manager TUI written in bash

I made a terminal UI for managing Hyprland config in pure bash

I got tired of editing my Hyprland config by hand every time I wanted to tweak a keybind or add a window rule, so I built hyprbole — a TUI that lets you manage your config without touching the file directly.

It writes to a separate hyprbole-managed.conf that gets sourced into your main config, so it never touches anything you wrote by hand.

what it does

  • add/edit/delete keybinds, monitors, window rules, workspaces
  • configure general, decoration, animations, input, misc
  • manage autostart and env vars
  • reload Hyprland from inside the TUI
  • backs up before every write

what it is

  • single bash script, ~850 lines
  • no dependencies beyond ncurses
  • works in any terminal
  • on the AUR: yay -S hyprbole

install

yay -S hyprbole
Enter fullscreen mode Exit fullscreen mode

or manually:

git clone https://github.com/vlensys/hyprbole
cd hyprbole
sudo cp hyprbole.sh /usr/local/bin/hyprbole
Enter fullscreen mode Exit fullscreen mode

It's my first tool I've actually published that i took my time on so feedback is welcome.

github: https://github.com/vlensys/hyprbole

Top comments (0)