作者：EchoZenith Github

以下是一份关于 BiliBili-DL 的使用文档，详细介绍如何安装和使用该项目来下载 B站视频。

BiliBili-DL 使用文档

1. 项目简介

BiliBili-DL 是一个开源工具，用于下载 B站（Bilibili）视频。它提供了两种语言版本：Node.js 和 Python，用户可以根据自己的需求选择合适的版本进行使用。

2. 安装前的准备工作

2.1 安装 FFmpeg

BiliBili-DL 需要 ffmpeg 来处理视频文件。请确保在你的系统中安装了 ffmpeg，并将其添加到环境变量中。以下是不同操作系统的安装方法：

Windows 用户

1. 下载 FFmpeg Windows 版本。
2. 解压下载的文件到一个目录（例如 C:\ffmpeg）。
3. 将 C:\ffmpeg\bin 添加到系统的环境变量 PATH 中。

4. 打开命令提示符，运行以下命令以验证安装：

   ffmpeg -version

   如果安装成功，你会看到 FFmpeg 的版本信息。

macOS 用户

1. 使用 Homebrew 安装 FFmpeg：

   brew install ffmpeg

2. 验证安装：

   ffmpeg -version

Linux 用户

1. 使用包管理器安装 FFmpeg：

   • Ubuntu/Debian：

     sudo apt update
     sudo apt install ffmpeg

   • CentOS：

     sudo yum install ffmpeg

   • Arch Linux：

     sudo pacman -S ffmpeg

2. 验证安装：

   ffmpeg -version

3. 安装与使用

3.1 Node.js 版本

安装步骤

1. 克隆项目：

   git clone https://github.com/EchoZenith/BiliBili-DL.git
   cd BiliBili-DL/
   git checkout node

2. 安装依赖：

   npm install

3. 运行程序：

   node run start

3.2 Python 版本

安装步骤

1. 克隆项目：

   git clone https://github.com/EchoZenith/BiliBili-DL.git
   cd BiliBili-DL/
   git checkout python

2. 安装依赖：

   pip install -r requirements.txt

3. 运行程序：

   python login.py # 可选 登录获取Cookie
   python main.py

4. 打包为可执行文件（Python 版本）

为了方便在没有 Python 环境的系统上运行工具，可以使用 PyInstaller 将 Python 版本打包为独立的 .exe 文件。

打包步骤

1. 安装 PyInstaller：

   pip install pyinstaller

2. 打包主程序：

   pyinstaller -D -i "BiliBili-DL.ico" --onefile --name="BiliBili下载" main.py

3. 打包登录程序（如果需要）：

   pyinstaller -D -i "BiliBili-DL.ico" --onefile --name="二维码登录" login.py

4. 查找生成的文件：
   打包完成后，生成的 .exe 文件位于 dist 文件夹中。

5. 使用指南

5.1 命令行界面

运行程序后，你将看到一个命令行界面，提示你输入 B站视频的链接。输入有效的视频链接后，程序将自动解析并开始下载。

5.2 支持的清晰度

• 超清：4K、1080P60 等。
• 高清：1080p、720p 等。
• 标清：480p、360p 等。
  程序会根据视频的实际可用清晰度进行下载。

5.3 批量下载

如果你需要下载多个视频，可以通过以下方式：

1. 将多个视频链接保存到一个文本文件中（每行一个链接）。

2. 使用-file 文件名。

   python main.py -file 文件名

6. 注意事项

1. 合法使用：本工具仅供学习和研究目的使用。请遵守 B站的使用条款，不要用于非法用途。
2. 链接有效性：请确保输入的视频链接是有效的 B站视频页面链接。
3. 依赖更新：请定期更新项目依赖，以确保工具的正常运行。

7. 支持平台

• Windows
• macOS
• Linux

8. 贡献代码

如果你有任何改进或新功能的想法，欢迎贡献代码！以下是贡献步骤：

1. Fork 本项目。

2. 创建一个新的分支：

   git checkout -b feature/your-feature-name

3. 提交你的更改：

   git commit -m "Add some feature"

4. 推送到你的分支：

   git push origin feature/your-feature-name

5. 提交 Pull Request。

9. 联系与反馈

如果你在使用过程中遇到问题，或者有任何建议，请通过以下方式联系我们：

• 提交 Issue。
• 发送邮件至：EchoZenith@163.com。

感谢你使用 BiliBili-DL！

希望这份使用文档能帮助你顺利使用 BiliBili-DL 工具。如果有任何问题，请随时参考项目的 GitHub 页面或联系项目维护者。