How dewmith/narruvo works
Narruvo is an offline desktop PDF audiobook reader. A user imports or selects a PDF; the app extracts and prepares page text, presents it in the reader, and turns sections into cached Kokoro speech for playback with synchronized highlighting. The library stores document identity and reading progress, while settings and voice-model setup support local use. The graph emphasizes documented workflow and major README features; several internal modules are indexed but unsampled, so uncertain implementation links are omitted or marked unverified.
Main entry points: main_window.py Main window · playback.py Playback controller · app.py App entry · viewer.py PDF and text viewer
Components 22
Desktop reader
- App entry
src/narruvo/app.py - Main window
src/narruvo/ui/main_window.py - Library view
src/narruvo/ui/library_view.py - PDF and text viewer
src/narruvo/ui/viewer.py - Playback controls
src/narruvo/ui/playback_bar.py - Interface theme
src/narruvo/ui/theme.py
PDF preparation
- PDF extraction and rendering
src/narruvo/pdf.py - Text preparation
src/narruvo/text.py - Document coordination
src/narruvo/documents.py - Process workers
src/narruvo/workers.py - Shared reading records
src/narruvo/domain.py
Narration playback
- Playback controller
src/narruvo/playback.py - Kokoro synthesis and cache
src/narruvo/tts.py - Audio output
src/narruvo/audio.py - Speech timing alignment
src/narruvo/timing.py
Local state and setup
- Library and progress store
src/narruvo/persistence.py - Settings and paths
src/narruvo/config.py - Voice setup UI
src/narruvo/ui/model_setup.py - Model download and validation
src/narruvo/models.py - Diagnostic logging
src/narruvo/logging_setup.py
Other components
- Reader
- Kokoro model release
Connections 33
- Reader → App entry: launches
src/narruvo/app.py - App entry → Settings and paths: loads paths
src/narruvo/app.py - App entry → Diagnostic logging: configures
src/narruvo/app.py - App entry → Interface theme: applies
src/narruvo/app.py - App entry → Main window: opens
src/narruvo/app.py - Reader → Main window: imports or selects PDF
README.md - Main window → Library view: refreshes
src/narruvo/ui/main_window.py - Main window → PDF and text viewer: presents document
src/narruvo/ui/main_window.py - Main window → Playback controls: coordinates controls
src/narruvo/ui/main_window.py - Main window → Document coordination: coordinates documents
src/narruvo/ui/main_window.py - Main window → Library and progress store: saves progress
src/narruvo/ui/main_window.py - Main window → Playback controller: controls narration
src/narruvo/ui/main_window.py - Main window → Settings and paths: reads preferences
src/narruvo/ui/main_window.py - Main window → Voice setup UI: opens setup
src/narruvo/ui/main_window.py - Document coordination → Process workers: uses workers
src/narruvo/documents.py - Process workers → PDF extraction and rendering: dispatches PDF jobs
src/narruvo/workers.py - Process workers → Kokoro synthesis and cache: dispatches speech jobs
src/narruvo/workers.py - PDF extraction and rendering → Text preparation: prepares extracted text
src/narruvo/pdf.py - PDF extraction and rendering → PDF and text viewer: provides rendered pages
src/narruvo/ui/viewer.py - Text preparation → PDF and text viewer: supplies aligned text
- Playback controller → Process workers: submits synthesis jobs
src/narruvo/playback.py - Playback controller → Audio output: controls output
src/narruvo/playback.py - Kokoro synthesis and cache → Speech timing alignment: uses speech timings
src/narruvo/tts.py - Playback controller → Playback controls: updates controls
- Playback controller → PDF and text viewer: drives highlighting
README.md - PDF and text viewer → Reader: shows synchronized reading
README.md - Main window → Shared reading records: tracks reading state
src/narruvo/ui/main_window.py - Library and progress store → Shared reading records: stores progress records
src/narruvo/persistence.py - Settings and paths → Reader: retains preferences
- Voice setup UI → Model download and validation: downloads or selects files
src/narruvo/ui/model_setup.py - Model download and validation → Kokoro model release: downloads verified assets
README.md - Voice setup UI → Playback controller: initializes voices
- Kokoro synthesis and cache → Kokoro model release: loads local models