Material You 3 eBook/audiobook reader — Episteme fork + bookshelf-api/ABS
Find a file
Aryan 9510293ac3
Update v1.0.49 (#330)
* 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
2026-05-20 22:14:01 +05:30
.github Add Patreon funding option (#259) 2026-04-30 13:29:02 +05:30
.idea Desktop app (#308) 2026-05-15 22:36:51 +05:30
app Update v1.0.49 (#330) 2026-05-20 22:14:01 +05:30
desktopApp Update v1.0.49 (#330) 2026-05-20 22:14:01 +05:30
docs docs: Revamp README and add APK naming convention (#2) 2026-02-25 19:54:43 +05:30
fastlane/metadata/android/en-US update description, phone images and feature graphic in fastlane (#67) 2026-03-14 14:16:36 +05:30
gradle v1.0.47 (#279) 2026-05-04 21:55:38 +05:30
shared Update v1.0.49 (#330) 2026-05-20 22:14:01 +05:30
spotless Update readme (#3) 2026-02-25 21:30:28 +05:30
.gitattributes App themes (#217) 2026-04-21 18:11:55 +05:30
.gitignore Update v1.0.49 (#330) 2026-05-20 22:14:01 +05:30
build.gradle.kts Windows (#291) 2026-05-10 10:07:37 +05:30
CLA.md docs: add CLA and CONTRIBUTING guidelines (#26) 2026-03-04 10:19:17 +05:30
CONTRIBUTING.md cla (#62) 2026-03-12 22:31:52 +05:30
gradle.properties Initial commit 2026-02-24 17:37:40 +05:30
gradlew Initial commit 2026-02-24 17:37:40 +05:30
gradlew.bat Initial commit 2026-02-24 17:37:40 +05:30
LICENSE Pdf text highlight (#49) 2026-03-09 17:37:44 +05:30
README.md Update README (#260) 2026-04-30 13:59:25 +05:30
settings.gradle.kts v1.0.47 (#279) 2026-05-04 21:55:38 +05:30

Episteme Reader Icon  Episteme Reader

A modern, offlinefirst, privacyfocused document & ebook reader for Android, built with Kotlin and Jetpack Compose.

Get it on F-Droid Get it on Google Play   Get it on Obtainium


Episteme Reader Preview

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

  1. Clone the repository:

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

    • 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

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
CCerrer avatarCCerrer Testing & QA
ottozumkeller avatar ottozumkeller Translation (German)
TURBOKANTR avatar TURBOKANTR Translation (Turkish)
eyadalkordy24 avatareyadalkordy24 Translation (Arabic)
berebara avatarberebara Translation (Russian)
mh4ckt3mh4ckt1c4s avatarmh4ckt3mh4ckt1c4s Translation (French)

Translations

Help translate Episteme Reader into your native language! Weblate is used to manage localization.

Translation status

License

Licensed under the GNU Affero General Public License v3.0 (AGPL3.0). See the LICENSE file.

Support the Project

Help make Episteme Reader even better: