Skip to content

dariogliendo/riz-tui

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Riz TUI

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.

min-rust lic-badge

Overview

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.

Installation

1. Download Binary (Recommended)

You can download the pre-compiled binary for your system from the Releases page.

  1. Download the riz-tui binary.
  2. Grant execution permissions:
    chmod +x riz-tui
  3. Move it to your path (e.g., /usr/local/bin or ~/.local/bin):
    mv riz-tui ~/.local/bin/riz-tui

2. Build from Source

Requires Rust installed.

git clone https://github.com/dliendo/riz-tui.git
cd riz-tui
cargo build --release

The binaries will be located in target/release/:

  • riz-tui: The interactive interface.
  • riz: The command line interface.
  • riz-api: The backend server.

TUI (Interactive Interface)

Riz TUI Screenshot

Launch the interactive dashboard:

riz-tui

Keybindings:

  • 1: 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.

CLI (Command Line)

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.

Examples:

  • Control by IP: riz 192.168.1.50 --on --brightness 50
  • List Scenes: riz --list
  • Check Status: riz 192.168.1.50 --status

Configuration

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

Original Project

This project is built upon the solid foundation of Riz, which provides the core Wiz protocol implementation and API structure.

About

Wiz lights API and CLI

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Rust 96.5%
  • Dockerfile 2.8%
  • Shell 0.7%