Bili Sync: 自动下载你的哔哩哔哩收藏夹视频

# 一、Bili Sync 介绍

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.bili-sync

bili-sync 是一款专为 NAS 用户编写的哔哩哔哩同步工具。

它的基本的工作原理是使用用户填写的凭据定期扫描视频合集、收藏夹等，获取到本地未下载过的内容并保存到本地，维持本地视频库与哔哩哔哩网站的同步。

下载的内容包括视频、封面、弹幕、标签与简介信息等，这些文件整体保持与 Emby、Jellyfin 等媒体服务器软件兼容的文件布局，使得目的文件夹可以直接被作为媒体库添加到这些软件中，无需干预自动识别。

# 二、使用方法
## 2.1 获取应用
在懒猫应用商店直接安装即可，省去自己部署的麻烦

![Snipaste_2025-08-05_14-31-37.png](https://dl.playground.lazycat.cloud/guidelines/426/8b1d1854-5446-4a43-bf94-1baa16b23f2a.png "Snipaste_2025-08-05_14-31-37.png")

## 2.2 应用配置
首次使用打开应用，右下角会出现如下报错弹窗，不用担心，这是正常的，因为还没有认证
![Snipaste_2025-08-05_21-46-35.png](https://dl.playground.lazycat.cloud/guidelines/426/caef9e7f-c353-4b8f-965b-3f50ce649511.png "Snipaste_2025-08-05_21-46-35.png")
这时打开你的 懒猫开发者工具或右键应用查看日志，会得到一个生成的 auth_token


https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.developer.tools


![Snipaste_2025-08-02_22-38-29.png](https://dl.playground.lazycat.cloud/guidelines/426/e187b593-4807-4fb3-96c8-e9212189b444.png "Snipaste_2025-08-02_22-38-29.png")

打开应用，切换到设置页，输入 auth_token，点击认证即可，前端未认证时都需要此 token

![Snipaste_2025-08-02_22-37-49.png](https://dl.playground.lazycat.cloud/guidelines/426/3f273e9c-a822-476c-b320-c8fd2dbdc223.png "Snipaste_2025-08-02_22-37-49.png")

这个token是可以自定义修改的，默认生成的比较难记，如果在其他比如浏览器或者手机等没有登录过的地方访问时，还需要再次输入，所以建议认证后在设置里修改这个 API 认证的 Token，可以当成密码使用。

## 2.3 添加账号
这是比较关键的部分，如何设置你的 哔哩哔哩账号 呢？

首先要获取哔哩哔哩账号的身份凭据，在应用设置页 “B站认证“ 标签下可以看到有SESSDATA，bili_jct，buvid3，dedeuserid 和 ac_time_value 这5项需要填写



下面来进行说明：
1.浏览器打开 bilibili 首页（登录你的账号）
2.按 F12 进入开发者工具，这里以 Chrome 浏览器为例
3.点击顶部的 Application（应用），再选择左侧 Cookies，点击https://www.bilibili.com/
4.查看你B站的 Cookie 信息，如下

![image.png](https://dl.playground.lazycat.cloud/guidelines/426/16a28a83-f605-4f3b-8620-dd917a1b87ba.png "image.png")

上下滚动，在其中分别找到名为 SESSDATA、bili_jct、buvid3 和 DedeUserID 的 Cookie，复制他们的值填写到应用“B站认证“设置中

5.在控制台（Console）输入 `window.localStorage.ac_time_value
`，打印输出的就是 ac_time_value 的值

![image.png](https://dl.playground.lazycat.cloud/guidelines/426/7aa452c2-ef72-4d77-b4cd-ce2d63bc1073.png "image.png")

最终设置如下

![image.png](https://dl.playground.lazycat.cloud/guidelines/426/ae0747fc-2980-43d4-a0b8-d4a798ed2fa0.png "image.png")

填写完毕后保存配置

之后可以浏览自己的收藏夹、关注合集以及关注的up主，看看是否认证成功

![Snipaste_2025-08-02_22-58-23.png](https://dl.playground.lazycat.cloud/guidelines/426/a737c04b-69f6-41e1-896e-881172ec6ca7.png "Snipaste_2025-08-02_22-58-23.png")

## 2.4 订阅视频
下面介绍如何订阅收藏夹
可以在左侧 “我创建的收藏夹” 中选择收藏夹进行订阅
![Snipaste_2025-08-02_22-56-54.png](https://dl.playground.lazycat.cloud/guidelines/426/80653d6f-1ff7-4903-9cc3-2ddd4a20a764.png "Snipaste_2025-08-02_22-56-54.png")

点击订阅，需要填写本地保存路径

![Snipaste_2025-08-02_23-03-11.png](https://dl.playground.lazycat.cloud/guidelines/426/909a504b-0f5f-45a0-ae66-05f6724e6fee.png "Snipaste_2025-08-02_23-03-11.png")

默认是以 “收藏夹” 开头，我们需要改成一个绝对路径，否则会失败

在本应用中可使用路径 /bilibili/，对应懒猫应用数据目录下 bilibili 文件夹

![Snipaste_2025-08-02_23-07-02.png](https://dl.playground.lazycat.cloud/guidelines/426/9b538e1b-841f-4de8-a744-a9fa6db6db5b.png "Snipaste_2025-08-02_23-07-02.png")

然后等待应用开始同步，下载的视频会保存在这个文件夹中


![image.png](https://dl.playground.lazycat.cloud/guidelines/426/e392ba7f-ca0c-4cdf-8812-3ba06338c60f.png "image.png")

![Snipaste_2025-08-03_01-00-20.png](https://dl.playground.lazycat.cloud/guidelines/426/380e4a1b-831d-40d1-9f9d-c740b0ca3a51.png "Snipaste_2025-08-03_01-00-20.png")

可以在左侧日志选项中查看应用同步视频日志




参考文档：
https://bili-sync.allwens.work/quick-start