Kindle Remote 📱📖

A premium, open-source Android application and KOReader plugin that turns your tablet or smartphone into a zero-configuration bridge for physical Bluetooth remotes and a rich reading companion/remote control dashboard for your Kindle.

Why this exists

Amazon Kindles do not allow pairing standard Bluetooth media remotes. This project solves that elegantly by bridging the remote through your phone/tablet, completely bypassing Kindle's Bluetooth restrictions without draining your battery.

✨ Features

• Live Two-Way Sync (Now Reading Dashboard): The app continuously polls the Kindle to fetch and display the live book details, authors, a reading progress bar, and precise page counts (e.g. Page 42 of 300 (14%)).
• Kindle Battery Sync: Displays the Kindle's live battery status (e.g. Bat: 85%) along with a charging status symbol (⚡) right in the app header.
• Zero-Config Auto-Discovery: The app sweeps your local WiFi network using 254 asynchronous coroutines to instantly find and connect to your Kindle in milliseconds. No typing IP addresses! Tap the header to manually force a re-scan.
• Enhanced Remote Dashboard Controls: Tap controls directly on the tablet to adjust the Kindle's settings:
  • Font Size (+ / -)
  • Frontlight / Brightness (+ / -)
  • Chapters (Prev / Next)
  • Dark Mode toggle
  • Bookmark manager
• OLED Sleep Mode: Uses absolute 0% brightness and pure black #000000 to completely shut off OLED pixels while preventing the phone from locking. This ensures zero battery drain while you read for hours.
• Auto-Sleep Protection: If you fall asleep reading, the app detects inactivity and gracefully releases the wake-lock after 15 minutes to let your phone lock normally.
• Deep Android Integration: Intercepts D-Pad and Volume signals from any paired Bluetooth remote globally.
• Autostart on Boot (Kindle): Toggle option to start the WebRemote server automatically when KOReader boots.
• Aesthetic Dark Mode UI: Sleek, modern card-based dark UI matching night-time reading ergonomics.

---

🚀 Installation

Step 1: Install the KOReader Plugin (On Kindle)

1. Ensure your Kindle is running KOReader and connected to the same WiFi as your phone.
2. Copy the koreader-plugin folder to your Kindle's plugin directory: /mnt/base-us/koreader/plugins/webremote.koplugin
3. Restart KOReader.
4. Open the top menu -> Gear Icon -> Plugin management, and make sure Web Remote is checked/enabled.
5. In the Network Menu (globe icon), you will see the WebRemote Server toggle. Tap it to start it.
6. Optional: check the box next to Autostart on Boot inside the submenu.

Step 2: Install the Android App

1. Build the APK using Android Studio or Gradle (./gradlew assembleDebug).
2. Install it on your Android phone/tablet.
3. Open Kindle Remote. It will automatically discover your Kindle.
4. Important: Tap the gear icon (Settings) and enable the Kindle Remote Accessibility Service so the app can intercept your TV remote clicks while your screen is locked in OLED sleep mode.

🛠️ Architecture

• Android App (Kotlin): Uses OkHttp for fast concurrent network scanning, parses stats JSON, and handles multiple event routes (/font/inc, /darkmode, etc.).
• KOReader Plugin (Lua): A lightweight HTTP server using LuaSockets listening on port 8081 (avoiding port conflicts with standard dropbear servers on 8080). Intercepts commands and dispatches events natively to the KOReader UI engine.

🤝 Contributing

Pull requests are welcome! If you have any new feature ideas (like custom key mapping or physical volume rocker support), feel free to open an issue!