Title: Nucleus Audio Playlist Author: nucleusdigital Published: June 11, 2026 Last modified: June 11, 2026 --- Search plugins ![](https://ps.w.org/nucleus-audio-playlist/assets/banner-772x250.png?rev=3568795) ![](https://ps.w.org/nucleus-audio-playlist/assets/icon-256x256.png?rev=3568795) # Nucleus Audio Playlist By [nucleusdigital](https://profiles.wordpress.org/nucleusdigital/) [Download](https://downloads.wordpress.org/plugin/nucleus-audio-playlist.1.0.0.zip) * [Details](https://wordpress.org/plugins/nucleus-audio-playlist/#description) * [Reviews](https://wordpress.org/plugins/nucleus-audio-playlist/#reviews) * [Installation](https://wordpress.org/plugins/nucleus-audio-playlist/#installation) * [Development](https://wordpress.org/plugins/nucleus-audio-playlist/#developers) [Support](https://wordpress.org/support/plugin/nucleus-audio-playlist/) ## Description **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 ## Screenshots [⌊The player with waveform, cover art, and track list⌉⌊The player with waveform, cover art, and track list⌉[ The player with waveform, cover art, and track list [⌊Admin panel — Settings tab⌉⌊Admin panel — Settings tab⌉[ Admin panel — Settings tab ## Installation 1. Upload the `audio-playlist` folder to `/wp-content/plugins/` 2. Activate the plugin from **Plugins Installed Plugins** 3. Open **Audio Playlist** from the WordPress sidebar 4. If your audio folder is named `audio` and is located in the root of your site, no configuration is needed — the plugin works automatically. #### Folder structure Place your audio files like this: ``` /audio/playlist/track01.mp3 /audio/playlist/track02.mp3 /audio/playlist/cover.jpg ``` Then use the shortcode `[nuclaup_playlist label="My Playlist"]` anywhere. ## FAQ ### Do I need to configure anything? No. If your audio folder is named `audio` and is in the root of your site, the plugin works out of the box. ### Why does the shortcode not have a folder parameter? The free version reads from a single fixed folder (`playlist`) by design. The Pro version allows custom folder paths and multiple independent playlists. ### What if I use multiple shortcodes on the same page? They will all display the same playlist, since the free version uses a single fixed folder. ### What image formats are supported for cover art? JPG and PNG. Name the file `cover.jpg` or `cover.png` and place it in the playlist folder. ### Does it work with Divi? Yes. A dedicated Divi Integration tab inside the plugin provides ready-to-paste CSS to fix any style conflicts. ### Does it work on shared hosting? Yes. The plugin uses WordPress native functions and does not require CLI access. ### Can I change the player background color? Yes, from the plugin’s Settings tab in the WordPress admin. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Nucleus Audio Playlist” is open source software. The following people have contributed to this plugin. Contributors * [ nucleusdigital ](https://profiles.wordpress.org/nucleusdigital/) [Translate “Nucleus Audio Playlist” into your language.](https://translate.wordpress.org/projects/wp-plugins/nucleus-audio-playlist) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/nucleus-audio-playlist/), check out the [SVN repository](https://plugins.svn.wordpress.org/nucleus-audio-playlist/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/nucleus-audio-playlist/) by [RSS](https://plugins.trac.wordpress.org/log/nucleus-audio-playlist/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * Initial release. ## Meta * Version **1.0.0** * Last updated **8 hours ago** * Active installations **Fewer than 10** * WordPress version ** 5.6 or higher ** * Tested up to **7.0** * PHP version ** 7.4 or higher ** * Tags * [audio player](https://wordpress.org/plugins/tags/audio-player/)[mp3](https://wordpress.org/plugins/tags/mp3/) [music player](https://wordpress.org/plugins/tags/music-player/)[playlist](https://wordpress.org/plugins/tags/playlist/) [waveform](https://wordpress.org/plugins/tags/waveform/) * [Advanced View](https://wordpress.org/plugins/nucleus-audio-playlist/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/nucleus-audio-playlist/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/nucleus-audio-playlist/reviews/) ## Contributors * [ nucleusdigital ](https://profiles.wordpress.org/nucleusdigital/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/nucleus-audio-playlist/)