Reference youtube download

scripts/forge_youtube_download.py <url> [--quality 1080|1440|2160|best] [--out DIR] [--no-notify]

  • Default: 1080p cap, /mnt/workspace/Assets/YouTube/, notifies ON via forge_notify.sh (info -> @forge_notify_outbound_bot Telegram).
  • Progress messages at start, 25/50/75% milestones, completion with final path; failure sends a warning notify with last yt-dlp output line.
  • Idempotent: yt-dlp resumes partials / skips finished; same command twice = same end state.
  • Container note: <=1080p YouTube is h264 (mp4); 1440p/4K is VP9/AV1 so output lands as webm/mkv. Premiere may need a remux/transcode for those.
  • yt-dlp binary: ~/.local/bin/yt-dlp (pip --user under /usr/bin/python3; update with pip install -U --user --break-system-packages yt-dlp). Keep fresh, it ages badly.
  • Long downloads from a bot/session: run in background (run_in_background or tmux); notifies carry the progress, no babysitting needed.
  • Output template: <title> [<id>].<ext> inside --out. Related: [[reference_watchyoutube]] uses yt-dlp for captions/frames, separate path.

Smoke-tested 2026-06-10 (360p test video, notify + no-notify paths). [Claude Code]