08shiro80/komga repository overview

⁠Komga with MangaDex Downloader

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

⁠Why This Fork?

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

⁠Key Features

⁠MangaDex Download System

Download manga directly from MangaDex with full automation:

• Queue-based downloads with priority support
• Real-time progress via Server-Sent Events (SSE)
• ComicInfo.xml injection - metadata embedded in every CBZ
• Crash recovery - downloads resume from last completed chapter
• Rate limiting - respects MangaDex API limits
• Multi-language support - download chapters in your preferred language

POST /api/v1/downloads
{
  "url": "https://mangadex.org/title/...",
  "libraryId": "your-library-id"
}

⁠Follow List Automation

Automatically check for new chapters from your favorite manga:

1. Create a follow.txt file in your library root
2. Add MangaDex URLs (one per line)
3. Configure check interval (default: 24 hours)
4. 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

⁠Tachiyomi/Mihon Migration

Import your MangaDex library from Tachiyomi or Mihon:

• Supports .tachibk (Mihon/forks) and .proto.gz (Tachiyomi) formats
• Extracts all MangaDex URLs from your backup
• Adds URLs to your library's follow.txt
• Duplicate detection prevents re-adding existing URLs

POST /api/v1/tachiyomi/import
Content-Type: multipart/form-data

⁠Tall Page Splitting

Split long vertical webtoon pages into readable segments:

• Configurable maximum height threshold
• Batch processing for entire libraries
• Preserves original files (creates new split versions)
• Similar to TachiyomiSY's "split tall images" feature

GET  /api/v1/media-management/oversized-pages
POST /api/v1/media-management/oversized-pages/split/{bookId}
POST /api/v1/media-management/oversized-pages/split-all

⁠Enhanced Metadata

Rich metadata from multiple sources:

MangaDex Metadata Plugin:

• Fetches title, description, authors, artists
• Multi-language title support (10+ languages)
• Genre and tag mapping
• Cover art downloading

AniList Metadata Plugin:

• GraphQL-based metadata fetching
• Configurable title preference (English/Romaji/Native)
• Detailed series information

⁠Chapter URL Tracking

Never download the same chapter twice:

• Imports from gallery-dl's .chapter-urls.json
• Database persistence for crash recovery
• Tracks chapter metadata (volume, language, scanlation group)
• API to check/clear download history

⁠API Endpoints

⁠Downloads

⁠Follow Configuration

⁠Media Management

⁠System

⁠Installation

⁠Requirements

• Java 21+
• gallery-dl⁠ (pip install gallery-dl)

⁠Docker (Recommended)

docker pull 08shiro80/komga:latest

docker run -d \
  --name komga \
  -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
    ports:
      - "25600:25600"
    volumes:
      - ./config:/config
      - /path/to/manga:/manga
    restart: unless-stopped

docker compose up -d

⁠Updating gallery-dl in Docker

To update gallery-dl to the latest version inside your running container:

docker exec komga pip install -U gallery-dl

⁠JAR

java -jar komga.jar

⁠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

⁠gallery-dl Setup

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

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

⁠Follow List Check Interval

Configure via API or application properties:

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

⁠Comparison with Original Komga

⁠Documentation

• Download System Guide⁠
• Follow List Setup⁠
• Tachiyomi Migration⁠
• Page Splitting⁠
• Metadata Plugins⁠
• API Reference⁠

⁠Tech Stack

• Backend: Kotlin, Spring Boot, jOOQ
• Frontend: Vue.js 2, Vuetify, TypeScript
• Database: H2 (embedded) / SQLite
• Downloads: gallery-dl integration
• Metadata: MangaDex API, AniList GraphQL

⁠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

• Komga⁠ by gotson - The excellent base media server
• gallery-dl⁠ by mikf - Download engine
• MangaDex⁠ - Manga source and API
• AniList⁠ - Metadata source

⁠License

MIT License⁠