=== Audio Wave Block ===
Contributors: senff
Donate link: http://donate.senff.com
Tags: audio, music, waveform, wave, player
Plugin URI: https://wordpress.org/plugins/audio-wave-block
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html


A simple audio player for the Block editor with just a Play/Pause button and a waveform representing the soundwaves.


== Description ==

Audio Wave Block adds a block to the Block Editor, that can be used to play any audio file on your site. It only has a Play/Pause button and shows the waveform of the audio, and during playing it shows a progress bar, using the WaveSurfer library.


== Features: ==

* Shows the audio waveform, representating the sound levels of the audio file.
* Progress bar can be dragged to any position.
* Customizable colors for the player background, button and waveform (played/unplayed).
* Multiple players can be present on a single post/page.
* When starting a player, any other players that are already playing on the same page will pause (avoiding multiple players running at the same time).


== Installation ==

= Installation from within WordPress =

1. Visit **Plugins > Add New**.
2. Search for **Audio Wave Block**.
3. Install and activate the Audio Wave Block plugin.
4. In the Block Editor, select /audiowave to add the block.
5. Select an audio file and customize colors.

= Manual installation =

1. Upload the entire `audio-wave-block` folder to the `/wp-content/plugins/` directory.
2. Visit **Plugins**.
3. Activate the Audio Wave Block plugin.
4. In the Block Editor, select /audiowave to add the block.
5. Select an audio file and customize colors.


== Frequently Asked Questions ==

= What does it do exactly? =
This plugin adds a new block called Audio Wave, that is a very basic audio player. The player adds a waveform that is a true representation of the audio levels in the audio file, meaning that it will show a timeline of the song/sound, indicating where the quiet parts and louder parts are.  The listener can play and pause, and click anywhere on the waveform to jump to that point.

= The player doesn't offer the listener the option to DOWNLOAD the file? Or change the volume? =
No, the purpose of this player is to keep things very simple: just a button and a waveform. If you want the options in your player to download audio or change the volume, use the default Audio player instead.

= I need more help please! =
If you're not sure how to use this, or you're running into any issues with it, post a message on the plugin's [WordPress.org support forum](https://wordpress.org/support/plugin/audio-wave-block).

= I've noticed that something doesn't work right, or I have an idea for improvement. How can I report this? =
Audio Wave Block's community support forum at https://wordpress.org/support/plugin/audio-wave-block would a good place, though if you want to add all sorts of -technical- details, it's best to report it on the plugin's Github page at https://github.com/senff/WordPress-Audio-Wave-Block/issues . This is also where I consider code contributions.

= My question isn't listed here? =
Please go to the plugin's community support forum at https://wordpress.org/support/plugin/audio-wave-block and post a message. Note that support is provided on a voluntary basis and that it can be difficult to troubleshoot, and may require access to your admin area. Needless to say, NEVER include any passwords of your site on a public forum!


== Third-Party Libraries ==

This plugin includes WaveSurfer.js (https://wavesurfer.xyz/) v7.12.6, used for audio waveform rendering.

- License: BSD 3-Clause                                                                                         
- Copyright: © 2012–2024 katspaugh and contributors                                                             
- Source: https://github.com/katspaugh/wavesurfer.js    


== Screenshots ==

1. Players in the editor
2. Players on the front end


== Changelog ==

= 1.0 =
* Initial release.


== Upgrade Notice ==

= 1.0 =
Initial release of the plugin.