RoonCommandLine and Roon TUI integration

RoonCommandLine Version 2.1.2, released today, includes support for installation and use of the Roon TUI terminal user interface for Roon. The Roon TUI project is maintained by TheAppgineer organization, authors of the Roon Extension Manager. Roon TUI uses its own developed Rust port of the Roon API.

After installing RoonCommandLine, Roon TUI can be installed with the command roon -I and opened with the command roon -O. The RoonCommandLine menu interface can also be used to install and open roon-tui.

The RoonCommandLine installation of roon-tui installs the binary as ~/.local/bin/roon-tui or /opt/homebrew/bin/roon-tui on macOS.

RoonCommandLine includes a front-end wrapper for roon-tui, installed as /usr/local/Roon/bin/roontui which serves to locate the roon-tui configuration file and log in ~/.config/roon-tui/.

The roon-tui terminal user interface for Roon can be executed either with the wrapper, roontui or with roon -O. Executing roon-tui directly will attempt to use and write the configuration and log files
in the directory where roon-tui is located. Recommended usage is either with roontui or, if no options are required, roon -O.

The roontui wrapper usage message:

Usage: roontui [OPTIONS]
Options:
  -b, --binary <BINARY>     Path to the roon-tui binary
  -c, --config <CONFIG>     Path to the config.json file
  -i, --ip <IP>             IP address of the Server, disables server discovery
  -p, --port <PORT>         Port number of the Server [default: 9330]
  -l, --log <LOG>           Path to the log file
  -v, --verbose             Enable verbose logging to file
  -u, --no-unicode-symbols  Disable the use of Unicode symbols
  -U, --upgrade             Upgrade roon-tui if a newer version is available
  -h, --help                Print help
  -V, --version             Print version

Defaults:
  Binary location:          ~/.local/bin/roon-tui
  Configuration location:   ~/.config/roon-tui/config.json
  Log file location:        ~/.config/roon-tui/roon-tui.log

Roon TUI can be upgraded with the command roontui -U.

See the RoonCommandLine README or RoonCommandLine Release Notes for download and installation instructions.

5 Likes