=== HTML5 Audio Player - The Ultimate No-Code Podcast, MP3 & Audio Player ===
Contributors: bplugins, abuhayat, freemius, shamim10, farazi1
Tags: mp3 player, audio, audio player, player, podcast
Donate link: https://www.buymeacoffee.com/abuhayat/  
Requires at least: 6.5
Tested up to: 7.0
Stable tag: 2.7.3
Requires PHP: 7.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Maximize your WordPress site's potential with our versatile HTML5 Audio Player plugin. Seamlessly play .mp3, .wav, .ogg, and more audio files. 

== Description ==

**The Ultimate No-Code Podcast, MP3 & Audio Player Plugin for WordPress**

[**HTML5 Audio Player**](https://bplugins.com/products/html5-audio-player/) | [**Documentation**](https://bplugins.com/docs/html5-audio-player/) | [**Pricing**](https://bplugins.com/products/html5-audio-player/pricing) | [**Support**](https://bplugins.com/support/) | [**Demo**](https://bplugins.com/products/html5-audio-player/#demos)

https://youtube.com/watch?v=6ZHKarDpllQ

[**HTML5 Audio Player**](https://bplugins.com/products/html5-audio-player/) is a powerful, lightweight, and fully responsive audio player plugin for WordPress. It lets you embed MP3 and OGG audio files into posts, pages, widget areas, or template files using shortcodes, no coding required.

Built with modern HTML5 technology, this plugin works across all major browsers and iOS devices, ensuring reliable playback on any screen size. Its shortcode-based setup gives you full control over placement and player settings, making it suitable for podcasts, music tracks, audio previews, or online courses.

### Key Features – Free Version
- **Advanced Player Types**: Choose from Standard, Sticky Player, or Audio Playlist Player (New in Free!).
- **Audio Playlist Block**: Create and embed fully-featured audio playlists with custom tracks directly in the block editor (Previously a PRO-only block!).
- **Standard Player Skins**: Access Default, Fusion, Stamp, and Wave skins for free.
- **Sticky Player Skins**: Access Simple and Fusion skins for free.
- **Embed Anywhere**: Add audio to posts, pages, widgets, and theme templates using shortcodes.
- **Responsive & Lightweight**: Adapts to all devices and doesn’t slow down your site.
- **Customization Options**: Adjust width, border radius, and poster images.
- **Title & Author Support**: Display custom audio titles and author names.
- **Autoplay, Preload & Mute Options**: Define how your audio behaves upon loading.
- **Repeat Control**: Loop your audio seamlessly.
- **Lazy Load Support**: Optimize page load speed by loading the player and audio resources only when they enter the viewport.
- **Great for Podcasts**: Perfect for embedding podcast episodes or audio courses.
- **MP3 & OGG Support**: Automatically loads the right format based on user’s device.
- **Google Drive Audio Support**: Seamlessly play audio files directly from Google Drive. Our built-in smart proxy bypasses Google's restrictions and CORS errors, ensuring smooth playback and accurate duration display.
- **SoundCloud Streaming Support**: Stream tracks seamlessly by pasting their page URLs directly. Bypasses strict access rules, authorization requirements, and expiring CDN URLs for a smooth visitor experience.
- **Cross-Browser Support**: Works smoothly on Chrome, Firefox, Safari, Edge, IE7–IE9, and more.

### Pro Version – Unlock Premium Audio Controls
Upgrade to the [**Pro version**](https://bplugins.com/products/html5-audio-player/pricing) for more control over design, behavior, and playback settings.

**What’s Included in Pro:**
- **Advanced Playlist Designs & Custom Skins**: Unlock additional premium designs (like Narrow and Extensive playlist skins) and custom settings.
- **7 Additional Premium Skins**: Access Card 1, Card 2, Simple 1, Simple 2, Player 9, Player 10, and Player 11.
- **Color Customization**: Set custom primary and background colors to perfectly fit your site’s branding.
- **Download buttons**: Add download buttons to your player.
- **Fast Forward & Rewind Buttons**: Enhance navigation with custom seek time settings.
- **Start & End Time Settings**: Specify exactly when the audio should start and stop playing.
- **Disable Pause Option**: Keep audio playing without interruption.
- **Save State Functionality**: Save the player's time state so it resumes from where the user left off.
- **Premium Sticky Player Features**: Unlock Background Color, Repeat, Save State, Initial Volume, and Download Button for Sticky Players.
- **Single Button Player**: Minimalist design for single-action audio playback.
- **Ad-Free Experience**: No ads, ever.

[**Try the HTML5 Audio Player PRO**](https://bplugins.com/products/html5-audio-player/pricing) – Unlock all premium features now!


### How to Use – Step-by-Step Setup

Getting started is quick and easy.

https://youtu.be/B7HnUaAm9Xs

#### Step-by-Step Setup

- Install and activate the plugin.

- In the WordPress dashboard, go to the **HTML5 Audio Player** menu.

- Add a new player and copy the generated shortcode.

- Paste the shortcode into any post, page, or widget.

- Done – enjoy seamless audio playback!

**Gutenberg Block Support**

Using the Block Editor? You’re covered.

- Open a post/page editor.

- Click the **+** icon, go to **Common Blocks**, and select **HTML5 Audio Player**.

- Choose your audio player and hit the **Publish** button.

Enjoy crystal-clear audio in just a few clicks!


[**Live Demo**](https://bplugins.com/products/html5-audio-player/#demos) | [**Upgrade to Pro**](https://bplugins.com/products/html5-audio-player/pricing)


== Source Code ==

You can find the source code, report bugs, and contribute to the development of this plugin on our GitHub repository: 
[**HTML5 Audio Player on GitHub**](https://github.com/bPlugins/html5-audio-player-free)

== Third-Party Libraries ==

This plugin bundles the following third-party JavaScript/PHP libraries.

= Codestar Framework =

* **Source:** [http://codestarframework.com/](http://codestarframework.com/)
* **GitHub:** [https://github.com/Codestar/codestar-framework](https://github.com/Codestar/codestar-framework)
* **License:** GPLv2 or later – [https://github.com/Codestar/codestar-framework/blob/master/LICENSE.md](https://github.com/Codestar/codestar-framework/blob/master/LICENSE.md)
* **Purpose:** Provides the options framework for the plugin's settings and shortcode generator.

= Freemius SDK =

* **Source:** [https://freemius.com/](https://freemius.com/)
* **GitHub:** [https://github.com/Freemius/wordpress-sdk](https://github.com/Freemius/wordpress-sdk)
* **License:** GPLv3 – [https://github.com/Freemius/wordpress-sdk/blob/master/LICENSE.txt](https://github.com/Freemius/wordpress-sdk/blob/master/LICENSE.txt)
* **Purpose:** Provides opt-in usage tracking and analytics to help improve the plugin.

= bpl-tools =
* Source / GitHub: https://github.com/bPlugins/bpl-tools
* License: GPL-2.0-or-later – https://www.gnu.org/licenses/gpl-2.0.html
* Purpose: Shared utility library providing admin dashboard components and common Gutenberg editor controls.
* External Services: The library may connect to bPlugins, WordPress.org, and Freemius services for product data and checkout functionality. See full details: https://github.com/bPlugins/bpl-tools#external-requests--why-they-are-made


### User Feedback 

❛❛**_I bought a second license for another site because this plugin satisfied all my needs. I had a small problem on this new site and support solved the problem within hours of my request. Thank you so much. You are awesome._**❜❜

**_-pripyat51_**


❛❛**_Loving the player and the support they have provided. The new features are exactly what we need. Thank you!_**❜❜

**_-hoffmaw_**

Like that plugin? Hate it? Want a new feature? **[Send your feedback](https://bplugins.com/support)**


### Check out our other WordPress Plugins-

[**Html5 Video Player**](https://bplugins.com/products/html5-video-player/) – Display videos as single and playlist in multiple skins.

[**PDF Poster**](https://bplugins.com/products/pdf-poster/) – Display/Embed PDF files with different styles.

[**StreamCast**](https://bplugins.com/products/streamcast-radio-player/) – Customizable radio player with different skins.

[**3D Viewer**](https://bplugins.com/products/3d-viewer/) – Embed 3D models and 3D products with interaction.

[**Advanced Post Block**](https://bplugins.com/products/advanced-post-block/) – Show posts and custom posts in different layouts.


== Frequently Asked Questions ==


= How do I install this plugin?
You can install the plugin directly from your WordPress dashboard. Go to Plugins > Add New, search for the plugin name, click "Install Now", and then activate it.

= Can I play a video, such as an MP4 file? =
No, but you can try our “[**HTML5 Video Player**](https://bplugins.com/products/html5-video-player/)” plugin.

= What type of audio can I play? =
You can play .mp3, .oog, and .wav audio files.

= Does the player work on mobile devices? =
Yes, audio players are fully responsive and work on smartphones and tablets, including iOS and Android.

= Can I customize the look of the audio player? =
Yes, you can adjust colors, skins, sizes, and more. The plugin includes options for customizing player appearance to match your website.

= Is autoplay supported? =
Yes, you can enable autoplay for audio. Note that some browsers may restrict autoplay behavior based on user settings.

= Can I restrict downloads of the audio file? =
Yes, the plugin offers an option to enable or disable the download button.

= Can I show a preview or sample before full playback? =
Yes, you can configure the player to show a sample or preview clip for digital products or paid content.

= Can I use this plugin to sell audio files? =
You can use the plugin to showcase previews and link to purchase/download pages. Integration with eCommerce plugins can be handled separately.

= Does this plugin support playlists? =
Yes, you can create playlists with multiple audio files. Different player types are available, including standard, playlist, and sticky player.

= Will the plugin slow down my website? =
The plugin is lightweight and optimized for performance. You can also adjust preload settings to improve page speed.

= Where do I report security bugs found in this plugin? =
Please report security bugs found in the source code of the Html5 Audio Player plugin through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/9e5fb647-1b45-475d-8541-fb20b0d6a5a0). The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.


== Installation ==

This section describes how to install the plugin and get it working.

e.g.
1. Upload `plugin-directory` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Use the shortcode on the page, post, or in widgets.
4. If you want Player in your theme php, Place `<?php echo do_shortcode('YOUR_SHORTCODE'); ?>` in your templates.


== Screenshots ==

1. Add New Audio
2. Player Configuration
3. Preview
4. Preview
5. Preview
6. Preview
7. Add New Playlist
8. Playlist Player Configuration
9. Playlist Preview
10. Settings
11. Sticky Configuration
12. Gutenberg Block
13. Gutenberg Block Settings


== Changelog ==

= 2.7.3 - 23 June, 2026 =
* **Fix:** Resolved an issue where loading the player shortcode on a page containing third-party audio players could cause those third-party players to be hijacked by the plugin's global player script.

= 2.7.2 - 21 June, 2026 =
* **New:** Added "Enable Lazy Load" option across all player skins and playlist layouts to optimize page load performance.

= 2.7.1 - 15 June, 2026 =
* **Security:** Hardened the Google Drive audio proxy endpoint to patch XSS and SSRF vulnerabilities by validating MIME types, manually enforcing redirect checks, and applying strict HTTP headers.

= 2.7.0 - 13 June, 2026 =
* **New:** Moved the Audio Playlist Gutenberg Block from the Pro version to the Free version, allowing all users to create and display custom audio playlists.
* **New:** Added End Time (Excerpt) settings for limiting audio playback duration.
* **Update:** Completely redesigned and modernized the admin dashboard welcome screen with dynamic builder integration tabs (Gutenberg, Shortcode, Elementor) and status checks.
* **Fix:** Fixed an issue where the player's customized colors and style settings reset back to original default colors when loading or re-opening a page in the Gutenberg block editor.

= 2.6.4 - 21 May, 2026 =
* **Fix:** Resolved SoundCloud track URL playback issues for standard players, shortcodes, and Gutenberg Block Editor.
* **Fix:** Implemented secure internal SoundCloud API v2 progressive stream proxying to bypass restricted/temporary CDN stream URL expirations.
* **Fix:** Fixed block settings panel URL updates and block preview rendering issues for SoundCloud track links.

= 2.6.3 - 20 May, 2026 =
* **Fix:** Resolved an issue where Google Drive audio links displayed 00:00 duration by implementing a robust Range-request proxy.
* **Fix:** Fixed server connection hanging and PHP session locking issues caused by uninterrupted background downloads in the proxy endpoint.
* **Fix:** Improved compatibility and stable playback for Google Drive URLs across all audio player skins and playlist blocks.

= 2.6.2 - 17 May, 2026 =
* **Fix:** Fixed the issue where the audio players showed 00:00 duration.

= 2.6.1 - 15 May, 2026 =
* **Fix:** Fixed the issue where the Fusion skin of the standard player was not appearing due to a NaN volume value issue.

= 2.6.0 - 10 May, 2026 =
* **New:** Users can now turn shuffle on or off from Gutenberg and dashboard settings.
* **Update:** Massive structural update unlocking several previously PRO features to the Free version (Sticky player, standard skins, poster images, border radius, repeat, and more).
* **Update:** Cleaned up the free dashboard to neatly present premium-only settings via intuitive notice cards.
* **Update:** Fully redesigned the Playlist Premium unlock notice block.
* **Update:** Update brand new Dashboard.
* **Fix:** Printing Garbage / Raw JSON on the Page. 
* **Fix:** Not Possible to Customise PRO Playlist Skin. 
* **Fix:** Fix the player controls in Gutenberg Block Editor.
* **Fix:** Fix shuffle mode track mismatch issue.
* **Fix:** Resolved "Player not loading" issue on public/live WordPress websites caused by a JavaScript compatibility error (ReactDOM is not defined).
* **Fix:** Applied the fix across all player types — Fusion Player, Standard Player, Playlist (Narrow & Extensive), and Radio Player.
* **Improvement:** Improved Quick Player Settings with Documentation Link & Search Form Shortcode UI.
* **Improvement:** Completely revamped the HTML5 Audio Player. "Playback Speed" menu with a premium, elegant design and custom scrollbars.

= 2.5.3 - 15 Dec, 2025 =
* Fixed: Undefined array key "postId"

= 2.5.2 - 15 Dec, 2025 =
* Improved: Added settings to add whitelist domains list to protect against random URL requests in the radio player.
* Update: Freemius SDK

= 2.5.1 - 13 Nov, 2025 =
* Update: Dashboard
* Improved: Code

= 2.5.0 - 21 July, 2025 =
* New: Dashboard page
* Improved: Code,
* Fixed: Disapear Player


= 2.4.0 - 29 June, 2025 =
* New Block: HTML5 Radio Player
* Shortcode: [h5ap_radio_player id=1740]

= 2.3.3 - 22 June, 2025 =
* Fixed: Fix Responsive issue. 
* Improved: Code 

= 2.3.2 - 11 May, 2025 = 
* Fixed: Hide Download option worn't work (Pro)

= 2.3.0 - 20 April, 2025 = 
* Update: Improve Security
* Added: New Playlist (Premium)
* Fixed: shortcode Vulnerability

= 2.2.28 - 27 Jan, 2025 = 
* Update: Update Freemius WordPress SDK

= 2.2.27 - 20 Dec, 2024 = 
* Fixed: Elementor Can't Edit (Undefined Elementor Color Schema)

= 2.2.26 - 26 Nov, 2024 = 
* Fixed: Undefined array key "primary"

= 2.2.25 - 18 Aug, 2024 = 
* Fixed: High Memory Usage 
* Fixed: Preset color does apply on Gutenberg blocks

= 2.2.24 - 25 June, 2024 = 
* Fixed: Patchstack Vulnerability 

= 2.2.23 - 15 May, 2024 = 
* Fixed: Double player issue

= 2.2.22 - 9 May, 2024 = 
* Feature: Enable/Disable Loader
* Fixed: audio doesn't play old (before 2018) iOS devices.
* Feature: Set start time (premium)

= 2.2.19 - 3 Feb, 2024 = 
* Fixed: m4a issue in safari

= 2.2.18 - 27 Jan, 2024 = 
* Feature: Quick Player / New Shortcode Added
* Fixed: Deprecated: Creation of dynamic property

= 2.2.17 - 4 Dec, 2023 = 
* Fixed: File does not exist

= 2.2.16 - 22 Nov, 2023 = 
* Fixed: default player not working

= 2.2.14 - 25 Sep, 2023 = 
* Fixed: call to undefined function str_contains

= 2.2.13 - 20 Sep, 2023 = 
* Fixed: Deprecated error from Codester

= 2.2.12 - 18 Sep, 2023 = 
* Option to set initial volume in Elementor addon

= 2.1.10 = 
* Elementor Addons Added
* Gutenberg Block Added

= 2.1.5 = 
* solve audio player duration stuck issue

= 1.3 =
* Enabled Direct file download with the original file name. 
* Fix a minor issue
* Improved performance

= 1.2 =
* Add support for Gutenberg Block

= 1.1 =
* fix player position issue
* Change player skin to modern one.
* improved performance

= 1.0 =
* Initial Release


=== Upgrade Notice ===

= 2.2.23 - 15 May, 2024 = 
* Fixed: Double player issue