A minimal music player built on electron.
Switch branches/tags
Nothing to show
Clone or download
Latest commit dcfb59e Nov 30, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
app Added mute and info (#5) Nov 24, 2018
build Add files via upload Nov 1, 2018
style Add files via upload Aug 4, 2018
LICENSE Initial commit Apr 18, 2018
README.md Update README.md Nov 30, 2018
_config.yml Update _config.yml Nov 30, 2018
dusk.png Version 2.0.0 updates Nov 1, 2018
main.js Added mute and info (#5) Nov 24, 2018
package-lock.json Version 2.0.0 updates Nov 1, 2018
package.json Added mute and info (#5) Nov 24, 2018


Music Player

A minimalistic music player, designed for simplicity. Built on electron, uses Howler for handling music playback, AngularJS and Bootstrap for the frontend, and jsmediatags to retrieve the ID3 tags.

This can also serve as a starting point to impliment your own front-end/UI to the Player.

Download here: Releases

How to use

1. The Player

Download the build for your OS. Start the application and and then click on the Folders tab on the top left corner, this will bring up a window where you can select the folder where you want to play your mp3 files from. Once you select a folder with songs, just click play.

2. Building from the repo

Clone the repository, then navigate to it on your terminal and run npm install, once all the dependencies have finished downloading, run npm start to test it, and npm run dist to build it for your platform.


  • Supports: mp3, opus, ogg, wav, aac, m4a and webm.
  • Quickly switch tracks in the same folder, from the playlist button.
  • Fine tune the volume from the volume slider
  • Plays tracks on Shuffle
  • Reads ID3 tags and displays the artist and album art (if they exist)

New Features/Changes (v2.0.0)

  • When you open the app, it starts playing music from the directory that you last played music from. This means that you can skip having to select a directory when you open the app.
  • Changed the name to Dusk Player, Music player was too generic.
  • You can now play tracks on shuffle.
  • New location and style for the playlist.
  • Volume slider has indicators.
  • New app Icon
  • Small style changes.

If you liked this, check out My Blog where I post tutorials and write about projects like this


Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY