下载与安装 · BiliFlow

选择安装包

BiliFlow 是免费开源的桌面工具。前往下载页选择系统，安装包直接来自项目的 GitHub Releases。

系统	系统要求	安装包
Windows	Windows 10 / 11，x64	full 或 lite ZIP
macOS	macOS 12 或更新，Apple Silicon	full 或 lite ZIP
Linux	从源码运行	暂无预构建包

macOS 预构建包面向 Apple Silicon。识别为 macOS 并不代表你的设备满足架构要求；Intel Mac 请参考下方的源码运行方式。

推荐 full 包。 它内置 FFmpeg 和配套直播录制引擎，适合直接使用。lite 包体积更小，需要自行安装 FFmpeg；直播录制还需要配置配套引擎。

Windows 安装

下载 Windows full ZIP，并完整解压到一个固定目录。
打开解压目录中的应用程序；保留同目录内的依赖文件。
在应用「设置 → 下载」中确认保存目录。

当前安装包没有商业代码签名证书，首次启动可能出现 SmartScreen 提示。先核对文件来自项目 Release 页面及 SHA-256 校验值；相关说明见故障排查。

macOS 安装

下载 macOS full ZIP，解压后将应用移到「应用程序」目录。
打开 BiliFlow，确认保存目录。
当前发布包默认未经 Apple 公证；首次打开被拦截时，在「系统设置 → 隐私与安全性」查看对应提示，并确认来源与完整性。

某个版本若完成签名或公证，会在该版本的发行说明中注明。请以对应 Release 为准。

lite 包与 FFmpeg

根据系统安装 FFmpeg：

bash

# macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

powershell

# Windows
winget install Gyan.FFmpeg

在「设置 → 工具与存储」中选择 FFmpeg 可执行文件并检查。Windows 应选择 ffmpeg.exe，而不是安装目录。自定义路径会覆盖 full 包的内置版本；清空该路径即可恢复内置版本。

lite 包的直播引擎配置见直播录制。

从源码运行

Linux、Intel Mac 或开发环境可以从源码运行。需要 Python 3.10–3.12、Git 和 FFmpeg；不同平台上的依赖兼容性以项目仓库说明为准。

bash

git clone https://github.com/itsVicOC/bilibili-downloader.git
cd bilibili-downloader
python -m venv .venv
source .venv/bin/activate
python -m pip install -c constraints.txt -e ".[dev]"
python -m bilibili_downloader

Windows PowerShell 使用 .\.venv\Scripts\Activate.ps1 激活虚拟环境。源码运行的直播录制需要另行构建引擎，详见项目构建文档。

校验与升级

每个 Release 提供 SHA256SUMS.txt。在下载页打开校验文件，将以下命令输出与对应文件的记录比较：

bash

shasum -a 256 BilibiliDownloader-macOS-full-vX.Y.Z.zip

powershell

Get-FileHash .\BilibiliDownloader-Windows-full-vX.Y.Z.zip -Algorithm SHA256