* Added PDF top tab strip visibility toggle and fixed WebView hit test NPE * Refactored desktop reader screens and state management into specialized components * Added image gallery to reader sidebar and refactored desktop PDF UI components * Implemented EPUB image gallery * Refactored reader and library models to use shared common types, centralizing file type resolution and texture management while removing redundant mapping logic * Standardized UI styling and refactored app navigation layout * Implemented auto-hiding reader chrome and activity tracking in desktop * Refactored reader panels into distinct left and right modal layers with platform-specific sizing and keyboard navigation support. * Added PPTX support for desktop and refactored parsing into a shared module * Implement paid AI features and account management for the desktop application. * Implement AI Hub and enhanced Cloud TTS integration for Desktop * Implement streaming support for AI definition and summarization features * Implement support for password-protected PDFs and file actions in the desktop reader. * Implement cloud synchronization for desktop using Firestore and Google Drive * Implement PDF reflow and "Text View" for the desktop reader * Refactor OPDS logic to use SharedOpdsController * Optimize PDF tile rendering performance * Implement two-page spread support for PDF pagination * Implement two-page spread support for the PDF viewer * Improved shared spread zoom in PDF viewer * Improve PDF spread navigation with fling support and configurable page gaps * Add brightness control to PDF and EPUB readers * Refactor folder synchronization to use shared logic engine * Implement safe string formatting and validation for localized resources * Implement TTS chunk skip navigation * Implement deep-linking and playback controls for TTS media sessions * Implement start index for TTS playback * Improve TTS navigation, prefetching, and notification duration reporting * Implement TTS mini playback bar for background reading * Implement multi-window reader support for the desktop application * Improve desktop modal window management and visibility syncing * Implement localized string support for Desktop and shared UI * Implement language selection and persistence for Desktop * Implement plural string support for Desktop and migrate hardcoded counts to plurals.xml * Implement localized banner messages and UI strings using resource-backed SharedText * Implement compact badge styling for small book covers * Refactor PDF native interaction and improve HTML import memory safety * fix language persistence * Refactor reader overflow menus to use section-based logic * Refactor PDF layout remapping and improve text box interaction * Improve CFI resolution and TTS resume accuracy using dynamic chunk offsets * Centralize PDF annotation export mapping and improve metadata handling * Add support for threaded comments in PDF highlight annotations * Flatten highlight comments into a single thread for PDF export and allow author editing * Integrate page slider into reader chrome and persist toggle state * Handle fragments and queries in EPUB chapter paths * Implement dynamic, theme-aware coloring for the reader slider * Implement customizable app-wide font preference * Implement one-hand zoom gestures in the PDF viewer * Implement File Information dialog for PDF and EPUB readers * Bump version to 1.0.49 (53) * Refactor PDF reader logic into modular components * Add ProGuard rules to prevent R8 optimization issues in EPUB reader screens * Add option to use PDF filenames as display names * Fix preservation of PDF filename display preference in library projection |
||
|---|---|---|
| .github | ||
| .idea | ||
| app | ||
| desktopApp | ||
| docs | ||
| fastlane/metadata/android/en-US | ||
| gradle | ||
| shared | ||
| spotless | ||
| .gitattributes | ||
| .gitignore | ||
| build.gradle.kts | ||
| CLA.md | ||
| CONTRIBUTING.md | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE | ||
| README.md | ||
| settings.gradle.kts | ||
Episteme Reader
A modern, offline‑first, privacy‑focused document & e‑book reader for Android, built with Kotlin and Jetpack Compose.
Overview
Episteme Reader is a comprehensive, customizable reader for documents and e-books on Android. It features a modern Jetpack Compose UI, powerful reading tools, and extensive theming.
To best serve different user preferences regarding privacy and network usage, Episteme Reader is available in three distinct editions:
- PlayStore Version: The full-featured release which includes proprietary code and features.
- OSS Version (GitHub/F-Droid): A fully open-source build.
- OSS Offline Version (GitHub): A strictly offline build with network permissions completely removed.
Feature Comparison
📚 Supported Formats
| Feature | PlayStore | OSS | OSS Offline |
|---|---|---|---|
| Documents: PDF, DOCX, ODT/FODT | ✅ | ✅ | ✅ |
| E-books & Text: EPUB, MOBI, AZW3, FB2, MD, HTML, TXT | ✅ | ✅ | ✅ |
| Comics: CBZ, CBR, CB7 | ✅ | ✅ | ✅ |
| View-Only: CSV, TSV, JSON, XML, Logs, Code Files | ✅ | ✅ | ✅ |
📖 Core Reading Experience
| Feature | PlayStore | OSS | OSS Offline |
|---|---|---|---|
| Display Modes: Paginated & Vertical Scroll | ✅ | ✅ | ✅ |
| PDF Multi-Tab Reading & Reflow | ✅ | ✅ | ✅ |
| PDF Annotations: Ink (Pen, Highlight, Erase) & Text | ✅ | ✅ | ✅ |
| App-wide Customization & Reader Theming | ✅ | ✅ | ✅ |
| Custom Fonts: Local Import (TTF and OTF) | ✅ | ✅ | ✅ |
| Typography Control | ✅ | ✅ | ✅ |
| Auto-Scroll & Musician Mode | ✅ | ✅ | ✅ |
| System Text-to-Speech (TTS) | ✅ | ✅ | ✅ |
⚙️ Advanced & Network Features
| Feature | PlayStore | OSS (F-Droid) | OSS Offline |
|---|---|---|---|
| Local Folder Sync & Library Management | ✅ | ✅ | ✅ |
| Download Google Fonts | ✅ | ✅ | ❌ |
| OPDS Catalog Support | ✅ | ✅ | ❌ |
| PDF Bubble Zoom Magnifier | ✅ | ❌ | ❌ |
| ML Kit OCR (Scanned PDF Text Selection) | ✅ | ❌ | ❌ |
| Cross-Device Cloud Sync | ✅ | ❌ | ❌ |
| AI Tools (Summaries, Story Recap, Dictionary) | ✅ | 🔜 | ❌ |
| Cloud Text-to-Speech | ✅ | 🔜 | ❌ |
Building from Source
-
Clone the repository:
git clone https://github.com/Aryan-Raj3112/episteme.git cd episteme -
Build:
- Open in Android Studio and run the
ossDebugorossOfflineDebugvariant, or - Build from the command line:
./gradlew assembleOssDebug
The APK will be generated at:
app/build/outputs/apk/oss/debug/Episteme-oss-v{version}-oss-debug.apk - Open in Android Studio and run the
Open Source Libraries
Powered by the Android OSS ecosystem:
- Core & UI: AndroidX, Jetpack Compose, Kotlinx Serialization
- Document Engines: PdfiumAndroidKt (PDF), libmobi (MOBI/AZW3)
- Parsers: Jsoup (HTML/EPUB), Flexmark (Markdown)
- Media & Image Loading: Coil, Media3 (ExoPlayer)
- Utilities: Room (Database), Timber (Logging)
Contributors
| Contributor | Contribution |
|---|---|
| Testing & QA | |
| Translation (German) | |
| Translation (Turkish) | |
| Translation (Arabic) | |
| Translation (Russian) | |
| Translation (French) |
Translations
Help translate Episteme Reader into your native language! Weblate is used to manage localization.
License
Licensed under the GNU Affero General Public License v3.0 (AGPL‑3.0). See the LICENSE file.
Support the Project
Help make Episteme Reader even better:
- ❤️ Support on Patreon
- ⭐ Star the repository to help visibility
- 🐞 Report bugs or request features via GitHub Issues
- 💬 Share feedback in Discussions
- ✍️ Leave a review on the Google Play Store
- 📣 Tell a friend!

