How jraversbcn21/lecturamepdf works
LecturamePDF is a browser-based PDF listening reader. The main workflow takes a selected PDF through local extraction and document persistence, then opens it in a reader that coordinates speech, progress, search, outline, bookmarks, and the original PDF. Optional sync transfers library metadata and PDFs between devices; optional AI speech uses OpenRouter. The README documents PWA/offline support, but the sampled sources do not show its runtime implementation, so it is represented without an asserted connection. Edges reflect excerpts, SOURCE INDEX references, or README statements; unsampled relationships are omitted.
Main entry points: Reader.tsx Reader coordinator · App.tsx App shell · storage.ts IndexedDB storage · usePlayer.ts Playback hook
Components 26
PDF ingestion
- App shell
src/app/App.tsx - Library
src/app/components/Library.tsx - PDF extraction
src/core/pdf/extract.ts - PDF layout
src/core/pdf/layout.ts - Sentence splitting
src/core/sentences.ts
Reading experience
- Reader coordinator
src/app/components/Reader.tsx - Text view
src/app/components/ReaderView.tsx - Player controls
src/app/components/PlayerControls.tsx - Playback hook
src/app/usePlayer.ts - Player state
src/app/playerReducer.ts
Document features
- Section outline
src/core/outline.ts - Outline panel
src/app/components/Outline.tsx - Document search
src/core/search.ts - Search panel
src/app/components/Search.tsx - Bookmark logic
src/core/bookmarks.ts - Bookmark state
src/app/useBookmarks.ts - Bookmarks panel
src/app/components/Bookmarks.tsx - Original PDF pane
src/app/components/PdfPane.tsx
Local and sync storage
- IndexedDB storage
src/core/storage.ts - Sync client
src/core/sync.ts - Sync API
api/library.ts - PDF API
api/file.ts
Speech integrations
- Browser speech
- Speech engine
src/core/tts.ts - OpenRouter
Other components
- Reader
Connections 33
- Reader → App shell: chooses PDF
README.md - App shell → Library: shows library
src/app/App.tsx - App shell → PDF extraction: extracts PDF
src/app/App.tsx - PDF extraction → PDF layout: reconstructs layout
src/core/pdf/extract.ts - PDF extraction → Sentence splitting: splits text
src/core/pdf/extract.ts - App shell → IndexedDB storage: saves document
src/app/App.tsx - App shell → Reader coordinator: opens document
src/app/App.tsx - Library → IndexedDB storage: loads library
src/app/components/Library.tsx - Reader coordinator → Playback hook: starts playback
src/app/components/Reader.tsx - Reader coordinator → Text view: renders reading view
src/app/components/Reader.tsx - Reader coordinator → Player controls: renders controls
src/app/components/Reader.tsx - Player controls → Playback hook: dispatches actions
src/app/components/PlayerControls.tsx - Playback hook → Player state: updates state
src/app/usePlayer.ts - Playback hook → Speech engine: speaks sentences
src/app/usePlayer.ts - Playback hook → IndexedDB storage: saves progress
src/app/usePlayer.ts - Speech engine → Browser speech: uses synthesis
src/core/tts.ts - Speech engine → OpenRouter: requests AI speech
src/core/tts.ts - Reader coordinator → Section outline: builds section state
src/app/components/Reader.tsx - Reader coordinator → Outline panel: renders outline
src/app/components/Reader.tsx - Outline panel → Section outline: derives headings
src/app/components/Outline.tsx - Reader coordinator → Document search: queries document
src/app/components/Reader.tsx - Reader coordinator → Search panel: renders search
src/app/components/Reader.tsx - Search panel → Document search: finds matches
src/app/components/Search.tsx - Reader coordinator → Bookmark state: manages bookmarks
src/app/components/Reader.tsx - Bookmark state → Bookmark logic: updates markers
src/app/useBookmarks.ts - Bookmark state → IndexedDB storage: persists markers
src/app/useBookmarks.ts - Reader coordinator → Bookmarks panel: renders bookmarks
src/app/components/Reader.tsx - Reader coordinator → Original PDF pane: renders original PDF
src/app/components/Reader.tsx - Original PDF pane → IndexedDB storage: loads saved PDF
src/app/components/PdfPane.tsx - App shell → Sync client: syncs library
src/app/App.tsx - Sync client → IndexedDB storage: applies merged data
src/core/sync.ts - Sync client → Sync API: syncs metadata
README.md - Sync client → PDF API: transfers PDF
README.md