~ser/stmp

Subsonic Terminal Music Player, a TUI client for Subsonic-API servers like gonic and Navidrome
Clean out logging -- report only errrors. We'll put these back in if we add a "verbose" option.
Clear out directory cache on artist refresh, to make sure artist directories get updated.
The rebase lost something.

clone

read-only
https://git.sr.ht/~ser/stmp
read/write
git@git.sr.ht:~ser/stmp

You can also use your local clone with git send-email.

stmp stmp-git GitHub license

#STMP (subsonic terminal music player)

A terminal client for *sonic music servers. Inspired by ncmpcpp.

#Features

  • browse by folder
  • queue songs and albums
  • volume control

#Dependencies

  • libmpv-dev (build)
  • mpv

Go build dependencies

#OSX path setup

On OSX if you installed mpv with brew you'll need to set the following paths

export C_INCLUDE_PATH=/opt/homebrew/include:$C_INCLUDE_PATH
export LIBRARY_PATH=/opt/homebrew/lib:$LIBRARY_PATH

#Compiling

stmp should compile normally with go build. Cgo is needed for linking the libmpv header.

#Configuration

stmp looks for a config file called stmp.toml in either $HOME/.config/stmp or the directory in which the executible is placed.

#Example configuration

[auth]
username = 'admin'
password = 'password'

[server]
host = 'https://your-subsonic-host.tld'

#Usage

  • 1 - folder view
  • 2 - queue view
  • 3 - playlist view
  • 4 - log (errors, etc) view
  • enter - play song (clears current queue)
  • d/delete - remove currently selected song from the queue
  • D - remove all songs from queue
  • a - add album or song to queue
  • p - play/pause
  • -/= volume down/volume up
  • / - Search artists
  • n - Continue search forward
  • N - Continue search backwards
  • r - refresh the list (if in artist directory, only refreshes that artist)