Back to Details

youtube-downloader

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

YouTube Video Downloader

YouTube视频下载工具

Download YouTube videos with full control over quality and format settings.
可完全控制画质和格式设置来下载YouTube视频。

Quick Start

快速开始

The simplest way to download a video:
bash
python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"
This downloads the video in best available quality as MP4 to 
/mnt/user-data/outputs/
.
最简单的视频下载方式：
bash
python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"
此命令会将视频以最佳可用画质的MP4格式下载到
/mnt/user-data/outputs/
目录。

Options

选项

Quality Settings

画质设置

Use 
-q
or 
--quality
to specify video quality:
  • best
    (default): Highest quality available
  • 1080p
    : Full HD
  • 720p
    : HD
  • 480p
    : Standard definition
  • 360p
    : Lower quality
  • worst
    : Lowest quality available
Example:
bash
python scripts/download_video.py "URL" -q 720p
使用
-q
或
--quality
参数指定视频画质：
  • best
    （默认）：可用的最高画质
  • 1080p
    ：全高清
  • 720p
    ：高清
  • 480p
    ：标清
  • 360p
    ：较低画质
  • worst
    ：可用的最低画质
示例：
bash
python scripts/download_video.py "URL" -q 720p

Format Options

格式选项

Use 
-f
or 
--format
to specify output format (video downloads only):
  • mp4
    (default): Most compatible
  • webm
    : Modern format
  • mkv
    : Matroska container
Example:
bash
python scripts/download_video.py "URL" -f webm
使用
-f
或
--format
参数指定输出格式（仅适用于视频下载）：
  • mp4
    （默认）：兼容性最强
  • webm
    ：现代格式
  • mkv
    ：Matroska容器格式
示例：
bash
python scripts/download_video.py "URL" -f webm

Audio Only

仅下载音频

Use 
-a
or 
--audio-only
to download only audio as MP3:
bash
python scripts/download_video.py "URL" -a
使用
-a
或
--audio-only
参数仅下载音频为MP3格式：
bash
python scripts/download_video.py "URL" -a

Custom Output Directory

自定义输出目录

Use 
-o
or 
--output
to specify a different output directory:
bash
python scripts/download_video.py "URL" -o /path/to/directory
使用
-o
或
--output
参数指定不同的输出目录：
bash
python scripts/download_video.py "URL" -o /path/to/directory

Complete Examples

完整示例

  1. Download video in 1080p as MP4:
bash
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
  1. Download audio only as MP3:
bash
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
  1. Download in 720p as WebM to custom directory:
bash
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path
  1. 以1080p画质下载MP4格式视频：
bash
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
  1. 仅下载音频为MP3格式：
bash
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
  1. 以720p画质下载WebM格式视频到自定义目录：
bash
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path

How It Works

工作原理

The skill uses 
yt-dlp
, a robust YouTube downloader that:
  • Automatically installs itself if not present
  • Fetches video information before downloading
  • Selects the best available streams matching your criteria
  • Merges video and audio streams when needed
  • Supports a wide range of YouTube video formats
此工具使用
yt-dlp
——一个功能强大的YouTube下载器，它：
  • 若未安装会自动完成自身安装
  • 下载前获取视频信息
  • 选择符合您条件的最佳可用流
  • 必要时合并视频和音频流
  • 支持多种YouTube视频格式

Important Notes

重要说明

  • Downloads are saved to 
    /mnt/user-data/outputs/
    by default
  • Video filename is automatically generated from the video title
  • The script handles installation of yt-dlp automatically
  • Only single videos are downloaded (playlists are skipped by default)
  • Higher quality videos may take longer to download and use more disk space
  • 下载内容默认保存到
    /mnt/user-data/outputs/
    目录
  • 视频文件名会根据视频标题自动生成
  • 脚本会自动处理yt-dlp的安装
  • 默认仅下载单个视频（播放列表会被跳过）
  • 高画质视频可能需要更长的下载时间并占用更多磁盘空间