ulanzi-studio-niri

Linux daemon for the Ulanzi Stream Controller D200X, with Niri integration.

Bind buttons and encoders to desktop actions, commands, media controls, keystrokes, and pages. Display clocks, system stats, AI usage, and coding-agent session counts.

Quick start

Requires Python 3.11+. Install with uv:

uv tool install ulanzi-studio-niri
ulanzi-niri setup
sudo ~/.local/bin/ulanzi-niri admin-setup

setup creates the example config and starts a systemd user service, preserving existing config. admin-setup installs USB permissions; adjust the executable path if needed and replug the device afterward. Without systemd, run ulanzi-niri run manually. See installation details for pip installation and setup options.

Edit ~/.config/ulanzi-niri/config.toml using the example config. Install the external tools used by your actions (such as niri, playerctl, or wtype); icons are not bundled.

ulanzi-niri doctor                 # check your environment
ulanzi-niri control next-page      # control the running daemon
ulanzi-niri ai-usage --json         # read cached usage
ulanzi-niri agent-status --json     # read cached agent counts

Documentation

• Configuration, pages, and icons
• AI usage widgets · Agent status
• Keyboard control
• D200X inputs · AU05 keepalive
• Releases · Changelog

Development

uv sync
uv run pytest
uv run ruff check .

See the development guide for local installation and hardware diagnostics.

Protocol details adapted from redphx/strmdck.