rum-player

Crates.iorum-player
lib.rsrum-player
version0.1.6
sourcesrc
created_at2019-10-27 08:06:57.559132
updated_at2020-02-23 19:48:28.281053
descriptionTUI-based music player
homepage
repositoryhttps://github.com/l4l/rum
max_upload_size
id176074
size130,200
Kitsu (l4l)

documentation

README

RUM Player

Build Status Crates.io

RUM is a terminal music player, that able to play remote media from different sources (currently only Ya.Music).

Usage

Playing media is performed via mpv player, thus it need to be accessible.

cargo install rum-player
# by default installed at ~/.cargo/bin, you may add it to path:
export PATH=$PATH:~/.cargo/bin
rum-player

Currently, the tool has 3 main views: search panel, tracks listing and playlist.

Hotkeys

Hotkeys can be set via toml config, that should be placed at $XDG_CONFIG_HOME for Linux, or at $HOME/Library/Preferences for macOS. All bindings must be specified at [hotkey] table and should be in form (note quotes): "Event" = "Action". Hotkeys might also be specified for a particular view or context (currently only for one at a time) via subtable. If no context specified then hotkey considered as global and will be used with a lower priority. Here is a config example:

[hotkey]
"PointerUp" = "ArrowUp"
"PointerDown" = "ArrowDown"
"NextTrack" = "+"
"PrevTrack" = "-"
"Forward5" = "Ctrl++"
"Backward5" = "Ctrl+-"

[hotkey.search]
"PointerUp" = "ArrowDown"
"PointerDown" = "ArrowUp"

[hotkey.tracklist]
"Enter" = "Alt+0"

Default hotkeys are the following:

  • Arrow Up/Down - scroll up/down displayed list;
  • Arrow Left/Right - switch to previous/next track;
  • Backspace (at track list view) - display back to search panel;
  • Tab - switch between search types (currently track & album search are available);
  • Ctrl+a (at track list view) - add all tracks to playlist;
  • Ctrl+s - stop playback and clear playlist;
  • Ctrl+p - pause/unpause playback;
  • Alt+a (at artist search) - switch to artist albums;
  • Alt+t (at artist search) - switch to artist tracks;
  • Alt+s - switch to related artist(s);
  • Alt+p - switch to playlist view;
  • ] - skip 5 seconds forward of currently played track;
  • [ - skip 5 seconds backward of currently played track;
  • Enter - select item at list view (at track list view append to the end of playlist, rather than replacing it);
  • Ctrl+c/Delete - quit the program.

Development

For development you need a nightly compiler, since dependency requires it: rustup default toolchain nightly. Afterwards you may build sources via cargo build and start hacking. Please also use rustfmt & clippy at development process: rustup component add rustfmt clippy.

Commit count: 98

cargo fmt