scrapetubefzf

Search YouTube from the terminal, choose videos using fzf (with thumbnail previews), and play with mpv or download with yt-dlp.

Installation

Clone the repository:

git clone https://github.com/gmou3/scrapetubefzf.git
cd scrapetubefzf

Build package and create symlink in ~/.local/bin/:

make install

Uninstall

Remove package, symlink, and clean up build artifacts:

make uninstall

Usage

usage: scrapetubefzf [-h] [-n N] [-d] [query ...]

Search YouTube from the terminal, choose videos using fzf (with thumbnail previews), and play with mpv or download with yt-dlp.

positional arguments:
  query       search query

options:
  -h, --help  show this help message and exit
  -n N        number of search results to fetch (default: 20)
  -d          run mpv in detached mode (terminal can close)

Tip: within fzf, use the left and right arrow keys to switch between video and channel results.

Requirements

• Python 3.8+
• fzf 0.56.0+
• yt-dlp
• mpv
• One of the following for thumbnails, in fallback order:
  • ueberzugpp (recommended, esp. on X11)
  • kitty (works within kitty and ghostty terminals employing kitten icat)
  • chafa
  • catimg