1
0
Fork
You've already forked termsonic
0
No description
  • Go 97.9%
  • Nix 2.1%
2025年11月07日 11:58:02 +00:00
.screenshots Add screenshot 2022年12月11日 12:18:16 +01:00
cmd/termsonic create cmd/termsonic subdir 2023年12月17日 13:01:16 +01:00
music add MPRIS2 support 2025年01月04日 16:47:49 +01:00
src remove artist/album references/assumptions 2025年11月07日 11:58:02 +00:00
.gitignore add nix flake 2024年12月18日 17:06:33 +01:00
config.toml.example folder ignore depth setting 2025年11月07日 10:58:55 +00:00
flake.lock add nix flake 2024年12月18日 17:06:33 +01:00
flake.nix add nix flake 2024年12月18日 17:06:33 +01:00
go.mod add MPRIS2 support 2025年01月04日 16:47:49 +01:00
go.sum add MPRIS2 support 2025年01月04日 16:47:49 +01:00
LICENSE Add license file (GPLv3) 2022年12月11日 12:24:54 +01:00
README.md Add 'yay' example for Archlinux, mention Russ as OpenBSD package maintainer 2025年01月07日 10:32:26 +01:00
shell.nix add nix flake 2024年12月18日 17:06:33 +01:00
termsonic.nix add nix flake 2024年12月18日 17:06:33 +01:00

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

Installing

Termsonic is currently packaged and readily available for the following operating systems:

OpenBSD

# pkg_add termsonic

The OpenBSD package is maintained by Russ Sharek.

NixOS

$ nix-shell -p termsonic

Archlinux

Termsonic is available in the Archlinux User Repository (AUR), under the termsonic-git package name. You can install it manually, or using one of the many AUR helpers.

$ yay -S termsonic-git

Other Linux, Windows

If Termsonic isn't packaged for your distribution, you can download the latest release and run it directly.

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.