Overview

Episteme Reader is a customizable reader for documents, e-books, comics, and text-heavy files. The app is designed around local-first reading, deep typography controls, flexible layouts, and a consistent Kotlin Multiplatform core across mobile and desktop.

The same core reading experience is available across editions. The main differences are distribution channel, network access, and whether proprietary online services are included.

Core Features

Available across supported editions unless noted in the edition table:

• Formats: PDF, EPUB, MOBI/AZW3, FB2, DOCX, ODT/FODT, TXT, Markdown, HTML, and comic archives.
• Reading modes: Paginated reading, vertical scroll, PDF multi-tab reading, PDF reflow, auto-scroll, and musician mode.
• PDF tools: Ink annotations, highlighting, erasing, text annotations, and reading-focused PDF controls.
• Customization: App themes, reader themes, custom local fonts, typography controls, spacing, margins, and layout tuning.
• Library tools: Local folder sync, library organization, bookmarks, progress tracking, and file management.
• Accessibility: System text-to-speech, app language selection, and reader settings that adapt to different reading preferences.

Editions

Future desktop platforms can use the same Standard and Offline model as support expands.

Translations

Episteme Reader translations are managed through our self-hosted Weblate instance. Sign in with GitHub to contribute.

Translation contributors are required to accept the Episteme Contributor License Agreement before submitting changes.

Building from Source

1. Clone the repository:

   git clone https://github.com/Aryan-Raj3112/episteme.git
   cd episteme
   

2. Build Android:

   • Open in Android Studio and run the ossDebug or ossOfflineDebug variant, 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

3. Build desktop:

   ./gradlew :desktopApp:packageReleaseDistributionForCurrentOS
   

   For the offline desktop build, pass:

   ./gradlew :desktopApp:packageReleaseDistributionForCurrentOS -PdesktopFlavor=oss
   

Open Source Libraries

Powered by the Kotlin, Android, and desktop OSS ecosystem:

• Core and UI: Kotlin Multiplatform, Compose Multiplatform, AndroidX, Jetpack Compose, Kotlinx Serialization
• Document engines: PdfiumAndroidKt, PDFium, libmobi
• Parsers: Jsoup, Flexmark, Apache Commons Compress
• Media and image loading: Coil, Media3
• Utilities: Room, Timber, JNA

Contributors

Supporters

Thank you to the people helping keep Episteme Reader moving:

Support the Project

Help make Episteme Reader better:

• Sponsor on GitHub
• Support on Patreon
• Star the repository to help visibility
• Report bugs or request features via GitHub Issues
• Help translate Episteme Reader
• Share feedback in Discussions
• Leave a review on the Google Play Store
• Tell a friend

License

Licensed under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). See the LICENSE file.