Sipurra - Komga media client

What's New in this Fork

Sipurra is a fork of Komelia focused on improving the Android experience. It contains all the good in Komelia and adding many new featurs:

• Completly revamped UX
• Multi-Server Support: Support for adding and switching between multiple Komga server accounts.
• New epub3 reader supporting immersive Audio + Text reading (based on storyteller)
• Audio books playback with live transcription.
• Many new features in the comic reader (OCR text selection, AI upscaling, additional navigation options, improved panel mode and more)
• Bookmarks and Annotation support for books and audiobooks, Annotation and highlighting for books and comics. Fully Synchronized between devices.
• Local File Support: Native support for PDF, CBR, and CBZ files with page and bookmark persistence.
• Much more - read below to find out :-)

New UX and Themes

• Material 3: Standardized M3 TopAppBar with cleaner menu location and a hamburger menu to choose the library. Floating FAB to open the filter dialog. Standardize Navigation Bar.
• 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.
• Smaller Thumbnails: allowing smaller thumbnails in the setting screen (choose 110) which shows 3 thumbnail per row instead of only two. Thumbnails are also nicer with some options to choose from (text below thumbnail, transparent background for text)
• New Dark and Light Themes: clearer colors, supporting "Haze" effect (transparency with blur) for toolbars and some of the floating elements.

Library Screen

• New screen design: cleaner headers, easier sorting access and new UX elements.
• "Keep Reading" Strip: A new horizontal quick-access strip in the series list for your recently read books per library.
• Improved Filtering UI: Improve and cleanup of some of the search elements and fixed some bugs
• Library Navigation and Persistence: clicking on the Library navigation button Automatically remembers the last library you were - so you dont need to choose the library every time.

Library Light Theme	Library Dark Theme	Library with Continue Reading

Home Screen

• New screen design: similar to the library screen, Section management and settings moved to a Floating Action Button at the bottom-right for easy one-handed use.
• Horizontal Layout: Organized content into horizontal rows (Keep Reading, On Deck, etc.) for a compact and discoverable dashboard. This is similar to how komga web show it.
• Offline Toggle: Quick-toggle in the top app bar to manually switch between online and offline modes.

Search

• Updated screen design: similar to library and home screens with Full M3 SearchBar implementation with smooth animations, native back-navigation, and clear-text support.

Immersive Detail Screens (Book, Series, Oneshot)

• Immersive Screen: Full-bleed cover images extending behind information card for a modern, cinematic feel. ability to swipe left right to move between books, floating buttons to easily read and download.
• Publisher Icons: Showing publisher icon in the immersive screen (if there is a match).
• Adaptive Card Color: Detail card backgrounds dynamically sample and apply dominant colors and blurred texture from the cover artwork. Controlled in the settings.
• Elevated Card UI: Material 3 elevated specifications with standard typography and smooth shared-element transitions from the library list.

Immersive Series (Collapsed)	Immersive Series (Expanded)	Immersive Series (Alt)

Immersive Series (Alt Expanded)	Immersive Book View	Immersive Book (Expanded)

Image/Comic Reader

• New Controls UX: Aligned with the new epub reader and matching the new dark/light teams and immersive card color. provide easy access to switching between reading modes (Page, continous, panel), turn on/of upscaling and lock screen rotation.
• OCR Text Selection: Integrated Google ML Kit and RapidOCR for text recognition. Supports on-demand scanning and an "Auto-Scan" mode. OCR bounding boxes are logically merged based on reading direction (LTR/RTL).
• Text Actions: Directly Translate, copy text, or create annotations from OCR-selected text (with the note automatically pinned to the relevant area).
• Thumbnail Carousel: A horizontal thumbnail strip for fast visual navigation, with auto-scroll synchronization to keep the active page centered.
• Adaptive Immersive Backgrounds: gradient backgrounds that sample edge colors in real-time for both Paged and Panel modes.
• High-Performance GPU Upscaling: Integrated NCNN-powered upscaling specifically optimized for Android GPU hardware.
• Swiping Navigation in Page Mode: swiping now work and allow you to move forward/backward pages smoothly.
• Improved Panel Navigation: Smooth pan-and-zoom animations. Ability to show the full screen before and/or after the panels for context.
• Save Current Image: long-press quick-save to Downloads
• Double Tap to Zoom: ability to configure double-tap to zoom for panel and page modes.
• Additional Navigation Options: Multiple tap-zone configurations for forward/backward navigation.
• Navigation History: Added navigation history and a floating back button for better exploration.
• Keep Screen Awake: setting to prevent the screen to turn off when in the reader.

Adaptive Backgrounds

Light Theme	Dark Theme	Controls Hidden

GPU Upscaling Comparison

Without Upscaling	With Upscaling

Without Upscaling (Controls)	With Upscaling (Controls)

Without Upscaling (B&W)	With Upscaling (B&W)

Epub Reader with support for Epub 3 audio layer and Audio Books

