i made a unique tui player

i made a very cool and unique terminal music player.

its very lightweight 5-6 mb of ram usage and under 1% cpu
it has a lot of cool features like
lua plugin support
10 band eq
music streaming
music from local files
playlists
a lot of themes
nvim keybinds
and a beautiful tui

you can build it from source or download form aur if you use arch linux or any arch based distro.

JustRoccat / rs-pug

terminal music player — mpv + yt-dlp + lua plugins

rs-pug

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

rs-pug uses mpv + yt-dlp under the hood, with a terminal UI built on ratatui.

Features

• YouTube search and queue playback in TUI
• Local files playback from a configurable directory
• Albums tab + playlist library
• 10-band equalizer with presets (Flat, Bass Boost, Vocal Boost, Treble Boost, Night)
• Recently played history (saved to disk)
• Playlist import/export from context menu (c)
• Theme switching + basic keybind customization in Options
• Lua plugin system

Dependencies

Required:

• mpv
• yt-dlp

Optional:

• mpv-mpris (if you want playerctl / media key 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

Default keybinds

Key	Action
/	Search
Enter	Play / confirm
Space	Pause / resume
n	Next
p	Previous

…

View on GitHub