Bilibili Fav Downloader — Bilibili 收藏下载器

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

使用方式： 快速开始：

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

  python3 scripts/bilibili_fav_dl.py \

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"

核心脚本说明： scripts/setup.sh：自动安装 yt-dlp 和 ffmpeg scripts/bilibili_fav_dl.py：主下载脚本（分页获取、增量下载、TG 通知）

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

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

收藏夹 ID 获取： 详见 references/favorite-guide.md，核心步骤：

• 打开收藏夹页面
• URL 中找 fid=xxx 或 mlxxx 文件命名格式

下载文件命名为：视频标题___BV号.mp4 例如：【合集】2024年度盘点___BV1xx411x7h7.mp4

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