It can be used to query and control a Volumio host either programmatically as an importable library from Python code, or on the command line through its CLI tool with the same name, volumito; I added examples and guides in the documentation, see the README in the GitHub repository, which contains the links to them. (As a new user, I cannot add more than two links…)
In the current release (v0.1.0), only the MPD and REST APIs of Volumio are wrapped, but I plan to add an asynchronous version of the library and WebSocket support in the next releases. (See the docs/ROADMAP.md file in the GitHub repository for details.)
I consider the current release as fully usable — at this point, I have been using it for weeks to manage my personal Volumio hosts — feedback is welcomed either here or via a GitHub Issue.
Today (2026-09-04) I published v0.4.0 of the volumito PyPI package, providing synchronous and asynchronous clients for the Volumio REST and WebSocket APIs, and a global option for the CLI tool to select the desired client.
To keep dependencies at a minimum, the default pip install volumito will provide the default synchronous REST API client only, but there are extras to install the other three:
pip install volumito[async] for the async REST API client;
pip install volumito[websocket] for the sync WebSocket API client;
pip install volumito[async_websocket] for the async WebSocket API client.
If you do not care about installing additional dependencies, the all extra installs them all:
Today (2026-09-10) I published v0.5.0 of the volumito PyPI package.
This version delivers:
a global option to select the type of client (synchronous|asynchronous)_(rest|websocket) the CLI tool should use;
new commands and command groups on the CLI tool volumito, covering most of the additional functionalities that the WebSocket API of Volumio offers with respect to the REST API;
fixed several methods of the WebSocket clients that were not implemented correctly.