OpenReader

v4.2.0 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

Published 1mo Developer Productivity

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

deepinfra-api document epub epub-reader gpt-4o-mini-tts kitten-tts

+14 more

kokoro-tts markdown-reader open-ai open-ai-tts openai-api orpheus-tts pdf pdf-reader replicate-ai replicate-api supertonic text-to-speech tts txt-files

ReleasePort's take

Light signal

editorial:auto 1mo

Version v4.2.0 introduces multilingual reader and speech support for PDF/EPUB/HTML viewers, plus a new Background Tasks Engine with UI controls.

Why it matters: Enables global accessibility via multilingual audio and provides observable task management; developers can schedule/cancel jobs through the Admin Tasks UI.

Summary

AI summary

Updates 🚀 New, ⚡ Improved, and 🐛 Fixed across a mixed release.

Changes in this release

Type	Severity	Summary	CVE
Feature
Feature	Medium	Adds multilingual reader and speech support for PDF, EPUB, HTML viewers. Adds multilingual reader and speech support for PDF, EPUB, HTML viewers. Source: llm_adapter@2026-06-07 Confidence: high	—
Feature	Medium	Adds Admin Tasks UI for viewing, triggering, and configuring background tasks. Adds Admin Tasks UI for viewing, triggering, and configuring background tasks. Source: llm_adapter@2026-06-07 Confidence: high	—
Feature	Medium	Adds Document Blob Leasing & Mutation Locks using S3/object storage leases. Adds Document Blob Leasing & Mutation Locks using S3/object storage leases. Source: llm_adapter@2026-06-07 Confidence: high	—
Feature	Medium	Expands data exporting to include job events, document settings, auth sessions, linked accounts, and TTS segment cache tables. Expands data exporting to include job events, document settings, auth sessions, linked accounts, and TTS segment cache tables. Source: llm_adapter@2026-06-07 Confidence: high	—
Feature	Medium	Upgrades guest‑to‑account claiming to copy S3 synthesized speech assets and document settings to the new account. Upgrades guest‑to‑account claiming to copy S3 synthesized speech assets and document settings to the new account. Source: llm_adapter@2026-06-07 Confidence: high	—
Feature	Medium	Adds Background Tasks Engine with database-backed task runner and cron endpoints. Adds Background Tasks Engine with database-backed task runner and cron endpoints. Source: llm_adapter@2026-06-07 Confidence: low	—
Feature	Medium	Implements Preferences Inheritance & Syncing between local Dexie and server‑side profiles. Implements Preferences Inheritance & Syncing between local Dexie and server‑side profiles. Source: llm_adapter@2026-06-07 Confidence: low	—
Feature	Medium	Adds Replicate Parameter Mapping with graph‑walking OpenAPI parser and LRU caching. Adds Replicate Parameter Mapping with graph‑walking OpenAPI parser and LRU caching. Source: llm_adapter@2026-06-07 Confidence: low	—
Feature	Low	Implements automatic EPUB metadata language detection. Implements automatic EPUB metadata language detection. Source: granite4.1:30b@2026-06-07-audit Confidence: low	—
Feature	Low	Adds warning alerts when document language mismatches selected TTS voice language. Adds warning alerts when document language mismatches selected TTS voice language. Source: granite4.1:30b@2026-06-07-audit Confidence: low	—
Feature	Low	Integrates Intl.Segmenter for word/sentence tokenization of non‑space languages (e.g., Japanese, Chinese). Integrates Intl.Segmenter for word/sentence tokenization of non‑space languages (e.g., Japanese, Chinese). Source: granite4.1:30b@2026-06-07-audit Confidence: low	—
Feature	Low	Forwards detected/selected language options to OpenAI and Replicate TTS providers. Forwards detected/selected language options to OpenAI and Replicate TTS providers. Source: granite4.1:30b@2026-06-07-audit Confidence: low	—
Feature	Low	Introduces Background Tasks Engine with database‑backed task runner, atomic claims/leases, execution tracking, in‑process loops, and daily Vercel cron endpoint (/api/admin/tasks/tick). Introduces Background Tasks Engine with database‑backed task runner, atomic claims/leases, execution tracking, in‑process loops, and daily Vercel cron endpoint (/api/admin/tasks/tick). Source: granite4.1:30b@2026-06-07-audit Confidence: low	—
Feature	Low	Decouples preference architecture, allowing users to inherit global admin configurations synced between local Dexie and server‑side profiles. Decouples preference architecture, allowing users to inherit global admin configurations synced between local Dexie and server‑side profiles. Source: granite4.1:30b@2026-06-07-audit Confidence: low	—
Feature	Low	Adds Replicate Parameter Mapping with graph‑walking OpenAPI parser, dynamic voice/language resolution, and LRU caching for custom models (Kokoro, Gemini, Minimax, Qwen, Inworld). Adds Replicate Parameter Mapping with graph‑walking OpenAPI parser, dynamic voice/language resolution, and LRU caching for custom models (Kokoro, Gemini, Minimax, Qwen, Inworld). Source: granite4.1:30b@2026-06-07-audit Confidence: low	—
Performance	Medium	Improves highlighting performance with a fast linear scan optimizer to prevent UI thread freezes. Improves highlighting performance with a fast linear scan optimizer to prevent UI thread freezes. Source: llm_adapter@2026-06-07 Confidence: high	—
Bugfix
Bugfix	Medium	Fixes document preview generation issue #106. Fixes document preview generation issue #106. Source: llm_adapter@2026-06-07 Confidence: high	—
Bugfix	Low	Adds fallback handling for TTS API Gateway 400/422 errors by retrying without custom language parameters and caching the request. Adds fallback handling for TTS API Gateway 400/422 errors by retrying without custom language parameters and caching the request. Source: granite4.1:30b@2026-06-07-audit Confidence: low	—
Bugfix	Low	Overhauls account deletion to purge user‑scoped S3 assets (audiobooks, segments, temp uploads) before cascading database deletes, preventing orphaned storage files. Overhauls account deletion to purge user‑scoped S3 assets (audiobooks, segments, temp uploads) before cascading database deletes, preventing orphaned storage files. Source: granite4.1:30b@2026-06-07-audit Confidence: low	—

