Release 2.2.0

Release 2.2.0 Summary - HUGE release

This release introduces significant enhancements to the reading and listening experience, including multi-server support, integrated OCR for comics, local PDF/CBR support, and advanced audiobook transcription.

Features

Multi-Server Support

• Multi-Server Management: Users can now add, switch between, and manage multiple Komga server connections. Session management, login flows, and offline synchronization have been updated to support per-server states.

Enhanced Comic Reader (OCR & Navigation)

• OCR Text Selection: Integrated Google ML Kit and RapidOCR as pluggable engines for text recognition in comic readers. Supports on-demand scanning and an "Auto-Scan" mode that triggers OCR on page load.
• Translation & Text Actions: Directly Translate, copy, or create annotations from OCR-selected text.
• Multi-Language OCR: Expanded OCR support to include Chinese, Devanagari, Japanese, and Korean.
• Smart Segment Merging: OCR bounding boxes are logically merged based on reading direction (LTR/RTL) for a more natural text selection experience.
• Add Note from OCR: Users can now directly create annotations from OCR-selected text, with the note automatically pinned to the relevant area.
• Thumbnail Carousel: Added a horizontal thumbnail strip to the image reader for fast visual navigation, complete with auto-scroll synchronization to keep the active page centered.
• Navigation History: Added navigation history and a floating back button for better exploration within the reader.

Audio & Transcription Improvements

• EPUB Translation: Added a "Translate" option to the EPUB text selection context menu.
• Whisper & ML Kit Transcription: Added real-time transcription for folder-based audiobooks using both Google ML Kit and Whisper (Local/Native). Includes look-ahead pre-fetching for Whisper to ensure seamless playback.
• Transcript UI: Transcription is displayed as a scrollable chat-log with chunk dividers and proximity shading to orient the user within the audio.
• Embedded Metadata & Chapters: Audiobook folder mode now extracts and caches embedded chapter metadata (titles, start/end times) using FFmpeg, providing accurate chapter navigation instead of simple filenames.
• Audio Metadata Dialog: A new info button in the player allows viewing detailed track tags and embedded chapters.

Offline & Local Files

• PDF & CBR Support: Added native support for local PDF (via Android PdfRenderer) and CBR/RAR (via junrar) files in both offline mode and via local file intents.
• Offline WiFi Toggle: A new quick-toggle in the top app bar allows users to manually switch between online and offline modes.

System & UI Improvements

• Cache Management: Added user-configurable cache limits for both Image and EPUB readers, including LRU-based trimming and manual cache clearing options.
• Thumbnail Polish: Standardized visual indicators for downloaded and completed books, including new bookmark icons and refined badges.
• Upstream Sync: Merged core updates from upstream 0.18.5, including Kotlin 2.3.21 and Compose 1.11.0-beta03.

Bug Fixes

• Performance: Resolved severe scrolling freezes in the thumbnail carousel by optimizing image pre-fetching and restoration of native Compose/Coil recycling.
• Search Reliability: Fixed keyboard focus and input issues on the mobile search screen, ensuring the keyboard opens reliably and focus is handled correctly.
• UI Clipping: Ensured logout buttons and search results are correctly positioned above system navigation bars on mobile devices.
• Stability: Fixed potential crashes when switching server profiles without offline data and swallowed network timeouts in reader event listeners to prevent app crashes.
• EPUB Recovery: Implemented automatic cache recovery for corrupted EPUB files by validating core container files and forcing refreshes when necessary.
• OCR Threading: Moved RapidOCR processing to background threads to eliminate UI jank during page turns.

Release 2.1.0

Release 2.1.0 Summary

Features

• Annotations & Highlights:
  • Comic Reader: Added support for page-level annotations with a new "Map Pin" visual indicator.
  • EPUB3 Reader: Implemented text highlighting and note attachment.
  • Note Navigation: Added the ability to navigate between notes (Previous/Next) directly from the note editor screen.
  • UI Integration: Added a dedicated "Notes" button to reader controls and renamed the "Annotations" tab to "Notes" for clarity.
