MyBooks

MyBooks is an offline-first personal digital library and multi-format document reader for Android (Kotlin + Jetpack Compose + Material 3), developed by Muhammed Omor, featuring full English & বাংলা (Bangla) bilingual support, complete in-app Privacy Policy & Terms & Conditions, and a direct Telegram Community link inside Settings.


Supported Document Formats & Honest Limitations

Tier Formats Support Details Limitations
Core PDF, EPUB, TXT, HTML, Markdown (.md) PDF rendered natively via Android PdfRenderer with pinch-to-zoom, single-page or continuous vertical scroll, embedded text search (PdfTextExtractor), and offline ML Kit Latin OCR (OfflineOcrHelper) for scanned pages. EPUB parsed offline into reflowable chapters, TOC, cover art, metadata, and search. HTML/Markdown/TXT rendered safely with sanitized text extraction and optional offline TTS Read Aloud (TtsReadAloudManager). Password-protected or DRM-encrypted PDFs/EPUBs cannot be unlocked offline. Offline OCR uses on-device ML Kit Latin recognition.
Extended DOCX, RTF, ODT, FB2, DOC (detected) DOCX (word/document.xml), ODT (content.xml), FB2 XML, and RTF control-word decoding are parsed directly offline. Legacy binary Word 97–2003 (.doc) cannot be converted offline; MyBooks detects it safely and recommends converting to .docx or .pdf.
Specialized CBZ, MOBI, AZW3, XPS, CBR (detected) CBZ image archives open page-by-page with zoom. Uncompressed & PalmDOC-LZ77 DRM-free MOBI/AZW3 and XPS .fpage glyphs extract cleanly. Proprietary RAR (.cbr), HUFF/CDIC compressed MOBI, and DRM-encrypted Kindle files are rejected cleanly with clear user guidance.
Images JPG, JPEG, PNG, WEBP, TIFF Displayed in zoomable reader canvas and selectable as custom book covers via zero-permission Android Photo Picker. —

Architecture & Core Features


Building & Downloading the APK Directly From an Android Phone (GitHub Actions)

You can build and download an installable APK directly on your Android phone without Android Studio:

  1. Push this repository to GitHub.
  2. Open the repository on your Android phone’s browser and tap the Actions tab.
  3. Select Build MyBooks APK (build-apk.yml) — it runs automatically on every push, or tap Run workflow manually.
  4. Wait for the green checkmark (unit & Robolectric tests + assembleDebug).
  5. Scroll down to Artifacts on the workflow summary page and tap MyBooks-Debug-APK to download the .zip file.
  6. Open your phone’s Files app, extract app-debug.apk from the downloaded .zip, and tap it to install (allow “Install unknown apps” for your Files/Browser app if prompted).

Signed Release APK Setup (release-apk.yml)

To sign release APKs via GitHub Actions without committing keystores to Git:

  1. Encode your .jks keystore: base64 -w 0 my-upload-key.jks
  2. Add three GitHub Repository Secrets (Settings → Secrets and variables → Actions):
    • RELEASE_KEYSTORE_BASE64
    • STORE_PASSWORD
    • KEY_PASSWORD
  3. Trigger Build Signed Release APK from the Actions tab and download MyBooks-Release-APK.

Privacy & Permissions


© 2026 Muhammed Omor. All rights reserved.