抖音直播录屏 (douyin-recorder)

把抖音直播间视频流录制到本地文件。支持开始/停止、多画质、定时录制、开播监控。

用途

• 录制抖音直播间视频流到本地
• 查看直播间状态与可用画质
• 监控开播状态
• 按时长录制、多画质选择

前提

• Python 3.8+
• 系统装有 ffmpeg（apt install ffmpeg / brew install ffmpeg）
• Python 依赖仅 httpx（见 scripts/requirements.txt）

用法

recorder 是一个 Python 包，位于本 skill 的 scripts/douyin_recorder/。<skill_dir> = 本 skill 安装后的目录。通过 PYTHONPATH 指到这个 scripts 目录运行：

export PYTHONPATH="<skill_dir>/scripts:$PYTHONPATH"

# 查看直播间信息（是否在播、可用画质）
python -m douyin_recorder info https://live.douyin.com/房间号

# 开始录制（--duration 单位秒，--profile 可选画质，-o 输出目录）
python -m douyin_recorder record https://live.douyin.com/房间号 --duration 300 --profile small -o ./output

# 监控开播状态
python -m douyin_recorder monitor https://live.douyin.com/房间号

常用参数

• --duration：录制时长（秒）
• --profile：画质（原画/uhd/高清/中清/标清/流畅）
• -o：输出目录
• --cookies：可选 cookie 文件（登录态）
• --proxy：可选代理 URL

脚本目录

douyin-recorder/
├── SKILL.md
└── scripts/
    ├── douyin_recorder/   # 录屏 Python 包
    └── requirements.txt    # 依赖（httpx）

这里「用法」按 python -m + 设 PYTHONPATH 运行，实测最稳；若你的 agent 把 install 目录当作模块路径，也可 pip install -e <skill_dir>/scripts 后再用。