README.md

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==2024.11.18

Warning

If your distro doesn't ship mpv==0.36.0
Is sufficient that it ships mpv==0.35.1 with this patch to work with upstream yt-dlp
Otherwise free to remain with mpv<=0.35.1 and yt-dlp==2023.02.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