A full-featured native SwiftUI client for Komga — powerful readers, offline sync, library management, and admin tools.
- DIVINA Reader (iOS, macOS, tvOS): LTR/RTL/vertical/Webtoon modes with spreads, zoom, customizable tap zones, and page curl transitions. Live Text support with shake-to-toggle on iOS.
- EPUB Reader (iOS, macOS): Native engine with custom font importing (.ttf/.otf), theme presets, multi-column layouts, and nested TOC navigation.
- Per-Book Preferences: Save reading direction, page layout, and theme settings per book.
- Incognito Mode: Read without saving progress to server.
- Background Downloads: URLSession-based downloads with Live Activities on iOS.
- Series Policies: Manual, unread-only, unread+cleanup, or all books per series.
- Offline Mode: Full reader functionality with downloaded content. Progress syncs when reconnected.
- Three-Tier Caching: Pages, book files, and thumbnails with adjustable limits and auto-cleanup.
- Dynamic Dashboards: Keep Reading, On Deck, Recently Added, Recently Updated with real-time SSE updates.
- Advanced Filters: Search with metadata filters (authors, genres, tags, publishers) using all/any logic.
- Grid/List Layouts: Multiple density options (compact, standard, comfortable).
- Library Filtering: Browse per-library or across all libraries.
- Unlimited Servers: Save multiple Komga instances with password or API key authentication.
- Quick Switching: Instant server switching with isolated data per instance.
- API Key Management: Create, view, and revoke API keys.
- Metadata Editing: Edit series, books, collections, and read lists.
- Library Management: Create, edit, scan libraries with directory browser.
- Task Management: Monitor and cancel server tasks with live metrics.
- Logs Viewer: View and export app logs with filtering.
- iOS: Live Activities, background downloads, page curl transitions, shake gestures.
- macOS: Separate reader windows, comprehensive keyboard shortcuts, keyboard help overlay.
- tvOS: Remote control navigation, TV-optimized interface (DIVINA only).
- iOS 17.0+, macOS 14.0+, or tvOS 17.0+
- Xcode 15.0+
- Komga 1.19.0+ server
git clone https://github.com/everpcpc/KMReader.git
cd KMReader
open KMReader.xcodeprojBuild commands:
make build-ios # Build for iOS simulator
make build-macos # Build for macOS
make build-tvos # Build for tvOS simulator
make run-ios-sim # Run on iOS simulator
make run-macos # Run on macOS
make run-tvos-sim # Run on tvOS simulatorSee Makefile for all available commands.
- Requires Komga 1.19.0 or later
- Works with Komga API v1 and v2
- SSE support for real-time updates
- EPUB and Webtoon readers available on iOS/macOS only
Join the discussion on Discord.
Made with ❤️ for the Komga community
⭐ Star this repo if you find it useful!