Material You 3 eBook/audiobook reader — Episteme fork + bookshelf-api/ABS

Find a file

Dimitris Dafnis c0d0e57e79 fix(webview): gate setWebContentsDebuggingEnabled on BuildConfig.DEBUG and drop unused allowFileAccess in MathMLRenderer (#303 ) Three WebView setup paths exist in the app. MyApplication.kt already wraps setWebContentsDebuggingEnabled in 'if (BuildConfig.DEBUG)'. The other two paths were missing the guard: - MainActivity.onCreate calls WebView.setWebContentsDebuggingEnabled(true) unconditionally at the end of onCreate. On a release build that leaves chrome://inspect attachable from any USB-connected machine for any WebView the app spawns later. CWE-489. - MathMLRenderer.setupWebView does the same thing before constructing the renderer WebView. Same exposure. While in MathMLRenderer, drop settings.allowFileAccess = true. The renderer only ever loads file:///android_asset/MathML-template.html, and the android_asset scheme is permitted on every supported Android version even when setAllowFileAccess(false) is in force. The flag is dead and the WebView is set up with javaScriptEnabled = true + a JS bridge, so leaving it on widens the surface for no benefit. ChapterWebView intentionally keeps allowFileAccess = true because the custom-font path renders @font-face src: url('file://<path>') against the user-picked font file.		2026-05-14 12:26:38 +05:30
.github	Add Patreon funding option (#259 )	2026-04-30 13:29:02 +05:30
.idea	v1.0.47 (#279 )	2026-05-04 21:55:38 +05:30
app	fix(webview): gate setWebContentsDebuggingEnabled on BuildConfig.DEBUG and drop unused allowFileAccess in MathMLRenderer (#303 )	2026-05-14 12:26:38 +05:30
desktopApp	Windows (#291 )	2026-05-10 10:07:37 +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	Windows (#291 )	2026-05-10 10:07:37 +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	v1.0.47 (#279 )	2026-05-04 21:55:38 +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

README.md

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 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

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