rs-pug 0.1.3

Blazing fast tui music player
rs-pug-0.1.3 is not a library.

dependency status

rs-pug

No browser, no ads, no Electron. Search YouTube and SoundCloud, queue tracks, play local files โ€” all from your terminal.

Built in Rust with mpv, yt-dlp, and ratatui. Requires mpv and yt-dlp installed.

Plugins, themes and EQ presets from the community: all-rspug ยท Discord

img img

Installation

# Arch
yay -S rs-pug-git

# crates.io
cargo install rs-pug

# manual
git clone https://github.com/JustRoccat/rs-pug && cd rs-pug
cargo build --release && ./target/release/rs-pug

Dependencies

Required:

  • mpv
  • yt-dlp

Optional:

  • mpv-mpris (for media key / playerctl support)

Keybinds

Key Action
1โ€“5 Switch tabs
Tab Switch panel focus
j / k Move up / down
/ Search
Enter Play
Space Pause / Resume
n / p Next / Previous
m Mute
r Cycle repeat mode
c Context menu
v Toggle flat/organized view (Local tab)
q Quit

Contri-pug-ting

  1. Fork the repo
  2. Install dependencies
  3. Smash your head against the keyboard (Rust can be like that)
  4. Open a pull request

Lua plugin PRs especially welcome โ€” API reference in docs.md.

License

MIT

gif