在树莓派上安装 Stembox
使用树莓派官方免费工具 Raspberry Pi Imager,将 Stembox 镜像一次性烧录到 microSD 卡上。然后把卡插入树莓派,Stembox 会自动启动。大约需要十五分钟。

您需要准备
一台树莓派 4
内存 2 GB 或以上。树莓派 3 性能不够。
一张 microSD 卡
至少 16 GB,建议 32 GB,品质良好(A1 或 A2 等级)。
一个读卡器
电脑内置读卡器,或小型 USB microSD 读卡器。
您的 Stembox 账户
用于下载镜像和查看许可证密钥。
Raspberry Pi Imager 会以您电脑的语言显示。下面的截图为法语界面,按钮名称在此以英文标注:位置完全相同。
下载 Stembox 镜像
在您的账户中打开 Software 选项卡,点击 Raspberry Pi 按钮。您会得到一个以 .img.xz 结尾的文件(约 1.9 GB)。
打开我的账户不要解压该文件:Raspberry Pi Imager 可以直接读取。
安装 Raspberry Pi Imager
Raspberry Pi Imager 免费,支持 Windows、macOS 和 Linux。从树莓派官网下载适合您电脑的版本并安装,然后将 microSD 卡插入读卡器。
下载 Raspberry Pi Imager在 Windows 上,Imager 启动时会请求更改权限:这是正常的,写入存储卡需要此权限。
选择您的树莓派
- 在列表中点击 Raspberry Pi 4。
- 点击 NEXT。

选择 Stembox 镜像
列表中显示树莓派的操作系统。滚动到最底部,点击最后一项 Use custom image(自定义镜像)。

选择下载的文件
- 进入文件的下载文件夹(通常是下载),点击 Stembox 镜像。
- 点击 Open。

镜像已选择
- Use custom image 选项被高亮显示,并显示镜像大小(解压后约 12 GB)。
- 点击 NEXT。

选择 microSD 卡
- 点击您的 microSD 卡。检查容量:应与您的卡一致。
- 保持勾选 Exclude system drives:您的硬盘不会显示,因此不会被误删。
所选存储卡上的所有内容都将被清除。进行此步骤前,请拔下其他 U 盘和存储卡,以免选错。

写入存储卡
- 检查摘要:Raspberry Pi 4、镜像 stembox-pi-image 和您的存储卡。
- 点击 WRITE,并确认清除存储卡。
Imager 会先写入再校验:根据存储卡和读卡器不同,需要 5 到 15 分钟。完成后会自动弹出存储卡,您可以将其取出。

启动树莓派
- 将 microSD 卡插入树莓派,把屏幕和 DJ 控制器直接连接到树莓派的 USB 接口,然后接通电源(USB-C,5 V 3 A)。
- 首次启动需要一到两分钟,之后 Stembox 会自动打开。
- 输入您的许可证密钥:可在账户的许可证选项卡中找到。如需接收更新,请将树莓派连接到 Wi-Fi。
存储卡只需烧录一次:之后 Stembox 的更新会直接推送到树莓派。
常见问题
需要解压 .img.xz 文件吗?
不需要。Raspberry Pi Imager 会直接读取 .img.xz 文件,并在写入时解压。
可以用树莓派 3 吗?
不可以。Stembox 需要内存 2 GB 或以上的树莓派 4:在树莓派 3 上会出现断音和画面卡死。
应该选择哪种 microSD 卡?
至少 16 GB,建议 32 GB,知名品牌,A1 或 A2 等级。速度慢的卡会延长写入和启动时间。
我用的是 Mac 或 Linux,步骤一样吗?
一样。Raspberry Pi Imager 在 Windows、macOS 和 Linux 上的步骤相同,只是文件选择窗口的外观不同。
写入失败了,怎么办?
重新写入。如果错误仍然出现,请换一个 USB 接口或读卡器,再换一张 microSD 卡:磨损或假冒的存储卡是最常见的原因。
每次新版本都要重新烧录存储卡吗?
不需要。安装 Stembox 后,更新会直接推送到树莓派。只有想从头开始时才需要重新烧录。