https://github.com/wildeyedskies/stmp

subsonic terminal music player
https://github.com/wildeyedskies/stmp

Last synced: 3 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 (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-07-12T06:52:32.000Z (4 months ago)
• Last Synced: 2024-07-14T13:32:49.563Z (4 months ago)
• Language: Go
• Size: 65.4 KB
• Stars: 94
• Watchers: 5
• Forks: 19
• 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

        
[![stmp](https://img.shields.io/aur/version/stmp)](https://aur.archlinux.org/packages/stmp/)

[![stmp-git](https://img.shields.io/aur/version/stmp-git)](https://aur.archlinux.org/packages/stmp-git/)

[![GitHub license](https://img.shields.io/github/license/wildeyedskies/stmp)](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/mpv)

### 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

```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