包管理器版本由社区维护,不保证是最新版;开发需先装 Tauri v2 的 Rust 依赖和 vp 工具链;Tauri 不支持跨平台构建,只能生成当前平台二进制
从 https://github.com/martpie/museeks/releases 下载安装包README 未说明;仅提及支持 Linux、macOS 和 Windows 三个平台
跨平台简洁音乐播放器,专注干净界面和基础播放管理,不堆砌功能
一款简洁跨平台的本地音乐播放器,基于 Electron 和 React 构建,用来管理和播放本地音乐库,界面干净、上手即用。
核心能力
- 支持 mp3、flac、wav、ogg 等常见音频格式
- 自动刷新音乐库并管理播放列表与队列
- 提供随机播放、循环和播放速度控制
- 支持 .m3u 播放列表导入导出
- 内置深色主题与睡眠模式阻止
容易踩的坑
- 0.23.4最新正式版2026-02-19 · 2026-02-19 11:38 UTC
- Fixed issues with traffic lights position on macOS by ensuring Museeks is built on macOS 14
- 0.23.32026-02-18 · 2026-02-18 21:49 UTC
查看更新说明
- Added a new playback mechanism for Linux, resolving seek and playback issues with large files (thank you @BlueManCZ!)
- this has been tested the best we could, but if you face some issues, you can disable this mechanism by settings
audio_stream_servertofalsein the config file accessible via Settings -> About -> Open Storage Directory ->config.toml, and restart the app.
- this has been tested the best we could, but if you face some issues, you can disable this mechanism by settings
- Added an option to set the Artists view as the default view in settings
- Added a button to hard-reload the app in case of crash
- Fixed an issue with Flatpaks where the app may be launched multiple times
- Fixed the vertical alignment of traffic lights and its gap with play controls on macOS
- Added a new playback mechanism for Linux, resolving seek and playback issues with large files (thank you @BlueManCZ!)
- 0.23.22026-02-03 · 2026-02-03 13:32 UTC
查看更新说明
- Added possibility to click on the Playing Track's Artist/Album to quickly get to it it the Artist View.
- Added 🇪🇸 Spanish translation (thank you @Cayetano97!)
- Updated a bunch of dependencies, hopefully bringing some stability improvements, especially to Linux
- 0.23.12025-09-22 · 2025-09-22 14:11 UTC
查看更新说明
- Added 🇹🇼 Traditional Chinese translation (thank you @Mukvin!)
- Added 🇯🇵 Japanese translation (thank you again @Mukvin!)
- 0.23.02025-08-11 · 2025-08-11 13:26 UTC
查看更新说明
Hello there 👋 Quite a few things this time!
File Associations
I know it took too long! It is now possible to open the files supported by Museeks directly from the File Explorer/Finder.
- Files opened this way won't be added to the library
- Only the selected file(s) will be added to the player queue, not the whole content directly, so if you need to play an entire folder, open all the files at once.
note: there is an uncovered edgecase on macOS where Museeks needs to be already opened to open files. Things should work fine on Windows and Linux.
Accent Color Customization
For those of you who like matching colors for your setups or DEs, it is now possible to define a custom accent color for Museeks via Settings > UI > Accent Color:
Artist View Improvements
The artist view now shows the year next to each album and the albums are sorted by release date, for you music purists.
Side-Navigation Improvements
To help with large lists of artists and playlists, the side navigation will now visually group artists/playlists by their first character. Hopefully this will may things easier to "visually" parse when scrolling large number or artists/playlists.
Copy Track Title/Album/Artist
It is now possible to copy track information from the content menu on the Library or Artist view:
ARM binaries for Linux and Windows
In case you use a Raspberry Pi or a Windows notebook with an ARM chip, Museeks now targets
x86/arm64on all three major platforms. Which should make the app more snappy and energy-efficient on those chips.This was really only achievable with GitHub actions providing action runners for those platform, so thank you GitHub ❤️!
Opt-in compatibility mode for Wayland
! if you don't have any issues with Museeks on Wayland, do not use this !
In case you are facing issues with Wayland (context menus not showing, black screens, etc), you can now enable a temporary compatibility mode for Wayland, available in Settings > UI. This will force the app to run via
xwayland, which may be a more stable experience.In case you are stuck with a non-starting app or black screen after or before changing this setting, you can update the Museeks config by going to
~/.config/museeks/config.toml, and updatewayland_compattotrue/false.Dropped support for Ubuntu <
24.04/ GLIBC <2.39Due to Flatpak requirements, upstream issues and my own sanity, Museeks is now built using GLIBC 2.39, so all distros using a previous version may not be able to run Museeks.
An Update on FlatHub
I am kind of giving up trying to create a build-from-source flatpak manifest that would allow the publication of Museeks to FlatHub. The tooling is too fragmented and complex to use, especially when using two languages (Rust +
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Museeks
A simple, clean, and cross-platform music player. (museeks.io)

Features
Museeks aims to be a simple and easy-to-use music player with a clean UI. You will not find tons of features, as its goal is not to compete with more complete and more famous music players.
Here is a little preview though:
- 💻 Cross-platform music player (Linux, macOS, and Windows)
- 🎧 Supported formats: mp3, mp4, m4a/aac, flac, wav, ogg, 3gpp
- 🔄 Library auto-refresh
- 🌟 Playlists
- 🎼 Queue management
- ➰ Shuffle, loop
- 🌄 Cover art
- 🤓 Dark theme
- 🚤 Playback speed control
- 😴 Sleep mode blocker
- 📥
.m3uimport/export
Want more? Open a new issue or 👍 an existing one so we can talk about it.
Installation
Binaries/Installers can be found on the releases page.
[!NOTE] The publication of Museeks to package managers is community-maintained. Museeks may be available there (like Homebrew, AUR, etc.), but there is no guarantee it will be the latest version.
Release Notes
Bugs
Please open an issue on GitHub, mention your OS, your Museeks version, and how to reproduce it. Adding a screenshot of the console (Menu -> View -> Toggle Developer Tools) is a big help too.
Thank you!
Troubleshooting
Since version 0.20, I try to keep things as backwards-compatible as possible, but I may miss some edge cases.
If you encounter freezes or crashes when using the app, you can reset Museeks.
- Go to Settings -> Open Storage Directory
- Alternatively, go to the Museeks folder directly:
- Windows:
%AppData%\museeks - macOS:
~/Library/Application Support/museeks - Linux:
~/.config/museeks/or$XDG_CONFIG_HOME/museeks
- Windows:
- Delete everything there
- Restart Museeks
If you still have problems after that, please open an issue :)
Contributing and Development
Guidelines
- Before making complex changes, don't hesitate to open an issue first to discuss it ;)
- Understandable code > short code: comment if needed
- That's it :)
Setup
Museeks is built upon:
So you will need to install the following dependencies:
- Tauri requirements for
rust vp(Vite+) for the frontend toolchain (handles Node.js, dependencies, and build tools)
Then you can:
- Fork the repository
git clone [email protected]:<username>/museeks.gitcd museeksvp env useto setup Node.js and the package manager
Development Mode
vp installvp run tauri dev
This will launch Museeks in dev mode. Hot reload will work out-of-the-box, so when you update a .js file, the UI will automatically update. When you edit a .rs file, Museeks will automatically rebuild.
Package Binaries
vp installvp run tauri build
Tauri does not support cross-platform binaries, so the command will only generate binaries for your current platform (macOS, Linux, or Windows).
Translations
- Follow the steps from the "Setup" and "Development Mode" sections
- Go to
src/translations/languages.ts - Add your language information to the list
- Run
vp run gen:translations - This will create a new file
<your_language_code>.poin the same folder - Fill in the translations from the created
.pofile - Open a Pull Request
ps: Translations are in an early stage. If your language has "special" characteristics, like right-to-left, specific locales instead of languages, or something else, Museeks might not be ready for it yet. Please open an issue to discuss it!