WordPress Butterchurn Audio Visualizer

=== WordPress Butterchurn Visualizer ===
Contributors: Joseph Quintero
Tags: visualizer, audio visualizer, butterchurn, music, presets, audio manager
Requires at least: 5.0
Tested up to: 6.4
Requires PHP: 7.4
Stable tag: 1.0.9
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bring dynamic, mesmerizing Butterchurn music visualizations to your WordPress site with customizable controls and seamless integration.

== Description ==

The WordPress Butterchurn Visualizer plugin integrates the renowned Butterchurn music visualizer into your WordPress site. Designed for performance and flexibility, this plugin enables users to experience stunning audio-driven visuals directly from their browsers.

Features include:
– Fully interactive Butterchurn visualizer.
– Extensive collection of 450+ presets with sorting and cycling options.
– Audio playback from user-uploaded files managed through the Audio Manager.
– Customizable visualizer size and behavior via shortcode attributes.
– Mobile and desktop-friendly design.
– Intuitive admin panel for managing, editing, and deleting audio files.
– Supports default audio selection.

The visualizer allows users to switch presets, shuffle between tracks, and toggle fullscreen mode—all through a modern and responsive interface.

== Installation ==

1. Download the plugin and upload the folder to your `/wp-content/plugins/` directory.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. Go to the **Audio Manager** in the admin dashboard to upload and manage audio files.
4. Add the projectm_visualizer shortcode to any page or post to display the visualizer.

== Frequently Asked Questions ==

= How do I customize the visualizer? =
You can adjust the appearance using CSS or configure options such as preset cycling and randomness through the plugin’s built-in controls.

= How do I add audio files? =
Navigate to the **Audio Manager** in the WordPress dashboard. Here, you can upload audio files, edit titles, and set a default audio file for the visualizer.

= What presets are included? =
The plugin comes with 450+ Butterchurn presets, which can be cycled automatically or selected manually.

= Is the visualizer responsive? =
Yes, the visualizer is fully responsive and works seamlessly on both mobile and desktop devices.

== Changelog ==

= 1.0.9 =
– Added edit and delete functionality for audio files in the admin panel.
– Enhanced preset cycling logic to avoid repetition.
– Improved layout and styles for both frontend and admin pages.
– Added keyboard controls for preset navigation and playback.
– Fixed various bugs to ensure smoother performance.

= 1.0.8 =
– Updated visualizer functionality with fullscreen support and auto-resizing.
– Improved Audio Manager layout for managing files.

= 1.0.7 =
– Improved preset handling and cycling features.
– Optimized the rendering for full-width and height support.
– Updated CSS for better responsiveness and layout customization.

= 1.0.6 =
– Added support for extra presets and cycle options.
– Bug fixes for visualizer initialization.

= 1.0.5 =
– Initial public release with core Butterchurn integration.

== Upgrade Notice ==

= 1.0.9 =
This update introduces audio file editing, deletion, and default audio management. It also improves preset cycling and enhances the visualizer’s usability.

== Screenshots ==

1. **Interactive Visualizer**: A stunning visualization on a webpage.
2. **Preset Controls**: Easily switch and cycle through 450+ presets.
3. **Audio Manager**: Upload, edit, delete, and manage audio files from the WordPress admin dashboard.
4. **Customizable Layout**: Modify the visualizer’s appearance to fit your design.

== Usage ==

To add the Butterchurn Visualizer to a page or post, simply include the following shortcode:

projectm_visualizer

Options:
– **category**: Specify the preset category to load by default.

Example:
projectm_visualizer category=”base”

== Features in Development ==

We are working to add support for additional audio sources and advanced customization options. Stay tuned for future updates!