A simple, clean, and cross-platform music player. (museeks.io)

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
• 📥 .m3u import/export

Want more? Open a new issue or 👍 an existing one so we can talk about it.

Binaries/Installers can be found on the releases page.

Over here!

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!

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.

If you still have problems after that, please open an issue :)

• 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 :)

Museeks is built upon:

• Back-end: Tauri v2 / Rust 🦀
• UI: React.js

So you will need to install the following dependencies:

• Tauri requirements for rust
• Node.js

Then you can:

• Fork the repository
• git clone git@github.com:<username>/museeks.git
• cd museeks

• npm ci
• npm 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.

• npm ci
• npm 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).

• Follow the steps from the "Setup" and "Development Mode" sections
• Go to src/translations/languages.ts
• Add your language information to the list
• Run npm run gen:translations
• This will create a new file <your_language_code>.po in the same folder
• Fill in the translations from the created .po file
• 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!