How sanyi1963bp/vox-libris works
Vox Libris is an offline-first Android ebook catalog and sentence-level reader. The main workflow is: the reader selects a book folder, the app scans files and metadata into its catalog, then opens a book, extracts and segments its text, and reads it through Android TTS while saving progress and bookmarks. The graph also preserves browsing, covers, reader tools, export/statistics, and optional AI chat. Relationships are limited to README statements and SOURCE INDEX references; unsampled wiring is not asserted.
Main entry points: TtsService.kt Speech service · MainActivity.kt Main activity · ReaderScreen.kt Reader screen · LibraryViewModel.kt Library state
Components 25
App and navigation
- Main activity
app/src/main/java/hu/konyvtar/tts/MainActivity.kt - Library and shelf
app/src/main/java/hu/konyvtar/tts/ui/LibraryScreen.kt - File browser
app/src/main/java/hu/konyvtar/tts/ui/ExplorerScreen.kt - Reader screen
app/src/main/java/hu/konyvtar/tts/ui/ReaderScreen.kt
Library and catalog
- Library state
app/src/main/java/hu/konyvtar/tts/vm/LibraryViewModel.kt - Browser state
app/src/main/java/hu/konyvtar/tts/vm/BrowserViewModel.kt - Library scanner
app/src/main/java/hu/konyvtar/tts/data/LibraryScanner.kt - Metadata extraction
app/src/main/java/hu/konyvtar/tts/data/MetadataExtractor.kt - Book catalog
app/src/main/java/hu/konyvtar/tts/data/Catalog.kt - Cover scanning
app/src/main/java/hu/konyvtar/tts/data/CoverScanner.kt - Cover extraction
app/src/main/java/hu/konyvtar/tts/data/CoverExtractor.kt - Reading records
app/src/main/java/hu/konyvtar/tts/data/AppDb.kt
Reading and playback
- Text extraction
app/src/main/java/hu/konyvtar/tts/reader/TextExtractor.kt - EPUB parser
app/src/main/java/hu/konyvtar/tts/reader/EpubParser.kt - HTML cleanup
app/src/main/java/hu/konyvtar/tts/reader/HtmlText.kt - Sentence segmentation
app/src/main/java/hu/konyvtar/tts/reader/Sentences.kt - Speech service
app/src/main/java/hu/konyvtar/tts/tts/TtsService.kt - Android speech engine
Reader tools and integrations
- Preferences
app/src/main/java/hu/konyvtar/tts/data/Prefs.kt - Pronunciation rules
app/src/main/java/hu/konyvtar/tts/data/Pronounce.kt - AI chat
app/src/main/java/hu/konyvtar/tts/ui/AiChatScreen.kt - Book context
app/src/main/java/hu/konyvtar/tts/ai/BookContext.kt - AI client
app/src/main/java/hu/konyvtar/tts/ai/AiClient.kt - Export and statistics
app/src/main/java/hu/konyvtar/tts/data/Exporter.kt
Other components
- Reader
Connections 27
- Reader → Main activity: opens app
- Main activity → Library and shelf: shows views
app/src/main/java/hu/konyvtar/tts/MainActivity.kt - Main activity → File browser: routes to
app/src/main/java/hu/konyvtar/tts/MainActivity.kt - Main activity → Reader screen: routes to
app/src/main/java/hu/konyvtar/tts/MainActivity.kt - Library and shelf → Library state: uses state
app/src/main/java/hu/konyvtar/tts/ui/LibraryScreen.kt - File browser → Browser state: uses state
app/src/main/java/hu/konyvtar/tts/ui/ExplorerScreen.kt - Library state → Library scanner: starts scan
app/src/main/java/hu/konyvtar/tts/vm/LibraryViewModel.kt - Library scanner → Metadata extraction: extracts metadata
app/src/main/java/hu/konyvtar/tts/data/LibraryScanner.kt - Library scanner → Book catalog: updates catalog
app/src/main/java/hu/konyvtar/tts/data/LibraryScanner.kt - Library state → Book catalog: loads books
app/src/main/java/hu/konyvtar/tts/vm/LibraryViewModel.kt - Library state → Cover scanning: starts cover scan
app/src/main/java/hu/konyvtar/tts/vm/LibraryViewModel.kt - Cover scanning → Cover extraction: extracts covers
app/src/main/java/hu/konyvtar/tts/data/CoverScanner.kt - Cover scanning → Book catalog: reads catalog
app/src/main/java/hu/konyvtar/tts/data/CoverScanner.kt - Reader screen → Speech service: controls playback
app/src/main/java/hu/konyvtar/tts/ui/ReaderScreen.kt - Speech service → Text extraction: loads book text
app/src/main/java/hu/konyvtar/tts/tts/TtsService.kt - Text extraction → EPUB parser: dispatches EPUB
app/src/main/java/hu/konyvtar/tts/reader/TextExtractor.kt - EPUB parser → HTML cleanup: cleans markup
app/src/main/java/hu/konyvtar/tts/reader/EpubParser.kt - Speech service → Sentence segmentation: segments speech
app/src/main/java/hu/konyvtar/tts/tts/TtsService.kt - Speech service → Android speech engine: speaks text
- Speech service → Reading records: saves progress
app/src/main/java/hu/konyvtar/tts/tts/TtsService.kt - Speech service → Preferences: loads settings
app/src/main/java/hu/konyvtar/tts/tts/TtsService.kt - Speech service → Pronunciation rules: applies rules
app/src/main/java/hu/konyvtar/tts/tts/TtsService.kt - Reader screen → Reading records: manages bookmarks
app/src/main/java/hu/konyvtar/tts/ui/ReaderScreen.kt - Reader screen → AI chat: opens chat
app/src/main/java/hu/konyvtar/tts/MainActivity.kt - AI chat → Book context: builds context
app/src/main/java/hu/konyvtar/tts/ui/AiChatScreen.kt - AI chat → AI client: sends prompts
app/src/main/java/hu/konyvtar/tts/ui/AiChatScreen.kt - Reader → Export and statistics: exports records