Rofi script to browse and play YouTube contents
using yt-dlp and mpv

Features · Usage · Run

⭐ Features

• Search history and yt query cache
• Customize script using available flags
• Simple and intuitive rofi menu
  • Play video or audio Alt+v
  • Append to playlist Alt+Tab
  • Loop playlist
  • Edit current playlist Alt+r
  • Save/Load current playlist
  • Help for key bindings Alt+h
  • Jump to chapters Alt+Enter
  • ...

🚀 Setup

Dependencies

• socat sqlite3 xargs jq iconv
• mpv>0.35.1
• rofi>=1.6.1
• yt-dlp[default]==2026.3.17

Opt dependencies

• xclip for copy yt video id in clipboard

Install

Simply make it

git clone https://github.com/andros21/ytdl-mpv
cd ytdl-mpv
make install

🏃 Run

Is advisable to key bind (e.g. Cmd+m) ytdl-mpv, so that rofi menu can be opened wherever you are!
For debugging purposes, instead, could be useful run ytdl-mpv inside a shell to view stdout/stderr