Welcome to the comprehensive documentation for ListenUp, a powerful WordPress plugin that adds text-to-speech functionality to your posts and pages using Murf.ai’s AI voices.
Table of Contents
Getting Started
Audio Generation
Voice Configuration
- Selecting a Voice – Choose from professional AI voices
- Voice Styles – Adjust tone and delivery
- Audio Formats – MP3, WAV, OGG, and more
Content Processing
- Automatic Chunking – Handle long-form content
- Pronunciation Dictionary – Customize word pronunciation
- Pre-roll Audio – Add intros to your content
Cloud Storage
- Setting Up Cloud Storage – Reduce server load
- AWS S3 Configuration
- Cloudflare R2 Configuration
- Google Cloud Storage
Display & Integration
- Audio Player – Accessible, responsive player
- Shortcode Usage – Add players anywhere
- Audio Library – Display posts with audio
- Automatic Placement – Auto-insert players
Content Management
- Audio Library Admin – Manage all audio
- Regenerating Audio – Update existing content
- Download Controls – Restrict downloads
Troubleshooting
What is ListenUp?
ListenUp is a WordPress plugin that converts your written content into professional audio using Murf.ai’s text-to-speech technology. Visitors can listen to your posts and pages, improving accessibility and engagement.
Key Benefits
Professional Audio Quality
- Natural-sounding AI voices from Murf.ai
- Multiple voice styles for different content types
- Support for multiple languages and accents
- Customizable pronunciation for technical terms
Seamless Integration
- One-click audio generation from the post editor
- Automatic player placement or shortcode control
- Audio library shortcode for content discovery
- Works with any WordPress theme
Smart Content Handling
- Automatic chunking for long content
- Pre-roll audio support for branding
- Multiple audio format options
- Efficient caching system
Flexible Storage
- Local storage with leech protection
- Optional cloud storage (S3, R2, GCS)
- Signed URLs for secure delivery
- Bandwidth optimization
Quick Links
- Audio not playing? See Troubleshooting
- Need cloud storage? Read the Cloud Storage Guide
- Just installed? Start with Getting Started
- Need feature details? Check Features Overview
Feature Overview
One-Click Audio Generation
Generate professional audio for any post or page with a single click from the WordPress editor. The meta box shows generation status and provides playback controls.
Learn more about Audio Generation →
Intelligent Content Chunking
Long content is automatically split into manageable chunks for the Murf.ai API. The frontend player seamlessly plays all chunks in sequence, and downloads are automatically concatenated.
Learn more about Content Chunking →
Pronunciation Dictionary
Define custom pronunciations for technical terms, acronyms, and brand names. Ensure “AWS” is spoken as “Amazon Web Services” or “NES” as “Nintendo Entertainment System.”
Learn more about Pronunciation →
Cloud Storage Integration
Offload audio files to Amazon S3, Cloudflare R2, or Google Cloud Storage. Reduce bandwidth costs and improve delivery performance with signed URLs.
Learn more about Cloud Storage →
Pre-roll Audio
Add branded introductions that play before your content. Generate pre-roll audio with custom text or upload your own audio file.
Accessible Audio Player
A fully accessible audio player with keyboard navigation, screen reader support, and responsive design. WCAG-compliant controls work on all devices.
Learn more about the Audio Player →
Leech Protection
Audio files are served through secure PHP proxy with nonce-based authentication. Prevent unauthorized access and hotlinking without server configuration.
Audio Library
Display a collection of posts with audio using the library shortcode. Perfect for podcast-style content listings or audio archives.
Learn more about Audio Library →
Support
For support questions, please use the WordPress.org support forums.
Privacy & External Services
ListenUp integrates with external services to provide text-to-speech functionality.
Murf.ai API
- Purpose: Converts text to speech using AI voices
- Data Sent: Post content, voice selection, pronunciation rules
- When Sent: Only when you manually generate audio
- Privacy Policy: murf.ai/privacy-policy
Optional Cloud Storage
Cloud storage is completely optional and disabled by default. If enabled:
- Amazon S3: Audio files uploaded to your S3 bucket
- Cloudflare R2: Audio files uploaded to your R2 bucket
- Google Cloud Storage: Audio files uploaded to your GCS bucket
No data is sent to these services unless you explicitly configure and enable them.
Last Updated: February 2026
Plugin Version: 1.5.13
Requires WordPress: 5.8 or higher
Requires PHP: 7.4 or higher