nvibrant-tui 0.1.0

TUI for configuring Nvidia Digital Vibrance on Wayland

nvibrant-tui

Control NVIDIA Digital Vibrance from your terminal — per display, with sliders, and persistent across reboots.

No more commands on every login. Set it once, enable autostart, and forget about it.

---

Install

pipx install nvibrant-tui

Then run:

nvibrant-tui

Your displays show up as sliders. Drag them or use the keyboard, hit Apply, and your settings are saved. Next login they'll be right where you left them — or enable Autostart and they'll be applied automatically before you even open the TUI.

Using pip instead of pipx?

pip install nvibrant-tui

---

Controls

Key	Action
← / →	±1
Shift+← / Shift+→	±64
0	Reset this display to 0
Ctrl+S	Apply
a	Toggle auto-apply
l	Link all displays
b	Toggle autostart
Ctrl+Q	Quit

Auto-apply pushes changes to the driver as you move the slider, with a short debounce so it doesn't spam it on every tick.

Link all ties all displays together so one slider moves them all — useful if you want a uniform look across monitors.

---

How settings are saved

Values are written to ~/.config/nvibrant-tui/config.json only after nvibrant confirms the apply succeeded. You'll never end up with a saved state that wasn't actually applied.

Autostart installs ~/.config/systemd/user/nvibrant.service — a one-shot service that fires after your graphical session starts. If you update your GPU driver or reinstall nvibrant, toggle Autostart off and on again to regenerate it pointing to the new binary.

---

Requirements

• NVIDIA GPU with a working driver
• Wayland session
• Python 3.10+
• systemd user session (only needed for Autostart)

---

Development

git clone https://github.com/enrialonso/nvibrant-tui
cd nvibrant-tui
python -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/nvibrant-tui

.venv/bin/pytest

---

License

GPL-3.0 — see LICENSE.