• New Epub Viewer: Completely new epub viewer based on Storyteller and Redium Kotlin Tookit. Support epubs with audio layer for combined text + Audio reading.
• Text Selection & Translation: Long-press text to access a native context menu with Translate, Copy, and Search options.
• Audio Book player: Integrated player with chapter navigation, mini player, and full-screen interface.
  • Live Transcription: Real-time transcription for folder-based audiobooks using Whisper (Local/Native) and ML Kit. Includes a scrollable chat-log transcript UI.
  • Embedded Metadata & Chapters: Automatic extraction and caching of embedded chapter metadata for folder-based audiobooks (titles, start/end times and other metadata items).
  • Audio Metadata Dialog: View detailed track tags and embedded chapters directly from the player.
  • New controls: Completely new reading controls matching the new comic reader controls.
• New setting screen: Theme and appearance selection, margins, fonts, and audio settings.
• Better Navigation: Swipe to turn pages, scroll-based reading, etc.
• Bookmark and Search: New implementation of chapter, bookmarking, and text search.
• Keep Screen Awake: Master setting to prevent screen timeout in all reader modes.

Controls and Audio Player

Light Theme	Dark Theme	Mini Player

Expanded Audio Player

Light Theme	Dark Theme

Reader Features

Table of Contents	Bookmarks	Search

Settings Page

• Nicer Navigation page: Refactored menu structure for a more modern M3 look.
• Advanced Cache Management: User-configurable limits for Image and EPUB readers with LRU-based trimming and manual clearing options.
• New Visual Toggles: Immersive color strength sliders, unified app-wide accent color presets, and a master toggle for the "New Library UI".
• Deep Customization: Per-mode toggles for tap-to-zoom, configurable tap navigation zones, and granular adaptive background settings.

Comic Reader Settings

Reading Modes	Image Settings	Navigation

Epub Reader Settings

Appearance	Fonts	Audio

General improvements

• Prefer local files: If files are downloaded, they are used instead of the server.
• Improved Offline file support: Native support for local PDF, CBR files on device in addition to epub and cbz.
• Ability to open local files through android context: Open CBZ, CBR, PDF, and EPUB files from Android with page and bookmark persistence.
• Reload local cache: Scan for existing files to link them to the app, facilitating device transfers or fresh installs.

---

Many thanks to these projects, I used them as inspiration and shameleslly use code from them

• Storyteller: An Amazing application to merge audiobooks and epubs to a simless "kindle whisper" like experiense. I used the epub3 engine and added my controls on top. https://gitlab.com/storyteller-platform/storyteller
• waifu2x ncnn Vulkan: A cool little project that provided ncnn implementation on android, I integrated it into the reader to provide the upscaler functionality and to understand how to manage the ncnn models with gpu acceleration on android- it was very easy to integrate it into Komelia. https://github.com/nihui/waifu2x-ncnn-vulkan
• RealSR-NCNN-Android: This one provided many NCNN models on android and I used it in combination with the waifu2x code to add RealSR, RealCUGAN etc modelsn. https://github.com/tumuyan/RealSR-NCNN-Android

---

Downloads:

• Latest prebuilt release is available at https://github.com/Snd-R/Komelia/releases
• Google Play Store https://play.google.com/store/apps/details?id=io.github.snd_r.komelia
• F-Droid https://f-droid.org/packages/io.github.snd_r.komelia/
• AUR package https://aur.archlinux.org/packages/komelia

Screenshots

Mobile

Tablet

Desktop

Native libraries build instructions

Android and JVM targets require C and C++ compiler for native libraries as well nodeJs for epub reader build

The recommended way to build native libraries is by using docker images that contain all required build dependencies
If you want to build with system toolchain and dependencies try running:
./gradlew komeliaBuildNonJvmDependencies (Linux Only)

Desktop App Build

Requires jdk 17 or higher

To build with docker container, replace <platform> placeholder with your target platform
Available platforms include: linux-x86_64, windows-x86_64

• docker build -t komelia-build-<platfrom> . -f ./cmake/<paltform>.Dockerfile
• docker run -v .:/build komelia-build-<paltform>
• ./gradlew <platform>_copyJniLibs - copy built shared libraries to resource directory that will be bundled with the app
• ./gradlew buildWebui - build and copy epub reader webui (npm is required for build)

Then choose your packaging option:

• ./gradlew :komelia-app:run to launch desktop app
• ./gradlew :komelia-app:packageReleaseUberJarForCurrentOS package jar file (output in komelia-app/build/compose/jars)
• ./gradlew :komelia-app:packageReleaseDeb package Linux deb file (output in komelia-app/build/compose/binaries)
• ./gradlew :komelia-app:packageReleaseMsi package Windows msi installer (output in komelia-app/build/compose/binaries)

Android App Build

To build with docker container, replace <arch> placeholder with your target architecture
Available architectures include: aarch64, armv7a, x86_64, x86

• docker build -t komelia-build-android . -f ./cmake/android.Dockerfile
• docker run -v .:/build komelia-build-android <arch>
• ./gradlew <arch>_copyJniLibs - copy built shared libraries to resource directory that will be bundled with the app
• ./gradlew buildWebui - build and copy epub reader webui (npm is required for build)

Then choose app build option:

• ./gradlew :komelia-app:assembleDebug debug apk build (output in komelia-app/build/outputs/apk/debug)
• ./gradlew :komelia-app:assembleRelease unsigned release apk build (output in komelia-app/build/outputs/apk/release)

Komf Extension Build

run./gradlew :komelia-komf-extension:app:packageExtension
output archive will be in ./komelia-komf-extension/app/build/distributions