Download Video (YouTube / Bilibili)

Overview

Use yt-dlp to download videos from YouTube or Bilibili. Downloads go to the user's Videos folder (~/Videos).

Prerequisites

yt-dlp must be installed:

yt-dlp --version

# Install if missing
pip install yt-dlp        # cross-platform
winget install yt-dlp      # Windows
brew install yt-dlp        # macOS
sudo apt install yt-dlp    # Debian/Ubuntu

ffmpeg is recommended for merging video+audio streams.

Download by URL

yt-dlp -o "\x3Cvideos-dir>/%(title)s.%(ext)s" "\x3Curl>"

Replace \x3Cvideos-dir> with the user's Videos folder path, and \x3Curl> with the video URL.

Supported URLs:

• YouTube: https://www.youtube.com/watch?v=... or https://youtu.be/...
• Bilibili: https://www.bilibili.com/video/BV...

Download by Title (search)

# YouTube
yt-dlp -o "\x3Cvideos-dir>/%(title)s.%(ext)s" "ytsearch1:\x3Ctitle>"

# Bilibili
yt-dlp -o "\x3Cvideos-dir>/%(title)s.%(ext)s" "bilisearch1:\x3Ctitle>"

Quick Reference

Common Mistakes

• "ffmpeg not found" — merge of best video+audio fails. Install ffmpeg or use -f best (single stream).
• Bilibili login-required content — add cookies with --cookies-from-browser chrome.
• Videos folder missing — create it first.

Workflow

1. URL given → download directly
2. Title given → use ytsearch1: or bilisearch1: prefix
3. yt-dlp missing → install, then retry
4. Error → read error message, check Common Mistakes above