sagi/subsonic-tui
sagi/subsonic-tui
1
2
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A subsonic client and player for the CLI lovers
7 commits 1 branch 0 tags 44 MiB
Go 98.2%
Makefile 1.8%
Find a file
Sagi Dayan ca8437e3ca
Added basic "build" test for sanity 
Signed-off-by: Sagi Dayan <sagidayan@gmail.com>
2024-12-15 12:35:20 +02:00
.forgejo/workflows Added basic "build" test for sanity 2024-12-15 12:35:20 +02:00
assets initial commit 2024-12-14 23:37:05 +02:00
internal initial commit 2024-12-14 23:37:05 +02:00
.gitignore initial commit 2024-12-14 23:37:05 +02:00
.golangci.yml initial commit 2024-12-14 23:37:05 +02:00
go.mod Update module github.com/gopxl/beep to v2 2024-12-15 09:09:25 +00:00
go.sum Update module github.com/gopxl/beep to v2 2024-12-15 09:09:25 +00:00
LICENSE initial commit 2024-12-14 23:37:05 +02:00
main.go initial commit 2024-12-14 23:37:05 +02:00
Makefile Added basic "build" test for sanity 2024-12-15 12:35:20 +02:00
README.md initial commit 2024-12-14 23:37:05 +02:00
renovate.json initial commit 2024-12-14 23:37:05 +02:00

README.md

Subsonic TUI

NOTE ⚠ !!: This is under heavy development! Do not fork just yet. Im still force pushing to main!

A Subsonic client and player written in go.

subsonictui (Name in progress) is a simple and easy to use player for Linux, Mac and (yes...) Windows.

Screenshot Screenshot mini player

Note: Screenshots blurred for (I dont know) copyright issues?

Features

  • Browse Artists/Albums/Playlists
  • Artist view
  • Playlist view
  • Miniplayer on small screen
  • Album view
  • Search
  • Playback
    • Scrobble (configurable)
    • Play album
    • Shuffle album
    • Add album to queue
    • Add song to queue
    • Play Next/Prev
    • Stop/Pause
  • Generate artist radio
  • Generate song radio
  • [-] Desktop integration
    • Linux (MPRIS)
    • Windows
    • MacOS
  • Playlist management
    • Add song to playlist
    • Create playlist from queue

Keybindings

Key(s) Action
` Focus on Main pane
1 Focus on Atrists pane
2 Focus on Albums pane
3 Focus on Playlists pane
4 Focus on Queue pane
Arrow keys or h j k l Navigation in a pane. Shift for switching panes
g Jump to first item in a list of a pane
G Jump to last item in a list of a pane
n Next song
N Prev song
q Exit
r While on a song - Start Song radio
s Playback - Stop
p Playback - Toggle Play/Pause
c Stop, clear queue
/ Search
? Help

Config

subsonictui stores a config file at:

  • Linux: $HOME/.config/subsonictui/config.yaml
  • macOS: $HOME/Library/Application Support/subsonictui/config.yaml
  • Windows: C:\\Users\%USER%\AppData\Roaming\subsonictui\config.yaml

Development

Build Dependencies

subsonictui uses Beep, that uses OTO under the hood, so you will need OTO dependencies. Mainly on Linux you will need alsa-devel.

To Build the project:

$ make build

Special Thanks

subsonictui is built on top of a few projects. I would like to thank them here

Thank you for creating wondeful software that everyone can use. Including myself.