Episteme Reader

A native Android document reader application built with Kotlin and Jetpack Compose.

Overview

Episteme Reader is an offline-first application designed for reading various document formats. It leverages native Android technologies and C++ libraries to provide a performant reading experience with customization capabilities.

Features

Supported Formats

Documents: PDF
E-books: EPUB, MOBI, AZW3
Text: MD, TXT, HTML

PDF Features

Viewing Modes: Vertical Scroll and Paginated view.
Ink Annotations: Draw directly on pages using Pen, Highlighter, and Eraser tools.
Text Annotations: Add text notes anywhere on the page using system or custom fonts.

E-Book Features

Parsing: Native parsing for MOBI/AZW3 via libmobi and EPUB via Jsoup.
Customization: Adjust font size, line spacing, and margins.
Custom Fonts: Support for importing user-provided font files (.ttf, .otf).

General

Text-to-Speech (TTS): Read documents aloud using the system TTS engine.
File Management: Built-in file browser and library organization.

Architecture

UI: 100% Jetpack Compose (Material3).
Architecture: MVVM with Unidirectional Data Flow.
Database: Room (SQLite) for metadata and annotations.
PDF Engine: pdfium-android (Native PDFium bindings).
Mobi Engine: Custom JNI bindings to libmobi.

Building from Source

Clone the repository:

git clone https://github.com/your-username/episteme-oss.git
cd episteme-oss

Build: Open in Android Studio and run the ossDebug variant.
```
./gradlew assembleOssDebug
```

Open Source Libraries

This project uses the following open-source libraries:

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See the LICENSE file for details.

2.2 KiB Raw Blame History