Skip to content

Repository files navigation

Troop Reader

An independent Kavita client for Android, built for offline EPUB, manga, comics and PDF reading. Spanish and English interface, Kotlin and Jetpack Compose. Android 8.0+ (API 26), GPL-3.0. This is an alpha application, not an official Kavita app.

Screenshots

Real app screenshots using the built-in offline demo, with synthetic books and covers. These show the alpha22 development build with the English interface; the latest published APK may differ. Tap a screenshot to view it full size.

Offline library Reading options E-ink settings
Troop Reader offline demo library with sample covers and continue-reading cards Reading options for screen type, page layout and navigation High-contrast e-ink settings with language selection and refresh controls

The sample book titles remain in Spanish: interface language does not translate book content. Screenshot details.

Install and connect

  1. Download the APK from Releases or the maintainer's update channel.
  2. Install over the previous version without uninstalling or clearing app data. Android asks you to confirm installation.
  3. Select Español / English on the sign-in screen or under Settings → App language. Existing installations start in Spanish. This changes the interface, not your books, annotations or reading voice.
  4. Enter your Kavita HTTPS URL and an account with library access and the Download permission. The form initially suggests the project's server; replace it with yours. No shared accounts or server access are included.
  5. Download a book/volume or select Try the demo without an account. Check offline reading, resume and synchronization.
  6. Read the Kavita setup guide: some versions need a server compatibility adjustment for header-authenticated images.

Future versions from the original channel are detected under Settings → App updates. Android still requires confirmation; updates are never installed silently.

Features

  • Online/offline libraries grouped by series, cached covers, batch downloads and a pause/resume queue.
  • Read while downloading, without skipping missing content.
  • Instant edge taps by default, optional swipes, pinch and central double-tap zoom; retained zoom, RTL, two-page spreads and optional page curl.
  • Continuous vertical reading, volume/page selection, thumbnails, EPUB contents and direct page/section navigation.
  • Progress and bookmark sync with manual conflict resolution by default; optional device priority.
  • Favourites, personal collections, followed series, optional next-volume downloads and per-series reading preferences.
  • EPUB: local search, exportable highlights/notes, dictionary through a compatible app and background offline text-to-speech.
  • Optional volume-button navigation, orientation lock, statistics, reading backups and diagnostic exports.
  • Read-only Kavita lists/collections with offline caching.
  • Monochrome and colour e-ink modes, including experimental Bigme refresh.

Documentation

Important limitations

Kavita does not provide conditional writes for all reading data. Conflict detection reduces, but cannot eliminate, races between clients. Deleting downloaded files preserves progress and bookmarks. Reading backups do not contain books or passwords.

Speech needs an installed offline engine/voice. Dictionary lookup needs an app supporting Android's Process text action. There is no OCR, manga/PDF text search, remote list editing or complete SSO/2FA support.

An emulator cannot validate ghosting on a physical e-ink panel. Bigme refresh is opt-in and remains physically unverified on B751C S / Android 14 / firmware 1.7.0. A black/white redraw does not guarantee a full panel refresh.

Quick development setup

JDK 17, Android SDK 35 and Build Tools 35.0.0. Configure ANDROID_HOME or an untracked local.properties.

./gradlew testDebugUnitTest lintDebug assembleDebug

Never run instrumented tests on a device containing real reading data. See BUILD first. CI artifacts use a development signature and cannot necessarily update a maintainer-signed installation.

About

Offline Android client for Kavita: EPUB, manga, reading sync and e-ink. Spanish and English. Kotlin / Compose.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages