openreader/docs-site/docs/introduction.md
Richard R 5f28be5d58 refactor(env): remove legacy no-auth mode and enforce required auth env vars
Eliminate all code paths, configuration, and documentation related to running
without authentication. Require AUTH_SECRET and BASE_URL at startup, updating
middleware, server logic, and runtime checks to assume auth is always enabled.
Simplify onboarding, settings, and test helpers to reflect mandatory auth.
Update environment examples, Docker and deployment docs, and CI/test configs.
Remove no-auth-specific UI flows, test cases, and feature toggles.
2026-05-31 12:09:37 -06:00

2.8 KiB

id title slug
intro Introduction /

OpenReader is an open source text-to-speech document reader built with Next.js. It provides a read-along experience with narration for EPUB, PDF, TXT, MD, and DOCX documents.

Previously named OpenReader-WebUI.

It supports multiple TTS providers including OpenAI, Replicate, DeepInfra, and custom OpenAI-compatible endpoints such as Kokoro-FastAPI, KittenTTS-FastAPI, and Orpheus-FastAPI.

Highlights

  • 🧱 Layout-aware PDF Parsing
    • PP-DocLayoutV3 (ONNX) detects structured blocks with cross-page stitching and geometry-based highlighting for precise read-along sync and clean TTS segmentation
  • ⏱️ Word-by-word Highlighting via ONNX Whisper alignment
    • Powered by the external compute worker control plane (NATS JetStream-backed)
  • Segment-based TTS Playback
    • Sentence-aware generation with cached audio segments, background preloading, and resumable playback across EPUB, PDF, TXT, MD, and DOCX
  • 🎯 Multi-Provider TTS Support
  • 🎧 Audiobook Export in m4b/mp3 with resumable chapter generation
  • 🗂️ Flexible Backend — embedded SeaweedFS or S3-compatible storage, SQLite or Postgres, server library import, and device sync
  • 🔐 Auth and User Isolation — auth is required in v4+, with optional anonymous auth sessions for guest flows
  • 🎨 Customizable — 13 built-in themes (light and dark palettes), per-user TTS settings, and document handling controls

🧭 Key Docs

Source Repository