{"id":323205,"date":"2026-06-11T11:19:12","date_gmt":"2026-06-11T11:19:12","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/audio-playlist\/"},"modified":"2026-06-11T12:24:12","modified_gmt":"2026-06-11T12:24:12","slug":"nucleus-audio-playlist","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/nucleus-audio-playlist\/","author":23512181,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0","requires":"5.6","requires_php":"7.4","requires_plugins":null,"header_name":"Nucleus Audio Playlist","header_author":"Lorenzo Consoli & Nucleus Digital","header_description":"A modern, self-hosted HTML5 audio player for WordPress. Dynamically loads MP3\/WAV tracks from a server folder, displays cover art, and renders an interactive waveform.","assets_banners_color":"d17872","last_updated":"2026-06-11 12:24:12","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":25,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"nucleusdigital","date":"2026-06-11 12:24:12"}},"upgrade_notice":{"1.0.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3568795,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3568795,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3568795,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3568795,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3568795,"resolution":"1","location":"assets","locale":"","width":1893,"height":739},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3568795,"resolution":"2","location":"assets","locale":"","width":274,"height":641}},"screenshots":{"1":"The player with waveform, cover art, and track list","2":"Admin panel \u2014 Settings tab","3":"Admin panel \u2014 Divi Integration tab"}},"plugin_section":[],"plugin_tags":[4702,708,1494,220,64207],"plugin_category":[50],"plugin_contributors":[266647],"plugin_business_model":[],"class_list":["post-323205","plugin","type-plugin","status-publish","hentry","plugin_tags-audio-player","plugin_tags-mp3","plugin_tags-music-player","plugin_tags-playlist","plugin_tags-waveform","plugin_category-media","plugin_contributors-nucleusdigital","plugin_committers-nucleusdigital"],"banners":{"banner":"https:\/\/ps.w.org\/nucleus-audio-playlist\/assets\/banner-772x250.png?rev=3568795","banner_2x":"https:\/\/ps.w.org\/nucleus-audio-playlist\/assets\/banner-1544x500.png?rev=3568795","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/nucleus-audio-playlist\/assets\/icon-128x128.png?rev=3568795","icon_2x":"https:\/\/ps.w.org\/nucleus-audio-playlist\/assets\/icon-256x256.png?rev=3568795","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/nucleus-audio-playlist\/assets\/screenshot-1.png?rev=3568795","caption":"The player with waveform, cover art, and track list"},{"src":"https:\/\/ps.w.org\/nucleus-audio-playlist\/assets\/screenshot-2.png?rev=3568795","caption":"Admin panel \u2014 Settings tab"}],"raw_content":"<!--section=description-->\n<p><strong>Audio Playlist<\/strong> is a modern, self-hosted HTML5 audio player for WordPress. It dynamically reads MP3 and WAV files from a folder on your server \u2014 no Spotify, no SoundCloud, no dependency on external music services.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>Reads tracks automatically from your audio folder<\/li>\n<li>Displays track titles based on filenames (clean formatting with spaces and capitalization)<\/li>\n<li>Displays a cover image (cover.jpg or cover.png) for the playlist<\/li>\n<li>Renders an interactive waveform powered by WaveSurfer.js<\/li>\n<li>Full playback controls: Play, Pause, Previous, Next, Shuffle, Loop, Volume<\/li>\n<li>Auto-scrolling title for long track names<\/li>\n<li>Works in any shortcode-compatible field \u2014 no Gutenberg block required<\/li>\n<li>Compatible with Divi and other page builders<\/li>\n<li>Configurable background color for the player<\/li>\n<\/ul>\n\n<h4>Usage<\/h4>\n\n<p>Place your MP3 files in a folder named <code>playlist<\/code> under your audio base directory, add a <code>cover.jpg<\/code>, then use the shortcode:<\/p>\n\n<pre><code>[nuclaup_playlist label=\"My Playlist\"]\n<\/code><\/pre>\n\n<h4>Free version limitations<\/h4>\n\n<ul>\n<li>Reads tracks from a single fixed folder named <code>playlist<\/code><\/li>\n<li>Single cover image per playlist (cover.jpg) \u2014 no per-track covers<\/li>\n<\/ul>\n\n<h4>Pro version<\/h4>\n\n<p><strong>Audio Playlist Pro<\/strong> adds:<\/p>\n\n<ul>\n<li>Multiple playlists with custom folder paths<\/li>\n<li>ID3 tag reading (title, artist) for accurate track metadata<\/li>\n<li>Per-track cover art via catalog code matching<\/li>\n<li>Companion Python script to extract and resize cover art from MP3 ID3 tags<\/li>\n<li>Advanced admin panel with catalog code configuration<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>audio-playlist<\/code> folder to <code>\/wp-content\/plugins\/<\/code><\/li>\n<li>Activate the plugin from <strong>Plugins \u2192 Installed Plugins<\/strong><\/li>\n<li>Open <strong>Audio Playlist<\/strong> from the WordPress sidebar<\/li>\n<li>If your audio folder is named <code>audio<\/code> and is located in the root of your site, no configuration is needed \u2014 the plugin works automatically.<\/li>\n<\/ol>\n\n<h4>Folder structure<\/h4>\n\n<p>Place your audio files like this:<\/p>\n\n<pre><code>\/audio\/playlist\/track01.mp3\n\/audio\/playlist\/track02.mp3\n\/audio\/playlist\/cover.jpg\n<\/code><\/pre>\n\n<p>Then use the shortcode <code>[nuclaup_playlist label=\"My Playlist\"]<\/code> anywhere.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20to%20configure%20anything%3F\"><h3>Do I need to configure anything?<\/h3><\/dt>\n<dd><p>No. If your audio folder is named <code>audio<\/code> and is in the root of your site, the plugin works out of the box.<\/p><\/dd>\n<dt id=\"why%20does%20the%20shortcode%20not%20have%20a%20folder%20parameter%3F\"><h3>Why does the shortcode not have a folder parameter?<\/h3><\/dt>\n<dd><p>The free version reads from a single fixed folder (<code>playlist<\/code>) by design. The Pro version allows custom folder paths and multiple independent playlists.<\/p><\/dd>\n<dt id=\"what%20if%20i%20use%20multiple%20shortcodes%20on%20the%20same%20page%3F\"><h3>What if I use multiple shortcodes on the same page?<\/h3><\/dt>\n<dd><p>They will all display the same playlist, since the free version uses a single fixed folder.<\/p><\/dd>\n<dt id=\"what%20image%20formats%20are%20supported%20for%20cover%20art%3F\"><h3>What image formats are supported for cover art?<\/h3><\/dt>\n<dd><p>JPG and PNG. Name the file <code>cover.jpg<\/code> or <code>cover.png<\/code> and place it in the playlist folder.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20divi%3F\"><h3>Does it work with Divi?<\/h3><\/dt>\n<dd><p>Yes. A dedicated Divi Integration tab inside the plugin provides ready-to-paste CSS to fix any style conflicts.<\/p><\/dd>\n<dt id=\"does%20it%20work%20on%20shared%20hosting%3F\"><h3>Does it work on shared hosting?<\/h3><\/dt>\n<dd><p>Yes. The plugin uses WordPress native functions and does not require CLI access.<\/p><\/dd>\n<dt id=\"can%20i%20change%20the%20player%20background%20color%3F\"><h3>Can I change the player background color?<\/h3><\/dt>\n<dd><p>Yes, from the plugin's Settings tab in the WordPress admin.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"A modern, self-hosted HTML5 audio player for WordPress. Drop MP3s in a folder, add a shortcode, and play.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/323205","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=323205"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/nucleusdigital"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=323205"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=323205"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=323205"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=323205"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=323205"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=323205"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}