DouyinSolver 1.0.0

抖音视频无水印下载库 - 无需 Cookie，支持视频和图集

DouyinSolver

抖音视频无水印下载工具
无需 Cookie · 无需 X-Bogus · 支持视频和图集

---

特性

• 零配置使用 - 无需登录，无需 Cookie，开箱即用
• 无水印下载 - 自动转换带水印地址为无水印地址
• 视频 + 图集 - 支持视频和图集两种模式
• 移动端策略 - 使用 iPhone User-Agent 绕过反爬虫
• Python 库 - 可作为库集成到你的项目中
• 命令行工具 - 提供 douyin-dl 命令行工具

---

安装

# 从 PyPI 安装（发布后）
pip install douyin-downloader

# 从源码安装
git clone https://github.com/moehans-official/DouyinSolver.git
cd DouyinSolver
pip install -e .

---

快速开始

命令行

# 解析视频信息
douyin-dl "https://www.douyin.com/video/xxxxxxxxxx"

# JSON 输出
douyin-dl "xxxxxxxxxx" --json

# 下载视频
douyin-dl "xxxxxxxxxx" --download --output ./downloads

Python API

from douyin_downloader import DouyinDownloader

# 创建下载器
dl = DouyinDownloader()

# 解析视频
info = dl.parse("https://v.douyin.com/xxxxx")

# 查看信息
print(f"标题: {info.title}")
print(f"作者: {info.author}")
print(f"无水印地址: {info.play_url}")

# 下载视频
dl.download_video(info, "./downloads")

---

API 参考

DouyinDownloader

class DouyinDownloader(
    timeout: int = 15,
    session: Optional[requests.Session] = None
)

方法	说明
parse(url: str) -> VideoInfo	解析视频/图集信息
download_video(info: VideoInfo, output_dir=".", filename=None) -> Path	下载视频
download_gallery(info: VideoInfo, output_dir=".") -> list[Path]	下载图集
download(url: str, output_path: Path, progress_callback=None) -> Path	下载任意 URL

VideoInfo

@dataclass
class VideoInfo:
    aweme_id: str                # 视频 ID
    title: str                   # 标题/描述
    author: str                  # 作者昵称
    author_id: str               # 作者抖音号
    avatar: str                  # 作者头像 URL
    duration: int               # 时长（毫秒）
    cover: str                   # 封面 URL
    play_url: str                # 无水印视频地址
    play_url_watermark: str     # 带水印视频地址
    images: list[str]            # 图集图片列表
    music: Optional[dict]        # 音乐信息
    
    @property
    def is_gallery: bool         # 是否为图集
    @property
    def is_video: bool           # 是否为视频
    
    def to_dict() -> dict        # 转为字典

---

高级用法

自定义 Session

import requests
from douyin_downloader import DouyinDownloader

session = requests.Session()
session.headers.update({"User-Agent": "Custom/1.0"})

dl = DouyinDownloader(session=session)

下载进度回调

def on_progress(progress):
    print(f"{progress.percentage:.1f}%")

info = dl.parse("https://...")
dl.download(info.play_url, "video.mp4", progress_callback=on_progress)

批量下载

urls = ["url1", "url2", "url3"]

for url in urls:
    try:
        info = dl.parse(url)
        dl.download_video(info, "./downloads")
        print(f"✓ {info.aweme_id}")
    except Exception as e:
        print(f"✗ {url}: {e}")

---

技术原理

1. 移动端 User-Agent: 使用 iPhone Safari 的 UA，避免桌面端的反爬虫机制
2. SSR 数据提取: 从分享页的 window._ROUTER_DATA 解析视频元数据
3. 无水印转换: 将 playwm 替换为 play 获取无水印地址

详细实现过程请参阅 IMPLEMENTATION.md

---

免责声明

本工具仅供学习研究使用，请遵守相关法律法规和平台使用条款。使用者应确保已获得必要授权，产生的任何后果均由使用者自行承担。

---

License

MIT License - 详见 LICENSE