BLSync

BLSync 是一个 Bilibili 收藏夹同步工具。

疯狂完善功能中……

功能

• 支持收藏夹同步
• 支持外部 API 下载请求
• 支持稍后观看同步
• 支持 UP 主视频同步
• 支持 UP 主动态图片、动态文字同步
• 支持个人动态同步
• 支持 外部下载工具
• 支持 WebUI

使用

Docker Compose 运行（推荐）

你需要了解docker compose的基本用法。

1. 创建目录结构

mkdir blsync
cd blsync
mkdir config/     # 配置和记录目录
mkidr sync/       # 下载文件存储目录

2. 创建 compose.yaml 文件

services:
  blsync:
    image: oxygenkun1/blsync:latest
    container_name: blsync
    ports:
      - "8000:8000"
    volumes:
      - ./config:/app/config
      - ./sync:/app/sync
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

3. 创建配置文件 ./config/config.toml（内容写法在配置文件章节）

4. 启动服务与常用命令

# 启动服务（后台运行）
docker compose up -d

# 停止服务
docker compose down

源码运行

你需要在命令行环境安装uv、ffmpeg

# 同步运行环境
uv sync

# 启动服务
uv run bs -c config/config.toml

bs 是项目提供的命令行工具，通过 pyproject.toml 中的 [project.scripts] 定义

配置文件

默认读取 ./config/config.toml 文件 （参考模板文件 ./config/config.template.toml 中的说明）。

收藏夹 id (fid) 获取方法

浏览器可以看到 fid=xxxx，只需要后面数字即可

更新日志

CHANGELOG

特别感谢

该项目实现过程中主要参考借鉴了如下的项目，感谢他们的贡献：

• bili-sync 项目功能和配置文件参考
• bili-sync-yt-dlp 基础代码逻辑参考
• bilibili-API-collect B 站的第三方接口文档
• bilibili-api 使用 Python 调用接口的参考实现
• yutto 使用 yutto 下载视频