Nucleus Audio Playlist
·
A modern, self-hosted HTML5 audio player for WordPress. Drop MP3s in a folder, add a shortcode, and play.
Audio Playlist is a modern, self-hosted HTML5 audio player for WordPress. It dynamically reads MP3 and WAV files from a folder on your server — no Spotify, no SoundCloud, no dependency on external music services.
Features
- Reads tracks automatically from your audio folder
- Displays track titles based on filenames (clean formatting with spaces and capitalization)
- Displays a cover image (cover.jpg or cover.png) for the playlist
- Renders an interactive waveform powered by WaveSurfer.js
- Full playback controls: Play, Pause, Previous, Next, Shuffle, Loop, Volume
- Auto-scrolling title for long track names
- Works in any shortcode-compatible field — no Gutenberg block required
- Compatible with Divi and other page builders
- Configurable background color for the player
Usage
Place your MP3 files in a folder named playlist under your audio base directory, add a cover.jpg, then use the shortcode:
[nuclaup_playlist label="My Playlist"]
Free version limitations
- Reads tracks from a single fixed folder named
playlist - Single cover image per playlist (cover.jpg) — no per-track covers
Pro version
Audio Playlist Pro adds:
- Multiple playlists with custom folder paths
- ID3 tag reading (title, artist) for accurate track metadata
- Per-track cover art via catalog code matching
- Companion Python script to extract and resize cover art from MP3 ID3 tags
- Advanced admin panel with catalog code configuration