Open-Source Audio Player that supports a variety of formats

Dusk 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 implement your own front-end/UI for a music Player.

Download here: Releases

How to use

1. The Player

Download the build for your OS. Start the application 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 audio files from. Once you select a folder with songs, just click play.

2. Building from the repo

Clone the repository, make it your working directory, and then on your terminal 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.
  • Reads ID3 tags and displays the artist and album art (if they exist)
  • Quickly switch tracks from the playlist.
  • Search for songs from the search bar.
  • Choose between a Dark, Light and Disco modes


Upcoming Features

Some new features and under the hood stuff that have already been implemented. They'll be included in the next update

  • Nothing here yet!


  • Brand new theme! The Disco theme changes the background color based on the song album art. Select it from the themes menu.
  • Search for songs from the search bar.
  • The progress bar now feels more responsive when seeking.
  • Setting are now stored in a JSON store instead of in files.
  • Fixed a bug where the title and artist name would flicker while playing/pausing or skipping tracks.


  • Now choose between a Dark and Light mode!
  • Recursively finds audio files in all sub directories of the chosen directory


  • 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 is licensed by CC 3.0 BY

Something missing? Edit this app.

Keyboard Shortcuts

Key Action
/ Focus the search bar
Esc Focus the search bar and cleans it
Select the next search result
Select the previous search result
Enter Open the selected search result
cmdEnter Ctrl+Enter Open the selected search result in a new tab