Skip to content
🎡 A simple, clean and cross-platform music player
Branch: master
Clone or download
Latest commit 7fe9f51 Mar 28, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Clean-up Mar 14, 2019
src Last minute design adjustments Mar 28, 2019
.gitignore Add .vscode to .gitignore Feb 26, 2019
.stylelintrc Kill Bootstrap with fire Feb 18, 2019
LICENSE Big refactoring to prepare queue management Jul 9, 2015 Misc styles, copy and other refinements Mar 2, 2019
electron-builder.yml Fix conflicts with master Mar 7, 2019
package-lock.json Update dependencies Mar 28, 2019
package.json Revert "Make electron-rebuild a postinstall op" Mar 28, 2019
screenshot.png Update screenshot Mar 8, 2018
tsconfig.json Sass -> CSS modules, refactor components Feb 15, 2019
tslint.json Drop eslint, use tslint + semistandard Aug 19, 2018
webpack.common.js Add .mjs to resolve.mainFields Mar 7, 2019 Fix dbus-next access to environment variables Mar 27, 2019


Build Status Dependencies Github All Releases

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



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 goals 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 support
  • πŸ€“ Dark theme
  • 🚀 Playback speed control
  • 😴 Sleep mode blocker
  • πŸ”Š Minimize to tray
  • πŸ”„ .m3u import/export

Want more? Open a new issue or πŸ‘ an existing one so we can talk about it.

Releases notes

Over here!



Builds and installers can be found on this page.

Build (advanced)

Museeks is built upon:


  • node > 10
  • npm > 6

Please consider that master is unstable.

  • git clone
  • cd museeks
  • npm install
  • npm run build or npm run dev
  • npm run museeks or npm run museeks:debug


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 the Museeks folder directory
    • Windows: %AppData%\museeks
    • OSX: ~/Library/Application Support/museeks
    • Linux: ~/.config/museeks/ or $XDG_CONFIG_HOME/museeks
  • Delete:
    • IndexedDB folder
    • config.json file
  • Restart Museeks

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

Bug report

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
  • npm install && npm run dev then run in a separate terminal npm run museeks:debug
  • npm run dev will watch for file changes using Webpack which will recompile JSX and CSS files.

Please respect a few rules:

  • Before making complex stuff, don't hesitate to open an issue first to discuss about it ;)
  • Make the code readable and comment if needed
  • Make sure your build pass

Then open a PR :)

You can’t perform that action at this time.