aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 2092f2ae84659b36bad1584a2f3eb4923060228b (plain) (blame)
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# RSPlayer is a daemon driven CLI music player with scrobbling written in rust

## Installation
```
git clone https://codeberg.org/salmonik/RSPlayer.git
cd RSPlayer
./install.sh
```

install.sh will:
compile RSP (make sure you have rust properly installed!)
install shell autocompletions (zsh, bash and fish supported)
install user systemd service and activate it

## Usage

configuration is generated at startup in $XDG_CONFIG_HOME/rsplayer/config.toml
most important values there are:
listenbrainz_token (last.fm scrobbling not yet tested)
display_format (supports $ARTIST $ALBUM and $TRACK)
music_paths (for DB usage, still WIP)
scan_interval (same as above)

all other values can be changed in runtime using commands

as for commands:
RSP will be installed as rsp, in this fragment, rsp will be ommited

these commands should only be used in testing or by systemd service:
`start-daemon`  Start the daemon
`stop-daemon`   Stop the daemon
`restart`       Restart the daemon (kill existing and start new)

these are normal commands:
`play`          Play a track, album, or artist
`pause`         Pause playback
`resume`        Resume playback
`toggle`        Toggle play/pause
`stop`          Stop playback
`next`          Skip to next track
`previous`      Skip to previous track
`volume`        Set volume (0-100)
`shuffle`       Shuffle mode
`queue`         Queue management
`status`        Show player status
`scan`          Scan music paths to populate database
`settings`      Settings management
`help`          Print this message or the help of the given subcommand(s)


## Technical stuff
The main culprit of this player is lack of integration with programs such as playerctl
this is due to the daemon not being asynchronous