User Guide

Tizonia provides an efficient and unbstrusive music search and listening experience by following a few principles:

Simple CLI UI

The keyboard is faster than the mouse, the goal is to listen to the music in less time. With Tizonia, the music plays almost immediately.

Must play some music, not matter what

Tizonia uses fuzzy string matching techniques to match the search keywords against the data provided by the streaming services. This maximizes the chances of finding the music that the user wants. When a search returns no results Tizonia may try a ‘I’m Feeling Lucky’ guess.

Music never stops

Tizonia’s play queue always runs in looped mode. There is currently no way to configure non-looped playback (although this may be added in the future, see 1).

Limited distractions

No fast-forward or rewind. Only skip to next/previous track (see 2). No elaborate ‘ncurses’ CLI interface to interact with (some people might will see as a downside). Only the track info and a simple visual progress bar.

Reduced ‘muscle-memory’

Finding the music that you want and listening to it should require a single command-line option on the terminal. E.g.: tizonia --spotify-album Islands. Bash and Zsh completions are available. There is also a Oh-my-zsh plugin available here.



There are plans to add an option to disable looped playback:


There are plans to add seeking, useful for long shows and podcasts: