musikcube
SHA-256一款跨平台的终端音乐播放器和流媒体服务器，支持 Windows、macOS、Linux 和树莓派。
终端里的音乐播放器，还能当流媒体服务器，树莓派也能跑。
核心功能
- 纯终端界面，资源占用低，适合老旧设备或树莓派
- 支持多种音频格式（通过 FFmpeg）
- 内置 HTTP/WebSocket 流媒体服务器，支持远程控制
- 提供 Android 远程控制应用（musikdroid）
- 支持跨平台运行，Windows/macOS/Linux 均可
避坑指南
- •默认流媒体服务器使用明文密码且无 SSL，切勿直接暴露在公网；如需远程访问请配置反向代理（如 Nginx）添加 HTTPS。服务器密码存储在 settings 文件中，请妥善保管。
适用场景
- 在树莓派上搭建家庭音乐服务器，通过手机远程选歌播放
- 在无图形界面的服务器上使用终端管理本地音乐库
- 替代 cmus / mpd 等旧式终端播放器，获得更现代的操作体验
详细介绍
musikcube 是一款运行在终端中的跨平台音乐播放器和流媒体服务器，使用 C++ 编写。支持 Windows、macOS、Linux 以及树莓派，提供丰富的音频解码能力（通过 FFmpeg）和轻量级的 TUI 界面（基于 ncurses）。内置流媒体服务器，可通过 Android 应用（musikdroid）远程控制和播放音频。安装方式多样，支持 Homebrew、Chocolatey、pkg 等包管理器，也可从源码编译。注意：默认服务器未加密，密码明文存储，暴露到公网需配置反向代理 SSL。
常见问题与排障 (2)
故障排除为什么 musikcube 在 Windows 上无法播放扩展名为大写的 .MP3 或 .WAV 文件？
这是由于 musikcube 中区分大小写的文件扩展名匹配所导致的；大写的 .MP3/.WAV 文件会被忽略，而小写的 .mp3/.wav 文件则可以正常工作。请升级到 musikcube 0.92.0 或更高版本，该 bug 已在新版本中修复。对于 0.92.0 之前的版本，请将文件重命名为小写扩展名（例如，将 .MP3 改为 .mp3）。如果重命名后仍存在重复或陈旧的条目，请从媒体库中移除该音乐文件夹，然后重新添加，并重建索引。
故障排除如何修复在使用 FFmpeg 8.0 构建 musikcube 时出现的 'avcodec_close' 未声明错误？
将 musikcube 升级到最新发布版本或当前的 master 分支；FFmpeg 8.0 兼容性修复（包括移除/替换已被移除的 avcodec_close API）已经发布。如果使用 FreeBSD Ports，请更新 ports 树并升级 multimedia/musikcube。对于源码构建，请运行 git fetch --tags && git checkout master && git pull，然后清理并重新构建（例如：rm -rf build && cmake -S . -B build && cmake --build build -j$(nproc)）。已知 Musikcube 3.0.4 无法与 FFmpeg 8.0 正常配合工作。
标签
快速上手
安装软件
根据你的发行版安装对应的包（dpkg / rpm / AppImage）
下载对应系统的 release 压缩包或通过包管理器安装（如 brew install musikcube）
解压后双击运行或终端输入 musikcube 启动
按方向键浏览本地音乐文件夹，Enter 播放，按 ? 查看快捷键帮助
- 下载对应系统的 release 压缩包或通过包管理器安装（如 brew install musikcube）
- 解压后双击运行或终端输入 musikcube 启动
- 按方向键浏览本地音乐文件夹，Enter 播放，按 ? 查看快捷键帮助
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
9c908eacc4b3d0bf494bc0a72048a9f3bb59ed6471c4571da8f5441e277fc883该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
通过包管理器卸载（如 brew uninstall musikcube）或直接删除安装目录。配置文件通常位于 ~/.config/musikcube 或 ~/.musikcube，可手动删除。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs