A simple, clean and cross-platform music player. (museeks.io)
It uses:
- Node.js for back-end
- electron (used to be atom-shell) for embedded browser
- React.js as front-end framework and Flux with Redux as data-flow pattern
===
- Lightweight music player
- Polished
- Playlists
- Queue management
- Shuffle, loop
- Covers
- Dark theme
- Playback speed control
- Sleep mode blocker
- Supported formats:
- mp3
- mp4
- m4a/aac
- wav
- ogg
- 3gpp
===
===
Builds can be found at this page. Please notice those are only portable versions. Installers are on the road.
Please consider that master
is unstable.
- Download Electron
- Download Museeks source code
- Put it in a folder called
app
in[Electron path]/resources
npm install && npm run compile
- Run Electron
===
Museeks is currently in development. This implies some things can break after an update (database schemes changes, config...).
If you encounter freezes when starting 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
- Windows:
- Delete:
IndexedDB
folderconfig.json
file
- Restart Museeks
If you still get problems after that, please open an issue :)
===
If you want to report a bug, first, thanks a lot. To help us, please indicate your OS, your Museeks version, and how to reproduce it. Adding a screen of the console (Settings -> Advanced -> enable dev mode) is a big help too.
===
- Fork and clone
- Master is usually unstable, checkout to a tag to have a stable state of the app
npm install && npm run dev
- Enable dev mode in the app in the settings view to show DevTools
Webpack will watch for JSX and SASS changes.
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
npm run lint
passes
Then open a PR :)