MP3 Player (Desktop + Web)

Web/desktop MP3 player with playlists and user-provided track information.

Features

• Load .mp3 files in browser mode or desktop mode
• Built-in All Tracks playlist
• Playlist management:
  • create playlist
  • rename playlist
  • delete playlist
  • reorder tracks in custom playlists via drag-and-drop
• Imported Tracks menu:
  • view all imported tracks
  • search by title, artist, or filename
  • set shuffle weight per track
• Playback controls: Prev, Play/Pause, Next, Shuffle toggle
• Edit track details: title, artist, album, notes
• Save playlists and metadata to local storage

Shuffle Weight System

Shuffle mode uses a per-track numeric weight.

• 0 means the track is excluded from shuffle (never auto-selected)
• 1 means the track should appear about every other song (approximate)
• values between 0 and 1 reduce frequency
• values greater than 1 increase frequency

Weight is configured in the Imported Tracks menu.

Normalize Weights Button

Normalize Weights (Current Playlist) resets shuffle weights for tracks in the selected playlist:

• tracks with weight 0 stay at 0 (still excluded)
• all other tracks are set to 0.1 (balanced default)

Desktop App

Install dependencies:

• npm install

Run desktop app:

• npm start

Build Windows installer:

• npm run build

Installer output is created in dist/.

File Persistence Notes

• Desktop (Electron): selected track file paths persist, so playback remains available after restart.
• Browser: tracks must be re-imported after refresh/reload.