Bili23 Downloader

Appearance

从源码安装 ​

⚠️ 面向进阶用户

本说明仅适用于具备一定技术基础（熟悉 Python 与命令行操作）的开发者。如果你只需要直接打开使用软件，强烈建议前往查阅 下载发行版，以避免复杂的环境搭建过程。

1. 环境准备 ​

在开始克隆和运行之前，请确保你的系统已正确安装以下前置组件：

  • Python：版本需要 ≥ 3.10，并确保已添加到系统环境变量（PATH）。
  • Git：用于克隆项目代码。
  • FFmpeg：程序核心依赖 FFmpeg 实现音视频流的最终合并下载。与直接下载发行版不同，源码运行时不会自带此工具。你需要提前配置好 FFmpeg 环境。

    参考资料：如需自行编译安装 FFmpeg，可阅读作者博客 《FFmpeg 编译安装指南》。

2. 获取项目源码 ​

打开终端或命令行，执行以下命令将项目源码克隆到本地，并进入项目目录：

bash
git clone https://github.com/ScottSloan/Bili23-Downloader.git
cd Bili23-Downloader

3. 配置运行环境 ​

为避免污染系统的全局 Python 环境，推荐使用 venv 隔离依赖。

第一步：创建虚拟环境

bash
python -m venv venv

第二步：激活虚拟环境 此处请根据你的操作系统选择对应的激活命令：

bash
venv\Scripts\activate
bash
source venv/bin/activate

第三步：安装依赖包

💡 Linux 旧版系统兼容性提示

如果你使用的是较旧的 Linux 发行版，请先将 requirements.txt 中 PySide6 的版本上限调整为以下值：

  • amd64 架构：
    如果你的 glibc 版本范围为 2.28 ~ 2.33，建议最高使用 6.9.x 版本

    bash
    PySide6<6.10

    低于 2.28 版本不受支持。

  • arm64 架构：
    如果你的 glibc 版本范围为 2.31 ~ 2.38，建议最高使用 6.7.x 版本

    bash
    PySide6<6.8

    低于 2.31 版本不受支持。

💡 macOS 旧版系统兼容性提示

如果你使用的是 macOS 10.15 或 11，请先将 requirements.txt 中 PySide6 的版本上限调整为以下值：

  • macOS 11：
    建议最高使用 6.7.x 版本
    bash
    PySide6<6.8
  • macOS 10.15：
    建议最高使用 6.4.x 版本
    bash
    PySide6<6.5
bash
pip install -r requirements.txt

4. 启动程序 ​

完成上述所有环境配置后，进入主程序 src 目录，并启动入口脚本：

bash
cd src
python main.py

附录：关于底层构建 ​

如果你好奇本项目是如何在跨平台上实现自动化构建与封装打包的，欢迎参考以下开源仓库与流水线脚本：