termsonic - a TUI Subsonic client (latest release)

This project implements a terminal-based client for any Subsonic-compatible server.

It currently supports the following:

Browsing of Subsonic library organised by Artists and Albums
Playback of OGG, FLAC and MP3 files
Playlist support
Play queue management

screenshot

Building

This application requires Go version 1.19 at minimum.

$ git clone https://git.sixfoisneuf.fr/termsonic && cd termsonic
$ go build ./cmd/termsonic/

Linux notes

Please note that Linux builds additionally need a working C compiler in their PATH. This is due to faiface/beep, used for audio playback.

You will also need the ALSA development libraries for your system. On Debian, this is libasound2-dev.

Configuration

The application reads its configuration from $XDG_CONFIG_DIR/termsonic.toml, or ~/.config/termsonic.toml if XDG_CONFIG_DIR doesn't exist.

On Windows, it reads its configuration from %APPDATA%\\Termsonic\\termsonic.toml.

You can edit the configuration from inside the app, or by hand using a text editor. See the example configuration file, and the TOML reference. It is possible to specify another configuration file with the -config command-line argument.

Reporting bugs

Please report any bug you find to bugs+termsonic@sixfoisneuf.fr. I'll gladly accept patches, as long as they follow the git-send-email format.