komga-enhanced

Komga Enhanced

Komga Enhanced - A powerful manga media server with integrated manga downloading, automatic chapter tracking, and Tachiyomi/Mihon backup import.

Built on Komga - Extends the excellent Komga media server with manga downloading and automation features.

Why This Fork?

This fork transforms Komga from a pure media server into a complete manga management solution:

Problem Solution
Manually downloading manga Automatic downloads via gallery-dl — supports MangaDex and other manga/image sites
Losing track of downloaded chapters Chapter URL tracking prevents duplicates
Re-downloading after crashes DB + filesystem tracking - never re-download completed chapters
Title changes cause re-downloads UUID folder names - MangaDex UUID as folder name, immune to title changes
Folder renames break series Series survives folder rename - detects same series via MangaDex UUID, preserves progress and metadata
Unwanted chapters keep re-downloading Chapter blacklist - permanently block chapters from being downloaded
Syncing MangaDex subscriptions MangaDex Subscription Sync auto-downloads from your followed manga feed
No guest browsing for family Guest/Kiosk mode - read-only browsing without login, per-library access control
Migrating from Tachiyomi/Mihon Backup import extracts your MangaDex follows
Long vertical webtoon pages Page splitting like TachiyomiSY
Missing metadata MangaDex, AniList & Kitsu plugins for rich metadata
No server logs in UI Web-based log viewer - real-time auto-refresh, search, color-coded levels
Bland default theme 7 color themes - AMOLED, Nord, Dracula, Solarized, Green, Red + Default

Screenshots

Download Page

Download Page

New Download triggers a one-time download only — it does not add the URL to your follow list.

Plugin Configuration

Plugin Configuration Plugin Configuration 2 Save after edit

Plugin Manager

Plugins

Manual Backups

Manual Backups

Live Logs with Debug Toggle

Live Logs

Color Themes

Color Themes

Key Features

Download System

Download manga from MangaDex and other manga/image sites via gallery-dl:

Any manga/image URL supported by gallery-dl works — not just MangaDex. Simply paste the URL in the WebUI to start a download.

Follow List Automation

Automatically check for new chapters from your favorite manga:

  1. Create a follow.txt file in your library root
  2. Add URLs (one per line) — MangaDex URLs get fast aggregate checking, other sites use gallery-dl
  3. Configure check interval (default: 24 hours)
  4. Fast parallel checking via MangaDex aggregate API (~200 manga in 2 minutes)
  5. New chapters download automatically
# Example follow.txt
https://mangadex.org/title/a1c7c817-4e59-43b7-9365-09c5f56e5eb1
https://mangadex.org/title/32d76d19-8a05-4db0-9fc2-e0b0648fe9d0
https://mangahere.cc/manga/one_piece/
https://hdoujin.me/12345

MangaDex Subscription Feed Sync

Automatically sync new chapters from your MangaDex subscription feed — completely independent from the follow.txt system:

  1. Create a MangaDex API Client (Personal Client)
  2. Enable the mangadex-subscription plugin in Settings → Plugins
  3. Enter your client_id, client_secret, username, and password
  4. The syncer authenticates via OAuth2 and polls your follow feed

How it works:

Configuration (via Plugin Manager UI):

Setting Default Description
client_id — MangaDex API Client ID
client_secret — MangaDex API Client Secret
username — MangaDex username
password — MangaDex password
sync_interval_minutes 30 How often to check for new chapters

No app restart needed — the syncer automatically restarts when you save config or toggle the plugin.

Tachiyomi/Mihon Migration

Import your manga library from Tachiyomi or Mihon:

Tall Page Splitting

Split long vertical webtoon pages into readable segments:

Enhanced Metadata

Rich metadata from multiple sources:

MangaDex Metadata Plugin:

AniList Metadata Plugin:

Kitsu Metadata Plugin:

Chapter Blacklist

Permanently prevent unwanted chapters from being re-downloaded:

Automatic Same-Group Duplicate Detection

