GitHub X (Twitter) LinkedIn
← All projects
Python & CLI

vidPhen

An interactive terminal downloader for videos, playlists and subtitles, wrapping yt-dlp and ffmpeg with menus built from the formats each link actually offers.

RoleDesign + Build StatusOpen source TypeCLI tool
vidPhen terminal menu and download outputs

Overview

yt-dlp is powerful, but its flag surface is enormous. vidPhen turns the common jobs into a menu: paste one or many links, preview titles and durations, pick quality and subtitles from the formats the link actually exposes, then download. It remembers your folder and checks Python, yt-dlp and ffmpeg before the first run.

vidphen 1) Download videos -> quality -> subtitles -> folder 2) Download playlists -> scope E / R / S -> batch options 3) Download subtitles -> language -> .vtt / .srt 4) Settings -> folder, config, yt-dlp update

Key features

  • Three flowsVideos, playlists, or subtitles only, with no flags to memorise.
  • Dynamic menusQuality and subtitle choices are built from the extracted formats, not a fixed list.
  • Batch controlSame for all or pick per video, with playlist ranges such as 2 to 19.
  • Preview firstTitles, durations and playlist counts before anything downloads.
  • After the runOpen the download folder or the file that just finished.
  • Doctor + updatesStartup dependency check and a single step yt-dlp update.

How it works

  1. Install with pip install -e . (or straight from GitHub).
  2. Run vidphen; the first launch asks for a download folder and checks the toolchain.
  3. Pick a flow, paste one URL per line, confirm the preview, then choose quality and subtitles.
git clone https://github.com/PhenPen/vidPhen.git cd vidPhen pip install -e . vidphen # ffmpeg is only needed for merges (1080p+) and audio converts winget install Gyan.FFmpeg # Windows brew install ffmpeg # macOS

Stack

Python 3.9+ yt-dlp ffmpeg stdlib

Have a project in mind?

Email me
Have a project? Let's talk