hyprbole - a hyprland config manager TUI written in bash

vlensys — Fri, 06 Mar 2026 09:02:50 +0000

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

or manually:

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

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

DEV Community: vlensys

hyprbole - a hyprland config manager TUI written in bash

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

what it does

what it is

install