Repolode
提交项目
dpipstudio

dpipstudio/botwave

用树莓派通过 FM 广播播放音频文件和实时音频，支持单机与多台设备集中管理。

在 GitHub 查看官网
Star
147
Fork
8
未关闭 Issue
0
最近提交
6天前

这是什么？

BotWave 可以把树莓派变成 FM 广播发射器。单台树莓派可以作为独立的本地客户端运行；多台树莓派也可以连接到中央服务器，由服务器统一发送文件、开始或停止广播。

它支持 MP3、WAV、FLAC、AAC、OGG 等常见音频格式，需要时会自动转换为 WAV。文件可以从本机上传，也可以通过 URL 下载，队列系统用于管理播放列表。借助 ALSA 回环声卡，还能实时广播其他应用的音频输出，并可设置事件触发或开机自动执行的任务。

本地客户端和服务器都提供命令行界面，并支持基于 WebSocket 的远程管理，可通过口令进行认证。安装脚本适用于 Raspberry Pi OS、Ubuntu、Fedora 和 Arch 等 Linux 系统。目前不支持树莓派 5 和 Pico。使用前需了解当地关于 FM 广播的法规。

核心功能

  • 01单机本地客户端模式，或多台树莓派的客户端-服务器模式。
  • 02自动转换 MP3、WAV、FLAC、AAC 等常见音频格式。
  • 03支持从本地文件系统上传文件，或通过 URL 下载。
  • 04借助 ALSA 回环声卡实时广播其他应用的音频。
  • 05基于 WebSocket 的远程管理，支持口令认证。
  • 06可在事件触发或开机时自动执行命令。

适用场景

  • 借助树莓派学习 FM 发射与 RDS 的工作原理。
  • 在多台树莓派上搭建小型本地电台或艺术装置。
  • 用树莓派加导线天线，向近距离区域播放公告或音乐。
  • 通过服务器命令行或任务自动化功能编排自动广播计划。

快速上手

  1. 1

    运行 README 中的官方安装脚本（如需可先审查）

  2. 2

    在一台树莓派上启动独立的本地客户端

    sudo bw-local
  3. 3

    在 BotWave 命令行中下载示例音频文件

    botwave › dl https://cdn.douxx.tech/files/ss.wav
  4. 4

    以 88 MHz 频率开始广播该文件

    botwave › start ss.wav 88

使用前须知

  • 需要树莓派（型号 2、3、4 或 Zero）；不支持 Pi 5 和 Pico。
  • FM 广播可能受当地法规限制，且需要 root 权限。
  • 直播功能需要额外设置 ALSA 回环声卡。

标签

#raspberry-pi#fm-transmitter#radio#broadcasting#python#iot#automation#botwave#fm#good-first-contribution

常见问题

botwave 是什么？
用树莓派通过 FM 广播播放音频文件和实时音频，支持单机与多台设备集中管理。 BotWave 可以把树莓派变成 FM 广播发射器。单台树莓派可以作为独立的本地客户端运行；多台树莓派也可以连接到中央服务器，由服务器统一发送文件、开始或停止广播。
botwave 可以免费使用吗？用的什么许可证？
botwave 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
botwave 还在维护吗？
活跃维护中。botwave 最近一次提交是在 2026年11月1日。
botwave 适合用来做什么？
借助树莓派学习 FM 发射与 RDS 的工作原理。 在多台树莓派上搭建小型本地电台或艺术装置。 用树莓派加导线天线，向近距离区域播放公告或音乐。 通过服务器命令行或任务自动化功能编排自动广播计划。
botwave 怎么安装和运行？
运行 README 中的官方安装脚本（如需可先审查） 在一台树莓派上启动独立的本地客户端: sudo bw-local 在 BotWave 命令行中下载示例音频文件: botwave › dl https://cdn.douxx.tech/files/ss.wav 以 88 MHz 频率开始广播该文件: botwave › start ss.wav 88
在哪里获取 botwave？
源代码和安装说明在 GitHub 上：https://github.com/dpipstudio/botwave

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目