Bespoken

Fixed

• Fixed paragraph breaks not displaying in the Preview Script modal. The \n\n boundaries were present in the text but collapsed by the browser due to missing white-space: pre-wrap styling.

Changed

• Updated documentation to recommend restricting ElevenLabs API key permissions to only the required scopes (Text to Speech: Access, User: Read).

Added

• Progress message log: All progress messages are now accumulated in a messageLog column so the frontend never misses intermediate messages between poll intervals. The progress component replays any unseen messages on each poll, ensuring the full message history is always complete — even when chunks process faster than the 1-second polling interval.
• Dev debug mode for audio chunking: Set BESPOKEN_DEV_DEBUG=true to run the full chunking and concatenation pipeline using a local test.mp3 file instead of calling the ElevenLabs API. Progress messages show chunk count, target size, and text length. Pair with BESPOKEN_DEV_CHUNK_SIZE=200 to override the chunk target size for testing with smaller text.
• Request stitching for seamless chunk transitions: Multi-chunk audio now uses ElevenLabs' request stitching (previous_text, next_text, previous_request_ids) to condition each chunk on surrounding context, producing smoother prosody and voice consistency across chunk boundaries. Automatically disabled for eleven_v3 (unsupported) and single-chunk generations.
• Text chunking for long content: Text is now automatically split into chunks at paragraph and sentence boundaries before sending to ElevenLabs, preventing failures when text exceeds model character limits and improving audio quality on longer texts.
• Audio concatenation: Multiple audio chunks are stitched into a single MP3 using ffmpeg (with binary fallback), so the final output is seamless.
• Dynamic queue timeout: The queue job's time-to-reserve now scales with text length and chunk count, preventing the queue runner from killing long-running generation jobs.
• Stale job detection: Jobs stuck in "running" status for over 10 minutes are automatically marked as failed when viewing generation history, fixing false "running" indicators from killed processes.
• Chunk progress reporting: The progress UI now shows which chunk is being generated (e.g., "Generating audio: chunk 3 of 7").
• ElevenLabs credit display: The field now shows remaining ElevenLabs credits, reset date, and a usage bar — fetched from the ElevenLabs subscription API on page load.
• Model-aware cost estimates: Estimated credit cost is calculated automatically based on text length and the selected voice's model (1× for v3/multilingual, 0.5× for turbo/flash), with a warning when the estimate exceeds remaining credits.

Changed

• Progress component now uses external package: Replaced the local progress-component-v2.ts with the progress-component package (v0.2.0→v0.2.1), making the component easier to maintain and share across projects.
• Build system switched to browser platform: esbuild now uses --platform=browser --format=iife instead of --platform=node, correctly bundling browser dependencies like Lit.
• Progress component layout: The progress indicator now renders on its own full-width row below the action buttons instead of inline.
• Paragraph markers preserved: The text processing pipeline now preserves \n\n paragraph boundaries through both the frontend (TypeScript) and backend (PHP), enabling natural chunk splitting points.
• Smarter job monitor timeout: The frontend job monitor now uses a stall-based timeout (3 minutes of no progress change) instead of a fixed poll count, so long multi-chunk jobs no longer falsely report timeouts while actively progressing.

Fixed

• Expanded message history now scrolls: Updated progress-component to v0.2.1, which adds overflow-y: auto to the expanded history panel. Previously, long message histories (15+ messages) were clipped with no scrollbar.
• Multisite support: Audio generation, content preview, and generation history now work correctly on non-primary sites. Previously, editing an entry on site 2 and generating audio would fail with "Element not found" because the controller didn't resolve the correct site context.
• Site context in action URLs: Field template action URLs now explicitly include the site handle parameter, ensuring the correct site context is carried through to all AJAX requests.
• Generation history filtered by site: The "View History" modal now only shows generations for the current site, not all sites.
• Queue job site awareness: The audio generation queue job now carries the originating site ID, so debug mode uses the correct site's base URL.

