A simple, clean and cross-platform music player. (museeks.io)
Note Museeks is on its way to a big rewrite with some major UI and Back-End changes, please help shape the future of the music player in the discussions section! :]
Museeks aims to be a simple and easy to use music player with a clean UI.
You will not find tons of features, as it 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
- ✨ Clean and polished
- 🌟 Playlists
- 🎼 Queue management
- ➰ Shuffle, loop
- 🌄 Covers
- 🤓 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.
Binaries can be found on this page.
Warning Those instructions, are for the still work-in-progress Tauri version of Museeks. If you wish to see how to build it for Electron (
<=0.20), please see the previous version of the README.
Museeks is built upon:
Requirements:
- See Tauri requirements for
rust bun
Please consider that master is unstable.
git clone [email protected]:martpie/museeks.gitcd museeksbun install --frozen-lockfilebun tauri dev
bun install --frozen-lockfilebun tauri build
Tauri does not support x-platform binaries, so the command will only generate binaries for your current platform (macOS, Linux or Windows).
Museeks is currently in development. This implies some things can break after an update (database schemes changes, config...).
If you encounter freezes or crashes when using the app, you can reset Museeks by following these steps:
- Go to Settings -> Open Storage Directory
- Alternatively, go to the Museeks folder directory
- Windows:
%AppData%\Museeks - OSX:
~/Library/Application Support/Museeks - Linux:
~/.config/museeks/or$XDG_CONFIG_HOME/Museeks
- Windows:
- Delete everything, but mainly:
main.bonsaidbfolderconfig.tomlfile
- Restart Museeks
If you still get problems after that, please open an issue :)
If you want to report a bug, first, thanks a lot, that helps us a lot. Please open an issue and mention your OS, your Museeks version, and how to reproduce it. Adding a screen of the console (Menu -> View -> Toggle Developer Tools) is a big help too.
- Fork and clone
- Master may be unstable, checkout to a tag to have a stable state of the app
bun install --frozen-lockfile && bun tauri devwill launch Tauri and compile the app. Hot reload will work out of the box.
Please respect a few rules:
- Before making complex stuff, don't hesitate to open an issue first to discuss about it ;)
- Understandable code > short code: comment if needed
- Make sure your build pass
Then open a PR :)
