Interactive TUI for controlling Wiz lights
This is a fork of the original riz-cli package by user a-tal.
Note: If you are looking for the CLI version specifically, you probably want the original package.
Riz TUI provides a powerful Terminal User Interface to manage and control Wiz smart bulbs. It allows you to organize lights into rooms and adjust settings like brightness, temperature, and colors interactively.
You can download the pre-compiled binary for your system from the Releases page.
- Download the
riz-tuibinary. - Grant execution permissions:
chmod +x riz-tui
- Move it to your path (e.g.,
/usr/local/binor~/.local/bin):mv riz-tui ~/.local/bin/riz-tui
Requires Rust installed.
git clone https://github.com/dliendo/riz-tui.git
cd riz-tui
cargo build --releaseThe binaries will be located in target/release/:
riz-tui: The interactive interface.riz: The command line interface.riz-api: The backend server.
Launch the interactive dashboard:
riz-tui1: Focus Rooms & Lights panel.2: Focus Controls panel.Tab: Switch between panels.j/k(or arrows): Navigate lists / properties.h/l(or arrows): Adjust Sliders (Brightness/Temp).Enter: Toggle power (in sidebar) or open selector (in controls).r: Create a new Room.l: Add a new Light to the selected room.q: Quit.
Tip
If you are looking for the CLI version specifically, you probably want the original package.
To use the CLI, simply provide the IP address(es) of your bulb(s) followed by the desired options.
- Control by IP:
riz 192.168.1.50 --on --brightness 50 - List Scenes:
riz --list - Check Status:
riz 192.168.1.50 --status
| Env Var | Default | Description |
|---|---|---|
RIZ_PORT |
8080 | API listening port |
RIZ_STORAGE_PATH |
. | Path to storage (rooms.json must be writable by running UID) |
RIZ_CORS_ORIGIN |
http://localhost:8000 | Allowed CORS origin |
This project is built upon the solid foundation of Riz, which provides the core Wiz protocol implementation and API structure.