https://github.com/wildeyedskies/stmp
subsonic terminal music player
https://github.com/wildeyedskies/stmp
Last synced: 5 months ago
JSON representation
subsonic terminal music player
- Host: GitHub
- URL: https://github.com/wildeyedskies/stmp
- Owner: wildeyedskies
- License: gpl-3.0
- Created: 2020-12-09T08:14:16.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-08-04T23:09:26.000Z (9 months ago)
- Last Synced: 2024-08-08T18:25:41.937Z (9 months ago)
- Language: Go
- Size: 65.4 KB
- Stars: 94
- Watchers: 5
- Forks: 22
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - wildeyedskies/stmp - subsonic terminal music player (others)
README
[](https://aur.archlinux.org/packages/stmp/)
[](https://aur.archlinux.org/packages/stmp-git/)
[](https://github.com/wildeyedskies/stmp/blob/main/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](https://mpv.io)
Go build dependencies
* [tview](https://github.com/rivo/tview)
* [go-mpv](https://github.com/YouROK/go-mpv)
### macOS path setup
#### Homebrew
On macOS, 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
```
#### MacPorts
Alternatively, if you installed mpv with MacPorts, set these paths:
```
export C_INCLUDE_PATH=/opt/local/include:$C_INCLUDE_PATH
export LIBRARY_PATH=/opt/local/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 executable is placed.
### Example configuration
```toml
[auth]
username = 'admin'
password = 'password'
plaintext = true # Use 'legacy' unsalted password auth. (default: false)
[server]
host = 'https://your-subsonic-host.tld'
scrobble = true # Use Subsonic scrobbling for last.fm/ListenBrainz (default: false)
```
## 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)
* s - add 50 random songs to the queue
* y - toggle star on song