Hey everyone,

Here is an updated roundup of the biggest improvements to the KOReader X-Ray plugin since I last posted here about it in July. This set of releases brings some major quality-of-life upgrades, especially around API key setup and reading with maps and illustrations.

Here are the highlights:

# Much Easier API Key Setup (No Config Files, No E-Ink Typing)

For new users, getting an API key onto your e-reader used to mean either painfully typing it out on an e-ink keyboard or plugging your device into a computer to manually edit configuration files. You don't have to do either anymore:

* **Phone/PC Web Setup (QR Code)**: Go to the setup screen on your e-reader, scan the QR code with your phone (or open the short link on your computer), paste your key, and tap send. It syncs directly to your device in seconds. This uses end-to-end zero-knowledge encryption, so the relay server never sees your actual key.
* **Local Wi-Fi (Offline LAN)**: If you prefer keeping everything strictly on your home network without any external servers, you can send keys directly from your browser to your device over local Wi-Fi (works on Kobo, Android, PocketBook, and desktop).
* **No Manual Config Files Required**: You no longer need to connect to a PC to edit Lua or JSON files. If you do prefer using USB, you can still just drop a plain `xray_key.txt` file into your KOReader folder and X-Ray will import it automatically.

Read more about it here: [https://github.com/ultimatejimmy/xray.koplugin/wiki/2.-API-Key-Setup-Options](https://github.com/ultimatejimmy/xray.koplugin/wiki/2.-API-Key-Setup-Options)

# Dedicated Images & Maps Feature

Fantasy, sci-fi, and history books often feature maps, character charts, and diagrams that can be frustrating to flip back and forth to while reading. X-Ray now includes a built-in **Images & Maps Gallery** and dedicated viewer:

* **Automatic Extraction & Organization**: Automatically finds illustrations in your books and organizes with Mosaic, Grid, and List gallery layouts.
* **High-Resolution Viewer**: Includes smooth panning, multi-level zoom, 90-degree rotation, and an inverted color mode (great for high contrast on e-ink when dealing with dark maps).
* **Series Reference Support**: You can save maps and reference images from earlier books in a series so they carry forward into the current book's gallery so you can look up previous world maps without switching books.
* **Organization Tools**: Star favorites to keep them pinned at the top, rename images with descriptive titles, and jump directly to where an image appears in the book.
* **Gesture support**: Launch the image feature directly with a new supported gesture

# Other Key Improvements

* **Full Non-Touch Device Support**: Added complete D-pad and physical button navigation across all X-Ray menus and screens for non-touch e-readers.
* **Offline Unit Converter Upgrades**: More robust language support, better handling of non-ASCII characters, and custom measurement preferences.
* **Performance & Memory Optimizations**: Lower memory footprint, faster list loading, and overall snappier UI transitions.
* **Reliable AI Request Handling**: Better background handling to cleanly cancel requests if your device sleeps or disconnects from Wi-Fi, preventing freezes.
* **Spoiler Protection Refinements**: Fixed edge cases near chapter ends and book boundaries so you can read without fear of accidental plot reveals.
* **Updated Models & Languages**: Support for latest API models, Cyrillic lookups, and updated translations.

# Install

If you haven't tried it yet, you can install it directly from [Storefront](https://github.com/ultimatejimmy/storefront.koplugin) or get it here: [https://github.com/ultimatejimmy/koreader-xray-plugin](https://github.com/ultimatejimmy/koreader-xray-plugin)

Here's the direct link the releases: [https://github.com/ultimatejimmy/koreader-xray-plugin/releases](https://github.com/ultimatejimmy/koreader-xray-plugin/releases)

# Feedback

I'm always open to feedback. If you have ideas or issues, you can let me know. GitHub is ideal so things don't get missed:

* [GitHub issue tracker](https://github.com/ultimatejimmy/koreader-xray-plugin/issues)
* [GitHub ideas](https://github.com/ultimatejimmy/koreader-xray-plugin/discussions/categories/ideas)

I will also respond on Reddit or via Reddit chats.

# Support me

I do this work for free, but if you want, you can support me via [liberapay](https://liberapay.com/ultimatejimmy) or [Buy me a coffee](https://www.buymeacoffee.com/ultimatejimmy)

[Updates] X-Ray: Latest features and updates