How nar7407/pdfpaper works
PDFPaper is an on-device Android PDF reader/editor built around a Kotlin PDF engine. The primary workflow is selecting or receiving a document, opening it in the viewer, rendering and searching its contents, then saving changes. The repository also includes page operations, indexing, speech, safety inspection, signing, office conversion, and related tools. Some README features are marked planned despite corresponding source directories being present. Edges are limited to README statements and relationships visible in the supplied source index or excerpts; unsampled wiring is not inferred.
Main entry points: ViewerScreen.kt PDF viewer · PdfDocument.kt PDF document model · MainActivity.kt App entry · AppNav.kt App navigation
Components 22
Android app
- App entry
app/src/main/java/com/pdfpaper/app/MainActivity.kt - App navigation
app/src/main/java/com/pdfpaper/app/ui/navigation/AppNav.kt - PDF viewer
app/src/main/java/com/pdfpaper/app/ui/viewer/ViewerScreen.kt - Document access
app/src/main/java/com/pdfpaper/app/data/DocumentAccess.kt - App PDF adapter
app/src/main/java/com/pdfpaper/app/edit/PdfEngine.kt - Android rendering
app/src/main/java/com/pdfpaper/app/render/AndroidRenderer.kt
PDF engine
- PDF engine
engine/src/main/java/com/pdfpaper/engine/PdfEngine.kt - PDF document model
engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt - Random access input
engine/src/main/java/com/pdfpaper/engine/io/RandomAccessSource.kt - PDF objects
engine/src/main/java/com/pdfpaper/engine/model/PdfObject.kt - PDF decryption
engine/src/main/java/com/pdfpaper/engine/security/StandardSecurityHandler.kt - Regex search
engine/src/main/java/com/pdfpaper/engine/text/RegexSearch.kt
Document capabilities
- Page operations
app/src/main/java/com/pdfpaper/app/ui/pages/PagesViewModel.kt - Save changes
app/src/main/java/com/pdfpaper/app/data/save/SaveCoordinator.kt - Search index
app/src/main/java/com/pdfpaper/app/index/IndexRepository.kt - Annotation index
app/src/main/java/com/pdfpaper/app/annot/AnnotationRepository.kt
Extended features
- Safety inspection
safety/src/main/java/com/pdfpaper/safety/PdfSafety.kt - Digital signing
signatures/src/main/java/com/pdfpaper/signatures/SigningEngine.kt - Office conversion
- Read aloud
app/src/main/java/com/pdfpaper/app/speech/ReadAloudService.kt - Speech controls
app/src/main/java/com/pdfpaper/app/ui/viewer/speech/ReadAloudController.kt
Other components
- User
Connections 21
- User → App entry: opens app
README.md - App entry → App navigation: starts navigation
app/src/main/java/com/pdfpaper/app/MainActivity.kt - App navigation → PDF viewer: routes to viewer
- User → Document access: selects document
README.md - Document access → App PDF adapter: provides document
- App PDF adapter → PDF engine: uses engine
README.md - PDF engine → PDF document model: opens PDF
- PDF document model → Random access input: reads bytes
engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt - PDF document model → PDF objects: resolves objects
engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt - PDF document model → PDF decryption: decrypts objects
engine/src/main/java/com/pdfpaper/engine/model/PdfDocument.kt - PDF viewer → Android rendering: renders pages
- PDF viewer → Regex search: searches text
- User → Page operations: manages pages
README.md - User → Save changes: saves changes
README.md - User → Search index: searches PDFs
- User → Annotation index: manages annotations
- User → Safety inspection: inspects document
- User → Digital signing: signs document
- User → Office conversion: converts document
- PDF viewer → Speech controls: controls reading
- Speech controls → Read aloud: starts playback