Full changelog

✨ What's New

🚀 New

Multilingual Reader & Speech Support:
- Added full support for reading multilingual documents in PDF, EPUB, and HTML viewers, passing the document language down to the segmenters and text tokenizers.
- Implemented automatic EPUB metadata language detection.
- Added warning alerts in the reader UI and audiobook creation panel if the document language mismatches the selected voice's language.
- Integrated Intl.Segmenter for word/sentence tokenization, allowing proper parsing of non-space-separated languages (e.g. Japanese, Chinese).
- Forwarded detected/selected language options dynamically to capable TTS providers (OpenAI, Replicate).
Background Tasks Engine: A database-backed task runner featuring atomic claims/leases, execution tracking, in-process self-hosted loops, and daily Vercel cron route endpoints (/api/admin/tasks/tick).
Admin Tasks UI: An administrative control panel in Settings to view background tasks, trigger runs manually, and configure execution intervals.
Document Blob Leasing & Mutation Locks: A concurrency locking mechanism using S3/object storage leases with exponential backoff and jitter to prevent race conditions during upload finalization.

⚡ Improved

User Data Management (Export & Claiming):
- Expanded data exporting to package and download new metadata types (job events, document settings, auth sessions, linked accounts, and TTS segment cache tables) and download generated TTS segment audio files from S3/object storage.
- Upgraded guest-to-account claiming to copy S3 synthesized speech assets and document settings to the new account.
Preferences Inheritance & Syncing: Decoupled preference architecture where users can inherit global admin configurations, synced automatically between local Dexie and server-side profiles.
Replicate Parameter Mapping: Graph-walking OpenAPI parser that dynamically resolves voice and language parameter inputs for custom Replicate models (Kokoro, Gemini, Minimax, Qwen, Inworld) with LRU caching.

🐛 Fixed

Preview generation: fix document preview generation issue #106
Highlighting Performance: Added a fast linear scan optimizer that resolves exact highlight matches instantly, preventing UI thread freezes on large documents.
TTS API Gateway Fallback: Automatically catches 400/422 errors from OpenAI-compatible gateways that reject custom language parameters, retrying and caching the request without the parameter.
User Storage Deletion Cleanup: Overhauled account deletion to purge user-scoped S3 asset prefixes (audiobooks, segments, and temp uploads) before database rows cascade-delete, preventing orphaned storage files.

⚠️ Upgrading from v4.1.2

If using self-hosted nodes, the task scheduler starts in-process automatically; Vercel deployments use a daily cron route (/api/admin/tasks/tick).

Full Changelog: https://github.com/richardr1126/openreader/compare/v4.1.2...v4.2.0

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track OpenReader

Get notified when new releases ship.

About OpenReader

EPUB, PDF, DOCX, MD, and TXT file text to speech document reader. Read documents in realtime with high-quality TTS; or extract audiobooks.

All releases →

Related context

Related tools

Earlier breaking changes

v4.0.0 Legacy `/api/whisper` path and old `whisper.cpp` integration removed from active runtime.
v4.0.0 Auth is now required; set BASE_URL and AUTH_SECRET before starting v4.