Nucleus Audio Playlist

Nucleus Audio Playlist

Details
View on WordPress

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

Details

Plugin code:
nucleus-audio-playlist
Plugin version:
1.0.0
Outdated:
No
WP version:
5.6 or higher
PHP version:
7.4 or higher
Test up to WP version:
7.0
Total installations:
0
Last updated:
2026-06-11
Rating:
Times rated:
0
audio-player
mp3
music-player
playlist
waveform