rs-pug

Neovim out of music players. search, queue, listen — no browser, no ads, no nonsense.

uses mpv and yt-dlp under the hood, with a terminal UI built with ratatui.

dependencies

you'll need:

• mpv
• yt-dlp

optionally mpv-mpris if you want playerctl / media keys support.

installation

from AUR (arch linux):

yay -S rs-pug-git
# or
paru -S rs-pug-git

manually:

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

keybinds

key	action
/	search
Enter	play
a	add to queue
n	next
p	previous
m	mute
Space	pause
r	repeat mode
Tab	switch tab
q	quit

plugins (lua)

drop lua scripts into ~/.config/rs-pug/plugins/ and they'll be loaded automatically. plugins receive events (song start, search results, keypresses) and can modify the app's behavior.

example plugin:

return {
    on_key = function(key, state)
        if key == "char:x" then
            return { flash = "hey!" }
        end
    end
}

configuration

config file is created automatically on first launch at ~/.config/rs-pug/config.toml.

Small, ugly, but there's just something about it

license

MIT