详细介绍
项目简介
Museeks 是一款简单、干净、跨平台的桌面音乐播放器，目标不是与功能繁多的老牌播放器竞争，而是提供清爽易用的听歌体验。项目基于 Tauri v2（Rust）与 React.js 构建，支持 Linux、macOS 和 Windows。
主要功能
- 跨平台桌面音乐播放（Linux、macOS、Windows）
- 支持格式：mp3、mp4、m4a/aac、flac、wav、ogg、3gpp
- 音乐库自动刷新
- 播放列表（Playlists）
- 播放队列管理
- 随机播放、循环播放
- 封面图（Cover art）显示
- 深色主题
- 播放速度调节
- 睡眠模式阻止（避免播放时系统休眠）
.m3u播放列表导入/导出
安装与使用
安装包与二进制文件可在 releases 页面 下载。
注意：发布到各包管理器（如 Homebrew、AUR 等）由社区维护，Museeks 可能会出现在这些渠道中，但不保证是最新版本。
开发与构建
后端使用 Tauri v2 / Rust，界面使用 React.js。需要先安装 Tauri 的 Rust 前置依赖，以及前端工具链 vp（Vite+）。
git clone [email protected]:<username>/museeks.git
cd museeks
vp env use
开发模式：
vp install
vp run tauri dev
该命令会以开发模式启动 Museeks，支持热重载：修改 .js 文件界面会自动更新，修改 .rs 文件会自动重新构建。
打包二进制：
vp install
vp run tauri build
Tauri 不支持跨平台构建，该命令只会为当前所在平台（macOS、Linux 或 Windows）生成二进制文件。
注意事项
自 0.20 版本起，项目尽量保持向后兼容，但仍可能遗漏个别情况。如果使用中出现卡死或崩溃，可以重置 Museeks：进入「设置 -> Open Storage Directory」，或直接前往对应目录：
- Windows：
%AppData%\museeks - macOS：
~/Library/Application Support/museeks - Linux：
~/.config/museeks/或$XDG_CONFIG_HOME/museeks
删除该目录下的全部内容后重启 Museeks。若问题依旧，可在 GitHub 上提交 issue，并附上操作系统、Museeks 版本、复现步骤以及控制台截图（菜单 -> View -> Toggle Developer Tools）。
本作品整理自 GitHub 开源项目 martpie/museeks，原作者 @martpie，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。
更新记录
- v0.23.4当前版本
修复 macOS 上窗口红绿灯按钮位置问题，改为在 macOS 14 环境下构建 Museeks。
评论