• Cross-device Synchronization: Implemented real-time synchronization for bookmarks and annotations (notes) across devices for both EPUB3, Audio Books and Comic readers, leveraging Komga's Kobo progress API.
• EPUB3 Customization: Added a new "Respect publisher colors" setting, allowing users to maintain original book styling while using custom fonts or layouts.
• Audiobook Improvements: Progress synchronization for audiobooks between devices for non synchonized audiobooks.
• UI Polish: Improved note editor layout, refined context menus in the EPUB reader, and updated theme consistency across dialogs.

---

Release 2.0.0 - Sipurra

Summary of Changes

Important Note

• I think the application came a long way and it is far enough from Komelia in terms of UX and additional features that I feel comfortable giving it its own name. Sipurra is based on the Hebrew word Sipur - which means a story. Since the application support books, comics and audio books - I think its a fitting name.
• Because the application was rebranded to Sipurra - it will no longer upgrade existing application or Komelia and need to be installed again. Note that you can recover local downloads using the offline sync feature in settings - so this should not be too complicated.

New Features

• Rebranding to Sipurra: The application has been fully renamed from Komelia to Sipurra. This includes the application name, Android launcher icon label, UI headers, and build artifacts.
• Parallel Installation: Updated internal identifiers (applicationId) and data directories to allow Sipurra to be installed and run side-by-side with the original Komelia application.
• New Update System: The app now tracks updates from the new Sipurra GitHub repository.
• Floating Navigation Bar (Mobile): A new optional centered, pill-shaped floating toolbar for mobile navigation. It supports "Haze" (transparency with blur) and adapts to theme accent colors.
• Audio Player Overhaul:
  • The full-screen audio player now utilizes the entire screen height.
  • Folder-Mode Audiobooks: Added a full-book seek slider with live time display, ±20s/30s seek buttons, and persistent position tracking.
  • Synchronized Audio (SMIL): Improved navigation with dedicated page-flip buttons and skip-chapter buttons.
  • UI refinements including better spacing, layout alignment, and accent color integration.

Major feature Audiobook Folder Playback:

Native support for playing audiobook folders (unsynchronized tracks) with dedicated track list dialogs and database-backed position/bookmark history.
Since Komga do not support audio books then you must copy an audiobook folder (with the name audiobook or audio) inside an epub file.
Sipurra will identify that this folder exist in an epub file and will show the media player. in this case the media player progress and the book progress cannot be synced, so the application provide a separate seeking, chapter and bookmarking for the audio book and a separate one for the epub.

If you are using calibre and have an audiobooks folder, then you can use this to automatically combine them together without changing the files on the disk https://github.com/eserero/calibre2komga

Bug Fixes

• EPUB3 Reading Position: Fixed a bug where rotating the screen would cause the EPUB3 reader to lose the current reading position.
• Floating UI Stability: Fixed layout instability and flickering in the new floating navigation bar when switching between screens.

Release 1.9.0

Release 1.9.0 Summary

User-Facing Features

📂 Open Local Files (Android)

• Open from Device: You can now open .cbz and .epub files directly from your device's file manager using Komelia.
• Saved Progress: Komelia now remembers your reading progress and bookmarks for these local files.

✨ Visual Customization

• Thumbnail Styling: New appearance settings for Thumbnail Shadow and Corner Radius are now available.
• Improved Consistency: Reverted New UI 2 thumbnail fonts to match the standard UI for a more uniform look.

🎧 Audio Player Updates (EPUB)

• New Controls: Added a Bookmark button and a 0.5x playback speed option to the main audio player screen.

Bug Fixes

• Selection Bars: Fixed multi-selection bars to correctly use the app accent color and improved text contrast for better readability.
• Grid Alignment: Fixed thumbnails not being centered in the grid when using the "card width scale" setting.
• Immersive Menus: Fixed the missing "Edit" option in the oneshot screen menu.
• Layout Stability: Fixed various alignment and scaling issues in list views to ensure a more stable layout.

