Skip to content

About

Simple Lector is a Kotlin Multiplatform reading app built with Compose Multiplatform for Android and Desktop

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SimpleLector

SimpleLector is a Kotlin Multiplatform reader for Android, Windows, and Linux built with Compose Multiplatform.

It is designed as a lightweight personal library app for books, documents, and comics, with a shared reading experience across platforms.

Downloads

Android on Google Play Windows and Linux on itch.io

Windows and Linux builds are available on itch.io.

Features

  • Library import from folders
  • Reading support for PDF, EPUB, TXT, Markdown, CBZ, and CBR
  • Reading progress and last-opened-book restore
  • Bookmarks and reader preferences
  • Inline notes and references in supported books
  • Library browsing, search, and folder navigation
  • Comic and manga reading with Android-native image acceleration for heavy CBZ / CBR pages

Platforms

  • Android
  • Windows
  • Linux

Screenshots

SimpleLector screenshot 1 SimpleLector screenshot 2

SimpleLector screenshot 3 SimpleLector screenshot 4

Requirements

Android

  • Android Studio
  • Android SDK
  • Android NDK
  • CMake

The Android build includes native code for some image-heavy reading paths, so NDK and CMake should be installed from Android Studio's SDK Manager.

Desktop

  • JDK 21
  • A system supported by Compose Desktop

Run The Project

Android

Open the project in Android Studio, connect a device or start an emulator, and run the androidApp configuration with the normal Run / Play button.

You can also build from the terminal:

./gradlew :androidApp:assembleDebug

On Windows:

.\gradlew.bat :androidApp:assembleDebug

Desktop

Run on Linux:

./gradlew :composeApp:run

Run on Windows:

.\gradlew.bat :composeApp:run

Desktop distribution

The desktop CI creates the following packages:

  • Windows: .msi installer
  • Linux x86_64: portable .AppImage

Artifacts produced by GitHub Actions are intended for testing and have the retention period configured by GitHub. They are not automatically published as GitHub Releases.

To run the Linux AppImage after downloading it:

chmod +x SimpleLector-*.AppImage
./SimpleLector-*.AppImage

Notes

  • Android is the most optimized target right now for heavy comic and manga reading.
  • CBR support depends on the archive being readable by the bundled RAR library.
  • iOS is not configured in this repository.

Project Structure

  • androidApp: Android launcher app
  • composeApp: shared app code for Android and Desktop

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

Simple Lector is a Kotlin Multiplatform reading app built with Compose Multiplatform for Android and Desktop

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages