Register Guidelines E-Books Today's Posts Search

Go Back   MobileRead Forums > E-Book Readers > Kobo Reader > Kobo Developer's Corner

Notices

Reply
 
Thread Tools Search this Thread
Old Today, 04:39 PM   #1
Eliott566
Junior Member
Eliott566 began at the beginning.
 
Posts: 1
Karma: 10
Join Date: Nov 2026
Device: Kobo Clara Colour & Kindle Touch 4th Gen
Android 2.3.6 for Kobo Clara Colour ! (Experimental)

[Experimental / PoC] Android 2.3.6 (Gingerbread) inside KOReader on Kobo Clara Colour

Hi everyone,

I've built an experimental proof-of-concept KOReader plugin (android.koplugin) that runs an isolated Android 2.3.6 (Gingerbread) userland inside a chroot on the Kobo Clara Colour (MediaTek MT8113T, stock 4.9.77 kernel).

Instead of modifying the bootloader, flashing eMMC, or writing custom Kaleido 3 kernel framebuffer drivers, KOReader acts as the display server and input bridge via shared memory (/tmp/android-bridge/fb) and a dirty-rectangle FIFO.

How It Works
  • Zero-Footprint Sandboxing: Runs completely from /mnt/onboard/.adds/android/ (root.img.gz and data.img.gz) mounted loop-back into /tmp. Nothing is written to Kobo's system partitions.
  • Shared Memory Framebuffer Bridge: A custom C gralloc / framebuffer HAL writes RGB565 frames directly into a shared memory buffer mapped zero-copy into KOReader's BlitBuffer.
  • E-Ink Refresh Modes: Supports Clean (fast partial updates followed by a non-flashing cleanup pass), Fast, A2, and Full refresh modes directly from KOReader's top menu.

Controls & Navigation
  • Return to Previous Interface (Back): Long-press the bottom-left corner of the screen.
  • Leave Android / Return to KOReader: Long-press the top-right corner of the screen for ~1 second to open the menu to return to KOReader or stop the Android chroot cleanly.

Current Status & Known Limitations (Very Experimental)
  • Currently tested on Kobo Clara Colour (though screen/touch parameters are read dynamically from KOReader's Device module).
  • Only basic stock apps (Settings, Calculator, Browser, and Clock) are included right now.
  • APK Sideloading: The plugin includes an Install an APK… option which successfully installs APK packages into the system, however installed apps do not work/launch yet.
  • Connectivity: Wi-Fi and Bluetooth are not working for now.
  • Software OpenGL ES rendering only (no hardware GPU acceleration).
  • I am also exploring porting Android 4.4 (KitKat) using this same bridge architecture for better app compatibility with a similar RAM footprint.

Required Files & Installation

1. Recombine root.img.gz:
Because of MobileRead's 15 MB attachment limit, root.img.gz is split into two files (root.img.gz.part1.gz and root.img.gz.part2.gz). Download both parts into the same folder and merge them before copying to your Kobo:
  • Windows (Command Prompt):
    Code:
    copy /b root.img.gz.part1.gz + root.img.gz.part2.gz root.img.gz
  • macOS / Linux (Terminal):
    Code:
    cat root.img.gz.part1.gz root.img.gz.part2.gz > root.img.gz

2. Copy Files to Your Kobo:
Connect your Kobo via USB (which mounts as /mnt/onboard on the device) and place the exact files below into these folders:

KOReader Plugin (.adds/koreader/plugins/android.koplugin/):
Code:
.adds/koreader/plugins/android.koplugin/
├── _meta.lua
├── main.lua
├── android-run.sh
├── androidbridge_fake.lua
├── androidbridge_producer.lua
├── androidbridge_proto.lua
├── androidbridge_shm.lua
└── androidbridge_view.lua
Android Filesystem Images (.adds/android/):
Code:
.adds/android/
├── root.img.gz
└── data.img.gz
3. Starting Android:
  1. Safely eject your Kobo and restart KOReader.
  2. Open the top menu -> Tools (wrench icon) -> More tools -> Android bridge -> Start Android.

Downloads
All files are attached directly below to this thread:
  • android.koplugin.zip
  • data.img.gz
  • root.img.gz.part1.gz
  • root.img.gz.part2.gz

Feedback, testing on other Kobo models, and contributions (especially for getting sideloaded APKs running, Wi-Fi/Bluetooth bridging, or porting Android 4.4) are very welcome!
Attached Files
File Type: gz data.img.gz (7.22 MB, 0 views)
File Type: zip android.koplugin.zip (35.4 KB, 0 views)
File Type: gz root.img.gz.part1.gz (12.00 MB, 0 views)
File Type: gz root.img.gz.part2.gz (12.00 MB, 0 views)

Last edited by Eliott566; Today at 04:42 PM.
Eliott566 is online now   Reply With Quote
Reply

Tags
android, gingerbread, kobo clara colour, koreader, plugin


Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Loading Screen Loop on Kobo Clara Colour 7ni4F_ Kobo Reader 5 09-11-2026 07:34 PM
Kobo Clara Colour Battery Size on Black versus White Case Colour sgannon Kobo Reader 3 09-10-2026 05:04 PM
Trade Looking for Kobo Clara Colour in white in exchange for black one (+$20) qqqqqqqqqqqz Flea Market 6 11-24-2025 05:28 PM
Kobo Clara BW Sleepcover, which colour? alexhk Kobo Reader 2 03-04-2025 08:47 AM
The 2024 Kobo Clara Colour tweeaking corner. Colour_2024hacks Kobo Developer's Corner 2 07-12-2024 02:31 PM


All times are GMT -4. The time now is 04:54 PM.


MobileRead.com is a privately owned, operated and funded community.