Bilibili Favorite Downloader

全自动 Bilibili 收藏夹监控下载工具。用户只需提供 Cookie 和收藏夹 ID，即可自动下载。

环境要求

• Python 3.8+
• yt-dlp（Bilibili 下载核心）
• ffmpeg（音视频合并）
• Linux/macOS/WSL

环境安装

如果用户尚未安装环境，引导运行：

bash scripts/setup.sh

或手动安装：

# Ubuntu/Debian
sudo apt install ffmpeg
pip3 install yt-dlp

# macOS
brew install ffmpeg
pip3 install yt-dlp

使用方式

快速开始

1. 获取 Cookie（详见 references/cookie-guide.md）
2. 获取收藏夹 ID（详见 references/favorite-guide.md）
3. 运行下载：

python3 scripts/bilibili_fav_dl.py \
  --cookie /path/to/cookie.txt \
  --fav-id 你的收藏夹ID \
  --out-dir ./downloads

仅检查（不下载）

python3 scripts/bilibili_fav_dl.py \
  --cookie /path/to/cookie.txt \
  --fav-id 你的收藏夹ID \
  --check-only

自动化配置

设置每2小时自动运行（crontab）：

# 编辑 crontab
crontab -e

# 添加：
0 */2 * * * /usr/bin/python3 /path/to/bilibili_fav_dl.py --cookie /path/to/cookie.txt --fav-id 你的收藏夹ID --out-dir /path/to/downloads >> /var/log/bilibili_dl.log 2>&1

Telegram 通知（可选）

设置环境变量：

export BILIBILI_TG_BOT_TOKEN="你的BotToken"
export BILIBILI_TG_CHAT_ID="你的ChatID"

然后在 crontab 中正常运行脚本即可。新视频下载完成后自动发送通知。

核心脚本说明

Cookie 获取

详见 references/cookie-guide.md，核心步骤：

1. 登录 douyin.com
2. F12 → Network → 任意请求 → Request Headers → Cookie
3. 导出为 Netscape 格式文件

收藏夹 ID 获取

详见 references/favorite-guide.md，核心步骤：

1. 打开收藏夹页面
2. URL 中找 fid=xxx 或 mlxxx

文件命名格式

下载文件命名为：视频标题___BV号.mp4

例如：【合集】2024年度盘点___BV1xx411x7h7.mp4

已知限制

• 部分视频因地区版权限制无法下载
• Cookie 有效期约1-3个月，过期后需重新获取
• 需 Cookie 才能访问私人收藏夹