# \[APP\]\[Pro\] Komga comic book collection **URL:** \ **Category:** Apps\ **Tags:** app, homey-pro\ **Created:** [May 17, 2026, 11:25am UTC](https://community.homey.app/t/app-pro-komga-comic-book-collection/154996 "2026-05-17T11:25:31Z")\ **Posts on this page:** 1\ **Page:** 1
**Author:** ![jurjen74](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jurjen74/32/121571_2.png) [@jurjen74](https://community.homey.app/u/jurjen74)\ **Post date:** [May 17, 2026, 11:25am UTC](https://community.homey.app/t/app-pro-komga-comic-book-collection/154996/1 "2026-05-17T11:25:31Z")
# Komga for Homey I created an app for [managing Komga](https://homey.app/en-us/app/net.ladenius.komga/Komga/) Integrate your self-hosted [Komga](https://komga.org) comic and manga server with Homey. Monitor your library, track reading activity per household member, and trigger Homey flows when books are added or finished. ## Requirements - A running Komga instance (v1.19 or newer) reachable from your Homey - At least one Komga user account * * * ## Devices ### Komga Server One device represents one Komga server. It monitors the library and tracks newly added content. **Sensors** - **Books** — total number of books in the library - **Series** — total number of series in the library - **Status** — whether the Komga server is reachable **Triggers** - Komga server went offline - Komga server came back online - Book added to library — tokens: title, series, library - Series added to library — tokens: title, library, number of books - Any user started reading a book — tokens: title, series, user - Any user finished reading a book — tokens: title, series, user - Any user finished a complete series — tokens: series, number of books, user **Conditions** - Komga server is / is not online **Actions** - Scan a specific library - Scan all libraries * * * ### Komga User One device per household member. Uses that person’s own Komga credentials to track their individual reading activity. **Sensors** - **Unread** — number of unread books - **On Deck** — number of books Komga recommends reading next - **Reading** — number of books currently in progress **Triggers** - Started reading a book — tokens: title, series - Finished reading a book — tokens: title, series - Finished reading a complete series — tokens: series, number of books **Conditions** - User has / has no unread books - User is / is not currently reading * * * ## Widgets ### Recently Added Shows the most recently added books from the server’s library. Configurable layout (text only, cover and text, or covers only), optional week/month grouping, and adjustable item count. ### On Deck Shows the books Komga recommends next for a specific user — books in series where the user has already started reading. Displays reading progress as a percentage. ### Popular Shows the most-read books across all Komga User devices in the household, ranked by how many users have touched them. Useful for shared libraries. All widgets support three display modes: - **Text only** — compact list with title and subtitle - **Cover & text** — book cover thumbnail alongside metadata - **Covers only** — grid of thumbnails * * * ## Setup ### Adding a server 1. Go to **Devices** and add a new device from the Komga app 2. Choose **Komga Server** 3. Enter the full host URL including port, e.g. `http://192.168.1.10:25600` 4. Enter admin or read-only credentials and test the connection 5. Adjust the poll interval in device settings (default: 60 seconds, minimum: 15) ### Adding a user 1. Add another device and choose **Komga User** 2. Enter the same host URL as the server device 3. Enter that user’s own Komga credentials 4. Each person in the household gets their own device * * * ## Notes - The first poll after adding a device silently populates known books and series. Triggers only fire for content added after that point. - The **series finished** trigger fires when a user has read every book in a series — Komga tracks this per user. - Thumbnails in widgets are fetched server-side with authentication so they display without browser auth issues. - The popular widget automatically aggregates reading activity from all Komga User devices, regardless of which server device is selected for it.`Preformatted text`