Added

• Word removal via pronunciation rules: Leave the pronunciation field empty to remove a word entirely from the narration script (e.g., remove -> from text).
• Auto-padded pronunciation replacements: Spaces are now automatically added around pronunciation values, so users no longer need to manually pad with spaces.
• Visual indicators in settings: Pronunciation fields now show subtle pill-style hints — an amber space visualizer (middle-dot characters) when values contain leading/trailing spaces, and a slate "word will be removed" badge when the pronunciation is empty.
• HTML entity decoding: Text from CKEditor fields is now properly decoded before pronunciation rules are applied, fixing issues where encoded characters like > would prevent matches.

Fixed

• Fixed pronunciation rules not matching special characters (e.g., ->) when CKEditor encoded them as HTML entities.
• Fixed narration script preview showing raw HTML entities instead of decoded characters.

Changed

• Updated voice model options to include Eleven v3, Flash v2.5, and Flash v2.
• Changed the default voice model from Multilingual v2 to Eleven v3.
• Updated ElevenLabs documentation links to current URLs.

Added

• Persistent job tracking: Audio generation job status is now stored in the database instead of cache. This means job progress survives page reloads and provides reliable tracking even when the queue is delayed.
• Generation history: Added a "View History" button to see past audio generation jobs for each entry, including status, filename, and timestamp.
• Improved queue tolerance: The frontend now gracefully waits up to 3 minutes for jobs to start processing in the queue, with a user-friendly "Waiting for queue to process job..." message.

Fixed

• Fixed a race condition where polling would fail with a progress.toString() error when the queue hadn't started processing the job yet. The API now always returns a progress field.
• Fixed error handling to properly display "pending" status instead of treating delayed queue jobs as errors.

Changed

• Schema version updated to 1.1.0. A database migration will run automatically to create the new bespoken_audiogenerations table.

Added

• Added support for legacy Redactor fields in Craft CMS version 5. Text parsing in Redactor fields works exactly like CKEditor fields.

Resave Bespoken settings in the control panel to take advantage of the new voice options after installation.

Added

• This release redefines how voices and pronunciation rules are configured for the plugin.
• Each voice can have a different voice model. Visit the settings page after installation to select the voice model for each voice. Until a new voice model is selected for each voice, it will default to eleven_multilingual_v2.
• Pronunciation rules can now be created for multiple languages. When defining a voice, you choose which pronunciation rule set to use. This allows for Bespoken to support multiple languages.

Added

• Added support for Matrix fields that contain CKEditor and Plain Text fields. Read the documentation for details on how to use this feature. TLDR: To retrieve content from Matrix fields you supply Matrix field handle and the handles of the fields to look for inside the blocks within the Matrix field.

Added

• A new feature was added to allow users to preview the script that will be sent to the ElevenLabs API. This feature is helpful for debugging pronunciation issues and other potential problems. The preview can be accessed by clicking the "Preview" button in the Bespoken field in the entry editor. The preview button can also be disabled in the field settings if desired.

Fixed

• Fixed an issue in processing text to be sent to the API that neglected to add a pause for list items. This caused the text to be read as one continuous sentence when a list item did not end with some form of punctuation. This issue has been resolved, and list items will now be read as separate clauses in the generated audio file.

Fixed

• Fixed a bug that caused some inline HTML elements to have a pause added before them during audio generation.

Added

• Added a new feature to allow users to exclude elements within a CKEditor field by adding the class bespoken-exclude to an element. This feature is useful for excluding elements like code blocks from the audio file. See the "Excluding elements from the audio file" section in the documentation for more information.

Fixed

• Updated Javascript to decode HTML entities to allow proper replacement of text for the pronunciation fixes feature.
• Fixed bug that causes a period to be added after link elements.
• Removed double spaces from text before sending to API.

Fixed

• Removed a debugging statement left in the plugin's javascript that would halt audio generation if the console was open.

• Initial release