blob: 59d06e5081a1f278b7eaff0ff0db26c70245706f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
|
# termsonic - a TUI Subsonic client [(latest release)](https://git.sixfoisneuf.fr/releases/termsonic/latest/)
This project implements a terminal-based client for any [Subsonic](https://www.subsonic.org)-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](.screenshots/mainscreen.png)
## Building
This application requires [Go](https://go.dev) 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](https://github.com/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](config.toml.example), and [the TOML reference](https://toml.io/en/). 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](mailto:bugs+termsonic@sixfoisneuf.fr). I'll gladly accept patches, as long as they follow the [git-send-email](https://git-send-email.io) format.
|