---

Full Commit History Since 1.8.0

Commit: 65fd150

Author: eserero eserero@hotmail.com
Date: Tue Apr 14 12:03:14 2026 +0300

docs: add implementation details for local file intent support

• Document the intent filter setup for CBZ and EPUB files
• Explain the integration between LocalFileBookApi and the reader UI
• Detail the read progress persistence for local files

---

Commit: cf52137

Author: eserero eserero@hotmail.com
Date: Tue Apr 14 11:58:20 2026 +0300

feat(android): open local CBZ/EPUB files via intent

• Add ACTION_VIEW intent filters to MainActivity so Android offers
  Komelia in the "Open with" dialog for .cbz and .epub files
• Split intent filters: one MIME-type-based (fixes dot-in-filename
  issue with content:// URIs) and one path-pattern-based for file://
• Use singleTask launch mode so re-opening a file calls onNewIntent
  on the existing activity instead of creating a duplicate
• LocalFileBookApi reads pages from local zip archives via
  ContentResolver; supports both CBZ and EPUB
• LocalFileReadProgressRepository persists read progress and EPUB
  bookmarks across sessions keyed by a stable virtual book ID
• When a local file intent arrives while a book is already open,
  popUntilRoot() closes the current reader cleanly before opening
  the new one

Co-Authored-By: Claude Sonnet 4.6 noreply@anthreply.com

---

Commit: 4b813f2

Author: eserero eserero@hotmail.com
Date: Mon Apr 13 23:44:41 2026 +0300

feat(ui): fix list card layout and thumbnail scaling

• Update LibraryItemCard to use IntrinsicSize.Min width and height-priority aspect ratio for stable list layouts
• Fix BookDetailedListCard and SeriesDetailedListCard to use top alignment and fixed width for thumbnails
• Restrict list card titles and summaries to 2 lines for better compactness
• Update README.md with improved formatting for the fork introduction

---

Commit: 10ffff0

Author: eserero eserero@hotmail.com
Date: Mon Apr 13 23:16:15 2026 +0300

feat(epub): improve audio player media controls

• Add bookmark toggle button to the right of the chapter chip, reusing Epub3BookmarkToggleButton with identical behavior to the controls card
• Add 0.5× speed option to playback speed chips
• Remove "Speed" text label from speed section (chips are self-explanatory)
• Center speed chip rows

Co-Authored-By: Claude Sonnet 4.6 noreply@anthreply.com

---

Commit: 36f9599

Author: eserero eserero@hotmail.com
Date: Mon Apr 13 15:26:37 2026 +0300

feat(ui): add thumbnail shadow and corner radius settings and fix layout issues

---

Commit: e0603eb

Author: eserero eserero@hotmail.com
Date: Mon Apr 13 13:42:25 2026 +0300

ui: improve multi-selection bars

• use Popup for BulkActionsContainer to ensure it's rendered above other elements
• use LocalAccentColor for background of both top and bottom selection bars
• add status bar padding to top selection bar when using transparent bars
• add luminance-based content coloring for better contrast

---

Commit: 36861f0

Author: eserero eserero@hotmail.com
Date: Mon Apr 13 13:20:49 2026 +0300

style: revert New UI 2 thumbnail font to match standard UI

---

Commit: 82bbd3f

Author: eserero eserero@hotmail.com
Date: Mon Apr 13 13:04:45 2026 +0300

fix(ui): add edit option to oneshot immersive screen dropdown

---

Commit: 0dff584

Author: eserero eserero@hotmail.com
Date: Mon Apr 13 12:52:45 2026 +0300

fix(ui): center thumbnails within grid cells when cardWidthScale is applied

---

1.8

Komelia 1.8 Release Letter

User Facing Changes

Features

• Thumbnail Customization: New sliders in Appearance settings to adjust thumbnail scaling (width and height) and row spacing.
• EPUB Reader Enhancements:
  • Full-Text Search: Integrated search capability with context snippets and absolute location markers.
  • Unified Navigation: Combined Table of Contents and Bookmarks into a single, swipeable multi-tab dialog.
  • Local Bookmarks: Added support for adding and managing bookmarks with local persistence.
  • Improved Loading: New step-by-step loading screen that prioritizes local files for faster opening of downloaded books.
  • Swipable Settings: Implemented animated, swipable tabs in reader settings and bottom sheets.
• Offline Improvements: Local-first page loading and a new "server unavailable" dialog for better handling of network issues. - if the comic file is downloaded, it will be used even in online mode for faster loading.
• Visual Updates: Refreshed project documentation with 33 new screenshots.
• New Application Icon: Updated application icons and thumbnails for Android and Desktop.

Bug Fixes

• Fixed the "Delete downloaded" menu option not appearing when the app is online.
• Fixed software keyboard behavior and theme consistency in EPUB search.
• Resolved EPUB reader stability issues, including rare crashes (NPE) and audio synchronization bugs.
• Fixed audio player theming and bookmark display consistency in non-immersive mode.

---

1.7.0

Release 1.7.0

Features

• Updates:
  • Migrated update source to eserero/Komelia for independent versioning and faster releases.
  • Added robust support for v prefix in version tags.
• EPUB3 Reader:
  • Added support for loading custom TTF/OTF fonts.
  • Added date, time, and location overlays for better reading context.
• UI Improvements:
  • Added screen rotation lock support.
  • Improved reader top bar by removing unnecessary parentheses in titles.
  • Enhanced Immersive Mode with thumbnail size fixes and layout optimizations.

Fixes

• UI: Resolved hero text blinking during transitions in the immersive scaffold.
• Settings: Updated default application settings for an improved initial experience.

1.6

• 🎧 EPUB3 Audio & Text Sync: Major improvements to media overlay synchronization, including better handling of spanning paragraphs and manual navigation.
• 📚 Library UI Refinements: Redesigned library header and "Continue Reading" sections for a cleaner, unified mobile layout.
• 🔄 Improved Sorting: Added a sorting dropdown to the library screen and updated the default sort order to "Recently Added."
• 🛠️ UX Fixes: Resolved settings content padding issues and added detailed diagnostic logging for audio/text synchronization.

Version 1.5 - New UI 2 - updated

New UI 2 - User-Facing Features Summary

This branch implements a major visual and functional overhaul of the Komelia application, primarily focused on the "New UI 2" experience.

Core Visual Overhaul

• New UI 2 Gating: A comprehensive redesign of the Library, Home, and Search screens, featuring a modern top app bar and updated item card layouts.
• Frosted Glass (Haze) Effect: Implementation of real-time blur/frosted glass effects on navigation bars, top app bars, and reader controls for a more modern, integrated aesthetic.
• Modern Themes: Introduction of "Light Modern" and "Dark Modern" themes specifically designed for transparent status and navigation bars.
• Typography: System-wide upgrade to the Inter font family with refined header alignments.

Immersive Screen Enhancements

• Hero Text Morphing: A new "flying" animation where the cover image morphs seamlessly into the thumbnail position when expanding the immersive Book, Series, or Oneshot screens.
• Standalone Morphing Toggle: A dedicated "Morphing Immersive Cover" setting allows users to enable this animation independently of the global "New UI 2" flag.

Reader Improvements (EPUB & Image)

• Edge-to-Edge UI: Readers now support a fully immersive, edge-to-edge experience with translucent, frosted glass control bars.
• Configurable Margins: EPUB reader adds adjustable top and bottom margins (0-20%) to better accommodate various screen shapes and user preferences.
• Improved Navigation: System back button support for closing overlays and exiting the reader.

Library & Discovery

• Reading Filter Chip: A new dedicated "Reading" filter in the library screen to quickly access ongoing books.
• Refined "Continue Reading": Polished the "Continue Reading" section with a full-width design and optimized spacing.
• Improved Iconography: Updated visuals for "Downloaded" indicators on books and series for better clarity.

Audio Player

• Mini Player Redesign: The audio mini-player has been updated with larger corner radii and a wider layout to match the "New UI 2" design language.

---

1.4 — Epub3 Reader & Immersive Screens

EPUB3 Reader

Core Reader

• EPUB3 native reader: Integrated the Readium/Storyteller EPUB reader engine as a new reader type, selectable from Settings → EPUB Reader. The WebView-based reader renders full EPUB3 content.
• Reading progress: Position is saved on every page turn and restored when you reopen a book. Respects the "mark read progress" setting.
• Controls overlay: Tap the center of the screen to toggle a top bar showing the book title and a close/back button. Tap outside to dismiss.
• Android back button: Hardware back closes the reader correctly.
• OOM-safe loading: Large audiobook EPUBs are streamed to disk in chunks instead of loading fully into RAM, eliminating ~415 MB heap spikes.

Media Overlay / Audiobook Sync

• Synchronized read-aloud: Full media overlay player — text segments are highlighted in sync with audio playback as you listen.
• First-segment highlight fix: The current sentence lights up immediately when you press Play, not just after the first segment change.
• Mini player pill: A persistent pill at the bottom of the reader shows cover art, book title, chapter, and Prev/Next chapter buttons while collapsed.
• Full-screen audio player: Tap the pill to expand into a full-screen player with cover art hero, book & chapter title, elapsed/remaining time, seekable progress bar, playback speed chips, chapter chip, volume slider, and Prev/Next chapter.
• Shared-element transition: The mini player expands into the full-screen player via a smooth container-transform animation with drag-to-dismiss.
• Drag-to-dismiss: The full-screen player can be dragged down to dismiss; springs back with a bounce animation if you don't dismiss.
• Cover art in system notification: The media notification (lock screen / notification shade) shows the book's cover art.
• Clip caching: Media overlay clips are persisted to disk on first open, so SMIL parsing is skipped on subsequent opens.

Table of Contents

• TOC dialog: Hierarchical table of contents with expandable/collapsible chapters.
• Current chapter highlight: The active chapter is highlighted in the accent color.
• Auto-scroll: The TOC scrolls automatically to bring the current chapter into view when opened.
• Auto-expand: Ancestor branches containing the current chapter are expanded automatically.

Page Navigation

• Page navigator row: A slider bar with +/− buttons flanking it for precise page-by-page navigation within a chapter.
• Location label: Shows current position (page within chapter); updates live on every swipe and while dragging the slider.

Settings

• Audio settings tab: A dedicated tab in the reader settings for audio/media overlay options.
• Immersive navigation bar setting: Settings → Appearance → option to show/hide the navigation bar in immersive screens.
• EPUB reader type selector: Choose between reader implementations from the EPUB reader settings screen.

---

Immersive Detail Screens (Book / Series / Oneshot)

• Split FAB menu: The floating action button now splits into a menu (e.g. Read vs. Listen) when multiple actions are available.
• Blurred cover art backdrop: The detail card (book/series/oneshot/audio player) now shows the cover art blurred behind a semi-transparent scrim. Respects the "immersive card color" toggle — disabling it falls back to plain opaque surface.

v1.3.0

v1.3.0 - Latest Changes Summary:

UI & Material 3 Refinements

• Thinning Slider Handle: Implemented M3-compliant handle animation that thins when grabbed.
• Enhanced Accent Colors: Improved support for dynamic accent colors across chips, toolbars, and switches.
• Library Modernization: Upgraded library headers to Material 3 with persistent view states.

Reader & EPUB Enhancements

• EPUB Web Assets: Integrated built web reader assets and fixed build automation for the EPUB viewer.
• Smooth Paged Navigation: Eliminated visible pauses during slow page swipes in the paged reader.

Android Stability & Fixes

• Backgrounding Fix: Resolved NotSerializableException when the app is put into the background on Android.
• Performance Improvements: Refactored settings navigation and optimized NCNN upscaler integration.