=== AudioPress Lite ===
Contributors: Adharsh GS
Tags: audio, text-to-speech, tts, accessibility, seo, ai, puter
Requires at least: 5.0
Tested up to: 6.4
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically generate AI-powered audio versions of your WordPress posts using Puter.js TTS. Improves accessibility, SEO, and user engagement.

== Description ==

**AudioPress Lite** transforms your written content into high-quality AI-generated audio narrations using Puter.js Text-to-Speech technology. Perfect for improving accessibility, SEO, and providing your readers with an alternative way to consume your content.

### 🎯 Key Features

* **🔊 AI Text-to-Speech** - Converts post content to natural-sounding audio using Puter.js
* **📰 Auto-Inject Player** - Automatically adds a beautiful audio player to your posts
* **🧩 SEO Schema** - Includes AudioObject schema markup for better search visibility
* **🗣️ Speakable Schema** - Optimized for voice assistants and audio search
* **🗒️ Transcript Storage** - Keeps full text as transcript for accessibility
* **🔁 Auto Regeneration** - Updates audio when content changes
* **🎨 Custom Settings** - Control player position, auto-generation, and more
* **🪄 Shortcode Support** - Use `[audiopress]` to place player anywhere
* **📱 Responsive Design** - Beautiful player that works on all devices

### 💡 Benefits

* **Accessibility** - Makes content available to visually impaired users
* **SEO & AEO** - Improves discoverability in audio and voice search
* **User Engagement** - Offers multi-modal content consumption
* **Time-Saving** - Automatic generation with zero manual effort
* **No API Keys** - Uses Puter.js - no external API setup required

### 🚀 How It Works

1. Install and activate the plugin
2. AudioPress automatically generates audio for new posts
3. A beautiful audio player appears on your posts
4. Users can listen while reading or on-the-go

### 🎨 Customization Options

* Choose player position (above/below content or manual placement)
* Enable/disable automatic generation
* Set maximum content length for audio
* Enable/disable Schema.org markup
* Manual generation button in post editor

### 🔧 Technical Details

* Uses Puter.js AI for text-to-speech conversion
* Client-side audio generation (no server processing)
* Adds AudioObject and Speakable schema markup
* Clean, modern player interface
* No external dependencies except Puter.js

== Installation ==

### Automatic Installation

1. Log in to your WordPress admin panel
2. Go to Plugins > Add New
3. Search for "AudioPress Lite"
4. Click Install Now, then Activate

### Manual Installation

1. Download the plugin zip file
2. Go to Plugins > Add New > Upload Plugin
3. Choose the zip file and click Install Now
4. Activate the plugin

### Configuration

1. Go to Settings > AudioPress
2. Configure your preferences:
   - Enable/disable auto-generation
   - Choose player position
   - Set max content length
   - Enable Schema markup
3. Save changes

== Usage ==

### Method 1: Automatic (Recommended)

1. Enable "Auto-Generate Audio" in Settings > AudioPress
2. Publish or update any post
3. Audio player appears automatically!

### Method 2: Manual Generation

1. Edit any post
2. Look for "AudioPress - Audio Version" box in the sidebar
3. Click "Generate Audio Version"
4. Preview or publish

### Method 3: Shortcode

Place this shortcode anywhere in your post content:

`[audiopress]`

This gives you complete control over player placement.

### Method 4: Theme Integration

Add to your theme template:

`
if (function_exists('audiopress_get_audio_text')) {
    echo do_shortcode('[audiopress]');
}
`

== Frequently Asked Questions ==

= Do I need an API key? =

No! AudioPress Lite uses Puter.js which doesn't require API keys or external accounts.

= Does this work with Gutenberg? =

Yes! AudioPress works with both the Classic Editor and Gutenberg Block Editor.

= Can I customize the player design? =

Yes! The plugin includes CSS classes you can target with custom CSS in your theme.

= Does it support custom post types? =

Currently supports the 'post' post type. Custom post type support coming in a future update.

= How long does audio generation take? =

Audio is generated client-side in real-time when users click play, typically taking just a few seconds.

= Will this slow down my website? =

No! Audio is generated on-demand in the browser, so there's no impact on your server or page load times.

= Is the audio stored anywhere? =

No, audio is generated fresh each time. Only the text content is stored as post metadata.

= Can users download the audio? =

Users can use browser features to download/save audio, but the plugin doesn't include a dedicated download button.

= Does it work with caching plugins? =

Yes! Since audio is generated client-side, it works perfectly with any caching plugin.

= What languages are supported? =

Puter.js TTS supports multiple languages. The plugin will use the language of your content.

== Screenshots ==

1. Beautiful audio player embedded in post
2. Admin settings page
3. Meta box in post editor
4. Mobile-responsive player design

== Changelog ==

= 1.0.0 - 2025-01-30 =
* Initial release
* Puter.js TTS integration
* Auto-generation on publish
* Audio player with controls
* Schema.org markup (AudioObject + Speakable)
* Admin settings page
* Shortcode support
* Meta box in post editor
* Responsive player design

== Upgrade Notice ==

= 1.0.0 =
Initial release of AudioPress Lite

== Support ==

For support, feature requests, or bug reports, please visit:
https://github.com/adharsh242001/audiopress-lite

== Credits ==

* Powered by Puter.js (https://puter.com)
* Developed with ❤️ for the WordPress community

== Privacy ==

AudioPress Lite does not collect, store, or transmit any personal data. Audio generation happens entirely in the user's browser using Puter.js.