When a scanlation group uploads the same chapter multiple times on MangaDex (e.g. same chapter number, same group, different UUIDs), the system automatically detects this, keeps the newest upload, and blacklists the older duplicates. No manual intervention needed — the blacklisted count is included in the known count so the ChapterChecker stays in sync.

Chapter URL Tracking

Never download the same chapter twice:

Important: Import chapter URLs is enabled by default and required for the downloader, follow list, and subscription sync to detect already-downloaded chapters. Disable it in Library → Edit → Metadata for libraries that don’t use the download system — otherwise library scans will be significantly slower.

Guest/Kiosk Mode

Read-only browsing without login — perfect for family or shared setups:

Web Log Viewer

Admin-only log viewer in Settings → Logs:

Color Themes

7 predefined theme presets in Account → UI Settings:

Configurable Folder Naming

Choose how new manga folders are named:

Auto-Scan After Download

New chapters are automatically scanned after download completes:

API

Full API documentation with request/response examples: API Reference

Switching Between Official Komga and This Fork

The fork stores its database migrations in a separate history table (flyway_fork_history), completely independent from the official Komga migration history (flyway_schema_history):

Installation

Requirements

Image Description
08shiro80/komga:latest Stable release
08shiro80/komga-private:latest Testing branch — may contain unstable or experimental changes 
docker pull 08shiro80/komga:latest

docker run -d \
  --name komga \
  --network bridge \
  -p 25600:25600 \
  -v /path/to/config:/config \
  -v /path/to/manga:/manga \
  08shiro80/komga:latest

Docker Compose

version: "3.9"
services:
  komga:
    image: 08shiro80/komga:latest
    container_name: komga
    network_mode: bridge
    ports:
      - "25600:25600"
    volumes:
      - ./config:/config
      - /path/to/manga:/manga
    restart: unless-stopped

docker compose up -d

gallery-dl is installed via pip inside the Docker image. To update:

docker exec -u 0 komga pip3 install --break-system-packages -U gallery-dl

JAR

java -jar komga.jar

Important: Metadata Completeness

Full metadata in ComicInfo.xml and series.json (title, authors, genres, cover art, publish dates, scanlation group, etc.) is only guaranteed when downloading from MangaDex or when using the MangaDex/AniList metadata plugins. Other sites supported by gallery-dl will download chapters correctly, but metadata may be incomplete or missing.

Build from Source

# Build frontend
cd komga-webui && npm install && npm run build && cd ..

# Build backend with frontend
./gradlew prepareThymeLeaf :komga:bootJar

# Run
java -jar komga/build/libs/komga-*.jar

Configuration

Create ~/.config/gallery-dl/config.json:

{
  "extractor": {
    "mangadex": {
      "lang": ["en"],
      "chapter-filter": "lang == 'en'"
    }
  }
}

To use a local gallery-dl checkout (e.g. for latest extractors), set gallery_dl_path in the plugin config to the directory containing the gallery_dl package. This sets PYTHONPATH so python -m gallery_dl loads from your local source.

Follow List Check Interval

Configure via application properties:

komga:
  download:
    follow-check-interval: 24h

Comparison with Original Komga

Feature Original This Fork
Media Server Yes Yes
Manga Downloads No Yes
Automatic Chapter Tracking No Yes
MangaDex Subscription Sync No Yes
Follow List Automation No Yes
Chapter Blacklist No Yes
Series survives folder rename No Yes
Auto-scan after download No Yes
Configurable folder naming No Yes (UUID/title)
Guest/Kiosk Mode No Yes
Web Log Viewer No Yes
Color Themes No 7 presets
Tachiyomi Import No Yes
Page Splitting No Yes
AniList & Kitsu Metadata No Yes
Real-time Progress No Yes (SSE)

Documentation

Tech Stack

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Follow Conventional Commits
  4. Submit a pull request

See CONTRIBUTING.md for details.

Credits

License

MIT License

This site is open source. Improve this page.