KMReader

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

Important Features

Reading Experience

• DIVINA reader on iOS/macOS/tvOS with LTR, RTL, vertical, spreads, zoom, and page curl transitions.
• Webtoon reading mode on iOS/macOS.
• EPUB reader on iOS/macOS with paged and scrolled flow, custom fonts (.ttf/.otf), and per-book preferences.
• PDF reading on iOS/macOS with native PDF mode, search, table of contents, and page jump.
• Per-book reading preferences and Incognito mode.

Dashboard and Discovery

• Dashboard sections for Keep Reading, On Deck, recently added/updated content, and pinned sections.
• Pin collections and read lists to keep favorites at the top.
• Reading Stats page for daily, weekly, and monthly reading insights.
• Browse Series, Books, Collections, and Read Lists with metadata filters (publisher, author, genre, tag, language).

Offline and Sync

• Download books for full offline reading.
• iOS background downloads with Live Activities.
• Per-series download policies: Manual, Unread only, Unread + cleanup, and All books.
• Offline mode supports metadata-based filtering to quickly find downloaded books.
• Progress and offline data sync automatically when reconnecting.

Multi-Server and Management

• Save multiple Komga servers and switch instantly.
• Sign in with username/password or API key.
• Admin tools for metadata editing, library management, task management, and logs.

Platform Highlights

• iOS/iPadOS: widgets, quick actions, background downloads, Live Activities.
• macOS: dedicated reader windows and keyboard-first controls.
• tvOS: remote-first DIVINA reading.

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