Daemon-focused CLI music player in rust, for GNU/Linux only.
- Rust 99.2%
- Shell 0.8%
|
|
||
|---|---|---|
| .zed | ||
| completions | ||
| src | ||
| tests | ||
| .gitignore | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| install.sh | ||
| LICENSE | ||
| README.md | ||
| rsplayer.service | ||
| TODO.md | ||
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-daemonStart the daemonstop-daemonStop the daemonrestartRestart the daemon (kill existing and start new)
these are normal commands:
playPlay a track, album, or artistpausePause playbackresumeResume playbacktoggleToggle play/pausestopStop playbacknextSkip to next trackpreviousSkip to previous trackvolumeSet volume (0-100)shuffleShuffle modequeueQueue managementstatusShow player statusscanScan music paths to populate databasesettingsSettings managementhelpPrint 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