本文档描述了DanmakuRender-4（以下简称DMR）在不同平台下的安装步骤和常见问题。适用于从未接触过Python程序的新手阅读。
目录：
Windows安装
Linux安装
macOS安装
备注
更新日期：2024.12.10。
-
安装Python
点击这里下载Python 3.9安装包，需要下载其他版本的可以前往官网自行下载。下载完成后点击安装，安装时注意选择Add Python xxx to PATH这个选项，其他默认就可以。 -
下载DMR主程序
点击这里下载，选择下面的Source code.zip，下载完成之后解压即可。
下载完成之后就可以运行了，程序会在第一次运行时自动安装FFmpeg等需要的组件，无需手动安装。这里仍然展示手动安装的步骤，供特殊情况下使用。
- 安装Python包
打开命令行窗口（win10系统shift+右键点击页面空白处，在菜单中选择“在此处打开powershell窗口”，win11在页面右键选择“在终端中打开”），输入下面的命令安装Python包。
pip install -r requirements.txt-
安装FFmpeg
点击这里下载，下载完成后解压，将bin文件夹里面的ffmpeg.exe、ffprobe.exe和ffplay.exe移动到程序中的tools文件夹下。如果下载慢的话可以考虑挂梯子或者自行前往国内镜像站下载，最后保证在程序的tools文件夹下有这三个文件即可。 -
安装biliup-rs（可选）
如果需要使用自动上传B站的功能则需要下载安装biliup-rs，可以前往其GitHub主页下载，下载选择版本名称-x86_64-windows.zip，将解压得到的biliup.exe移动到程序中的tools文件夹下。
这里以Ubuntu为例说明，其他的Linux发行版方法基本类似。
- 安装Python
Linux一般已经默认安装Python，使用命令python -V检测是否安装Python。如果没有安装请输入以下指令安装：
sudo apt install python3.9- 安装程序
安装release版本的方法类似Windows，安装测试版的话可以使用git命令安装：
git clone https://github.com/SmallPeaches/DanmakuRender.git -b v5
- 安装Python包
打开命令行窗口（win10系统shift+右键点击页面空白处，在菜单中选择“在此处打开powershell窗口”，win11在页面右键选择“在终端中打开”），输入下面的命令安装Python包。
pip install -r requirements.txt- 安装FFmpeg
使用apt-get快速安装：
sudo apt-get install ffmpeg如果需要安装最新版本，请前往：https://ffmpeg.org/download.html
-
安装biliup-rs
方法类似Windows安装，下载时选择Linux的预编译版本 -
安装JavaScript解释器
在录制斗鱼弹幕时需要JavaScript解释器，部分Linux并没有预装，需要手动安装（这里以nodejs为例）：
sudo apt install nodejs npm与Linux的安装方法基本类似，示例系统版本为macOS Sequoia 15.1.1。
- 安装Python
macOS一般已经默认安装Python，使用命令python -V检测是否安装Python。如果没有请先安装 Homebrew 之后输入以下指令安装：
brew install [email protected]- 安装程序
安装release版本的方法类似Windows，安装测试版的话可以使用git命令安装：
git clone https://github.com/SmallPeaches/DanmakuRender.git -b v5
- 安装Python包
打开终端应用程序，输入下面的命令安装Python包。
pip install -r requirements.txt- 安装FFmpeg
使用Homebrew快速安装：
brew install ffmpeg如果需要安装最新版本，请前往：https://ffmpeg.org/download.html
-
安装biliup-rs
方法类似Linux安装，下载时选择macOS的预编译版本（根据处理器平台选择aarch64或x86_64版本） -
安装JavaScript解释器
在录制斗鱼弹幕时需要JavaScript解释器，macOS并没有预装，需要手动安装（这里以nodejs为例）：
brew install node- 如果需要使用硬件加速，请根据显卡类型自行前往官网下载最新的驱动程序，渲染失败的最可能原因是没安装最新显卡驱动！
- DMR录制斗鱼弹幕的功能目前无法工作在Python 3.10以上，如果有需要的话请使用Python 3.9版本。