This plugin brings Kindle-style X-Ray features to KOReader. It uses AI to track characters, build plot timelines, and provide insights while you read.
- AI-Powered Insights: Supports Google Gemini, OpenAI, DeepSeek, Claude, and Custom API providers (like OpenRouter).
- Character Tracking: View bios and roles. Now supports Merging Duplicates with AI-consolidated summaries.
- Customizable Detail: Choose between short or long AI descriptions to fit your preference.
- Linked Entries: Automatically connect related characters and locations through smart cross-referencing.
- Plot Timeline: Keeps track of major events chapter by chapter, strictly sorted by physical page location for accuracy.
- Historical Context: Pulls real-world info for historical figures and locations.
- Mention Scanning: Find every occurrence of a character or location throughout the book, complete with page numbers and context snippets for quick navigation.
- Spoiler Protection: "Spoiler-free" mode only reads up to your current page so future twists aren't ruined.
- Auto Fetching while you read: Automatically fetches data in the background when you get to a new chapter.
- X-Ray Mode & Inline Fetching: Get instant lookups by tapping the "X-Ray" button in dictionary or selection popups. If an entity is missing, the plugin can fetch it on-the-fly using AI without requiring a full book scan.
- Silent Weekly Updates: Automatically checks for new plugin versions in the background once a week.
- Offline First: You only need internet to fetch the data. After that, it's saved locally.
- Multilingual: Available in English, German, French, Spanish, Brazilian Portuguese, Russian, Ukrainian, Turkish, Simplified Chinese, Dutch, Hungarian, Polish, Indonesian, Arabic, Italian, Serbian, and Japanese.
For full setup instructions and a deep dive into features, check out the GitHub Wiki.
- Get Started: Installation and API key setup.
- Core Content & Features: Characters, Timeline, Glossary, and Series recap.
- Lookups & Navigation: In-text lookups, footnote popup UI, Gestures, and Mention scanning.
- Data Management & Settings: Merging duplicates, verbosity settings, and language localization.
- AI Providers & Models: Supported APIs, models, and reasoning effort.
- Spoiler Protection: How we keep the story safe.
- Fetching Data: Background fetching, manual fetching, and targeted lookups.
- Advanced Configuration & Maintenance: Custom endpoints, config files, formats, logs, and maintenance tools.