How kimoz1994/pdf-reader works
PDF Reader is a local study application: a learner opens a library document, reads and captures passages or images as persistent Extracts, revisits and edits them, and can turn them into flashcards for FSRS review. MainWindow coordinates the four views; service modules provide persistence, selection/layout helpers, scheduling, export, and settings. Edges are limited to README-documented routing and relationships visible in the excerpts or SOURCE INDEX; some view internals were not sampled.
Main entry points: main_window.py Main window · pdf_reader_view.py PDF reader · extracts_view.py Extracts editor · flashcards_view.py Flashcard review
Components 18
Desktop app
- App entry
pdf_reader/gui_app/main.py - Main window
pdf_reader/gui_app/main_window.py
PDF reading
- PDF library
pdf_reader/gui_app/views/library_view.py - PDF reader
pdf_reader/gui_app/views/pdf_reader_view.py
Study workflow
- Extracts editor
pdf_reader/gui_app/views/extracts_view.py - Flashcard review
pdf_reader/gui_app/views/flashcards_view.py - Answer renderer
pdf_reader/gui_app/views/flashcard_answer.py
Application services
- Element detection
pdf_reader/gui_app/services/element_detector.py - Page geometry
pdf_reader/gui_app/services/pdf_geometry.py - Selection snapshot
pdf_reader/gui_app/services/selection_snapshot.py - Study data store
pdf_reader/gui_app/services/extract_store.py - Data export
pdf_reader/gui_app/services/export_data.py - FSRS scheduler
pdf_reader/gui_app/services/fsrs_scheduler.py - Window settings
pdf_reader/gui_app/services/window_settings.py - Performance logging
pdf_reader/gui_app/services/perf_log.py
Other components
- Learner
- PDF document
- Local SQLite data
Connections 25
- Learner → App entry: launches
README.md - App entry → Main window: creates
pdf_reader/gui_app/main.py - App entry → Window settings: creates icon
pdf_reader/gui_app/main.py - App entry → Performance logging: checks logging
pdf_reader/gui_app/main.py - Main window → PDF library: shows view
README.md - Main window → PDF reader: shows view
README.md - Main window → Extracts editor: shows view
README.md - Main window → Flashcard review: shows view
README.md - PDF library → Local SQLite data: stores library
pdf_reader/gui_app/views/library_view.py - PDF library → PDF reader: opens document
README.md - PDF reader → PDF document: renders
README.md - PDF reader → Element detection: detects selections
pdf_reader/gui_app/views/pdf_reader_view.py - PDF reader → Page geometry: maps page regions
pdf_reader/gui_app/views/pdf_reader_view.py - PDF reader → Study data store: reads and saves extracts
pdf_reader/gui_app/views/pdf_reader_view.py - PDF reader → Extracts editor: opens extracts view
- Extracts editor → Study data store: loads and edits
pdf_reader/gui_app/views/extracts_view.py - Extracts editor → Selection snapshot: builds snapshots
pdf_reader/gui_app/views/extracts_view.py - Extracts editor → Data export: exports data
pdf_reader/gui_app/views/extracts_view.py - Extracts editor → Flashcard review: starts review
- Study data store → Local SQLite data: reads and writes
pdf_reader/gui_app/services/extract_store.py - Flashcard review → Study data store: loads and records cards
pdf_reader/gui_app/views/flashcards_view.py - Flashcard review → FSRS scheduler: rates cards
pdf_reader/gui_app/views/flashcards_view.py - Flashcard review → Answer renderer: renders answers
pdf_reader/gui_app/views/flashcards_view.py - Main window → Window settings: restores window
pdf_reader/gui_app/main_window.py - Main window → Performance logging: records timings
pdf_reader/gui_app/main_window.py