#lang #tui #sonos #language #sonos-controller

app sinuous

A simple TUI for controlling local Sonos speakers

5 releases

0.1.4 Sep 17, 2023
0.1.3 May 18, 2022
0.1.2 Mar 25, 2022
0.1.1 Mar 25, 2022
0.1.0 Mar 25, 2022

#156 in Graphics APIs

MIT license

579 lines


dependency status CI

Sinuous is a simple TUI for controlling local Sonos speakers.

It currently allows you to cycle through the different groups (zone players), displays the current track, and the current queue.

Note: sinuous directly talks to the Sonos speakers via their local upnp interface, and the speakers are discovered via the SSDP protocol. This means your Sonos speakers need to be on the same network (or visible from your current network).

Key bindings

  • Space: Play / Pause
  • p / n: Skip to previous / next track
  • [ / ]: Adjust volume of the coordinator of the current group
  • Shift+Tab / Tab: Switch to previous / next group
  • q: Quit

To run

Install a recent Rust toolchain via rustup, if you don't already have one, then simply run cargo run.

To get debug logs, run RUST_LOG="sinuous=debug" cargo run. The logs can be found in /tmp/sinuous.log.




  • Allow switching between speakers
  • Support more actions (seek forward, backward, change playing mode, volume...)
  • Display play/pause indicator as well as current play mode (shuffle+repeat)
  • Allow searching for tracks and modify the queue
  • Allow customizing colours
  • Allow specifying speaker to connect to as a command line argument
  • Handle grouping of speakers


~400K SLoC