videodl

项目概述

VideoDL（安装包名 videofetch）是一个用纯 Python 编写的轻量级视频下载工具，支持从抖音、快手、小红书、B站、TikTok、YouTube 等大量国内外流媒体平台解析并下载视频，并尽量获取高清、无水印的版本。它既可以在命令行中使用，也可以作为 Python 库集成到自己的脚本里，代码简洁、易于理解和二次开发。项目主要用于学习与研究，禁止商业用途。

一个覆盖上百个视频平台、纯 Python 实现的高清视频解析下载器

主要功能

• 海量平台支持：内置大量平台专属解析客户端，覆盖抖音、快手、小红书、B站、优酷、腾讯、爱奇艺、芒果 TV、咪咕、YouTube、TikTok、Twitter 等
• 通用解析接口：内置众多通用解析器，目标站点不在专属列表时也可尝试解析
• 双形态使用：既提供命令行工具 videodl，也提供 videodl.VideoClient 的 Python 接口
• 解析下载分离：可先解析 URL 得到视频信息，检查确认后再执行下载
• 下载加速：可结合 FFmpeg、N_m3u8DL-RE、aria2c 处理 HLS 流、加密流与断点续传等场景
• 灵活配置：支持自定义请求头、代理、Cookie、输出目录与多线程数

适用人群

• 开发者：需要在程序里集成视频链接解析与下载能力
• 研究人员：需要批量采集与整理视频数据用于数据集构建
• 技术爱好者：希望在本地保存授权范围内的在线视频以便离线观看

快速上手

1. 安装主程序：执行 pip install videofetch
2. 安装推荐依赖 FFmpeg（处理 HLS 流所需），如需更强能力可再安装 N_m3u8DL-RE、aria2c、Node.js、Bento4
3. 直接下载视频：执行 videodl -i "https://www.acfun.cn/v/ac36491489"
4. 不带 -i 启动会进入交互模式，在提示中输入视频链接即可
5. 也可用 Python 调用：videodl.VideoClient().download(video_client.parsefromurl("链接"))

核心优势

• 纯 Python 实现：无需编译环境，依赖清晰，便于阅读、修改并嵌入自有项目
• 覆盖范围广：专属客户端加通用解析器，可应对更多非常规站点
• 可编程性强：解析与下载步骤解耦，方便按需定制处理流程
• 加速能力可选：借助外部工具可提升大文件与流媒体下载效率

系统要求

项目	要求
操作系统	Windows、macOS 或 Linux
运行环境	Python 3
支持架构	跨平台（x64 与 ARM 均可用）
外部依赖	建议安装 FFmpeg，可选 N_m3u8DL-RE、aria2c、Node.js、Bento4

注意事项

• 仅限学习：本项目仅供学习交流，禁止商业用途
• 尊重版权：下载付费视频前请确保已拥有对应平台的会员
• 接口来源：所用接口均来自公开网络，若存在侵权请联系作者处理
• 依赖可用性：未安装 FFmpeg 等外部工具时，部分平台可能无法解析或下载