视频下载器

使用 yt-dlp 从几乎任何网站下载视频。

支持的网站

YouTube、Reddit、Twitter/X、TikTok、Instagram、Vimeo、Facebook、Twitch，以及 1000+ 其他网站。完整列表：https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md

使用方法

快速下载（最高画质）

{baseDir}/scripts/download.sh "URL"

以最佳画质下载至 ~/Downloads/videos/ 目录。

带参数下载

{baseDir}/scripts/download.sh "URL" [OPTIONS]

常用参数：

• --audio-only — 仅提取音频（输出为 mp3）
• --720p — 限制最高分辨率为 720p
• --1080p — 限制最高分辨率为 1080p
• --output DIR — 自定义输出目录
• --filename NAME — 自定义文件名（不含扩展名）

示例

# 下载 YouTube 视频（最高画质）
{baseDir}/scripts/download.sh "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# 下载 Reddit 视频
{baseDir}/scripts/download.sh "https://www.reddit.com/r/videos/comments/abc123/cool_video/"

# 仅提取音频
{baseDir}/scripts/download.sh "https://www.youtube.com/watch?v=dQw4w9WgXcQ" --audio-only

# 下载至指定文件夹
{baseDir}/scripts/download.sh "URL" --output ~/Videos/projects

# 自定义文件名
{baseDir}/scripts/download.sh "URL" --filename "my-video"

输出说明

• 默认保存路径：~/Downloads/videos/
• 文件命名格式：{title}-{id}.{ext}
• 成功时返回已下载文件的完整路径

注意事项

• Reddit 视频需合并音视频流（脚本已自动处理）
• 受年龄限制的 YouTube 视频可能需要 cookies（当前未配置）
• 超长视频下载耗时较长；脚本会显示进度
• 若下载失败，请检查目标网站是否在支持列表中，或该视频是否为私有/已被删除

发送至 Telegram

Telegram 对单文件大小限制为 16MB，大体积视频需先压缩。对于长时间视频：

1. 先正常下载视频
2. 后台运行压缩并发送脚本：

   nohup {baseDir}/scripts/compress-and-send.sh "/path/to/video.mp4" "CHAT_ID" > /tmp/compress.log 2>&1 &
   

3. 等待约「视频时长 ÷ 4」后回来查看结果
4. 发送生成的 -telegram.mp4 文件

此方式可避免在聊天窗口中频繁刷屏显示进度信息。

直接调用 yt-dlp

如需高级功能，可直接使用 yt-dlp：路径为 ~/.local/bin/yt-dlp（已更新）或 /usr/bin/yt-dlp。运行 yt-dlp --help 查看全部参数说明。