video-downloader

name	video-downloader
description	Download videos using yt-dlp. Supports quality selection, format conversion, and audio extraction.

Video Downloader

Download videos via yt-dlp with quality, format, and audio-only options.

Goal

Download a video (or extract audio) from a URL to a local directory.

Instructions

Run scripts/download_video.py with the target URL. The script wraps yt-dlp and installs it automatically if missing.

python scripts/download_video.py "<URL>" [options]

CLI Reference

Flag	Values	Default	Effect
-q / --quality	best, 1080p, 720p, 480p, 360p, worst	best	Video resolution cap
-f / --format	mp4, webm, mkv	mp4	Container format (video only)
-a / --audio-only	flag	off	Extract audio as MP3
-o / --output	path	/mnt/user-data/outputs/	Output directory

Constraints

• Single videos only — playlists are skipped by default
• Filename is derived from the video title (not configurable)
• Requires network access and a URL supported by yt-dlp
• Audio extraction (-a) always outputs MP3 regardless of -f