MP3 Player!

this is my take on a nice, good looking and clean mp3 player for your desktop. Allowing you to load a whole playlist and play it through a nice, modern player.

It is made with electron so should work pretty well on most operating systems.

How to use

firstly select the Browse songs button to get started, it will open your file browser context, choose a directory with all the mp3 files you would like to play and get going! The music will start playing, use the play/pause button to interupt your listening and the skip forward and back buttons to choose your song.

you can see how many songs are in the palylist with the tracks: label and see which your on there too.

to change the volume just slide the slider at the bottom right of your window.

to view themes click the menu icon in the top right corner and choose the theme from the list

Download This App yourself!

Currently the mp3 player has released ready for your use! It is available on linux (tested on Ubuntu 25.10) but due to it being electron should be good to go.

if you would like this on windows just compile it yourself using npm run dist and it will export the .exe to dist directory inside of the folder.

However for the people on linux head over to the releases tab andh chosee the type you wish.

for debian based systems you can just download the .deb file and istall it to your system, or use the AppImage or even unpacked version of the app which should work on most distros.

And from there your good to go! enjoy!

Build and Design yourself

THis project is very easy to continue on yourself!

designing

if you would like to make your own design of this mp3 player its simple! all styling is inside the style.css file. all elements are labeled clearly and simple to follow if you know what your doing

building

dependencies

• npm
• electron
• music metadata browser

building

  npm init -y
  npm install --save-dev electron
  npm install music-metadata-browser

running

  npm start