KMReader

Native SwiftUI Komga client for iOS, macOS, and tvOS.

Important Features

Native Reading Experience

• DIVINA reader on iOS, macOS, and tvOS with LTR, RTL, vertical, Webtoon, spreads, zoom, customizable tap zones, page curl, and iOS cover-style page transitions.
• EPUB reader on iOS/macOS with paged, scrolled, and curl layouts, custom font importing (.ttf/.otf), theme presets, multi-column reading, and nested table of contents.
• Animated pages use native inline playback with visible preparation progress and smoother performance for long reading sessions.
• PDF reading on iOS/macOS with a native PDF reader or DIVINA mode, plus search, table of contents, page jump, and clearer offline preparation feedback.
• Per-book preferences save reading direction, page layout, and theme settings.
• Incognito mode and iOS Live Text support, including optional shake-to-toggle.

Dashboard and Discovery

• Dashboard sections for Keep Reading, On Deck, Recently Added, Recently Updated, and pinned collections/read lists.
• Browse Series, Books, Collections, and Read Lists with metadata filters for publishers, authors, genres, tags, and languages using all/any logic.
• Save and reuse filters across browse surfaces.
• Reading history and stats help surface recent activity from synced local data.
• Spotlight integration for downloaded content on iOS/macOS, plus iOS widgets and Home Screen quick actions for Keep Reading, Search, and Downloads.
• UI localization includes English, German, French, Japanese, Korean, Simplified Chinese, Traditional Chinese, Italian, Russian, and Spanish.

Offline and Sync

• Download books for full offline reading across DIVINA, EPUB, and PDF workflows.
• Manual offline mode controls and resilient iOS background downloads for page files and extra resources.
• iOS Live Activities for both active reading sessions and downloads.
• Per-series download policies: Manual, Unread only, Unread + cleanup, and All books.
• Offline mode includes dedicated downloaded-library browsing and metadata filters.
• Progress and offline data sync automatically when reconnecting, including safer conflict handling.
• Cache controls cover pages and thumbnails.

Multi-Server and Management

• Save multiple Komga servers and switch instantly.
• Sign in with username/password or API key, and manage Komga API keys inside the app.
• Admin tools for metadata editing, library management, task monitoring, and log viewing/export.

Platform Highlights

• iOS/iPadOS: widgets, quick actions, Spotlight search, Dynamic Island Live Activities for reader/downloads, background downloads, Live Text, and page curl/cover transitions.
• macOS: dedicated reader windows, Spotlight search for downloaded content, keyboard shortcuts, and keyboard help overlay.
• tvOS: remote-first DIVINA reading with a TV-optimized browsing experience.

Getting Started

Prerequisites

• Komga 1.19.0+
• Xcode 15.0+
• iOS 17.0+, macOS 14.0+, tvOS 17.0+

Build and run

git clone https://github.com/everpcpc/KMReader.git
cd KMReader
open KMReader.xcodeproj

make build-ios
make build-macos
make build-tvos

make run-ios-sim
make run-macos
make run-tvos-sim

Compatibility

• Komga API v1 and v2

Community

• Discord