komga-enhanced

Follow List Setup

Automatically download new chapters from your favorite manga using follow lists.

Overview

A follow.txt file in your library root tells Komga which manga to monitor for new chapters. The system periodically checks for updates and downloads them automatically.

Creating a Follow List

1. Navigate to your library folder (e.g., /manga/)
2. Create a file named follow.txt
3. Add manga URLs, one per line — MangaDex and any site supported by gallery-dl

Example follow.txt

# MangaDex URLs get fast aggregate checking
https://mangadex.org/title/a1c7c817-4e59-43b7-9365-09c5f56e5eb1
https://mangadex.org/title/32d76d19-8a05-4db0-9fc2-e0b0648fe9d0

# Other sites use gallery-dl for chapter checking
https://mangahere.cc/manga/one_piece/
https://hdoujin.me/12345

# Comments start with #
# Empty lines are ignored

Configuration

Via API

Get current configuration:

curl http://localhost:25600/api/v1/downloads/follow-config

Update configuration:

curl -X PUT http://localhost:25600/api/v1/downloads/follow-config \
  -H "Content-Type: application/json" \
  -d '{
    "libraryId": "your-library-id",
    "enabled": true,
    "checkIntervalHours": 24
  }'

Configuration Options

Option	Default	Description
enabled	true	Enable/disable follow list checking
checkIntervalHours	24	Hours between checks

How It Works

1. Scheduler runs at configured interval
2. Reads follow.txt from each library
3. Checks for new chapters — MangaDex via aggregate API, other sites via gallery-dl
4. Compares against downloaded chapter history
5. Downloads only new chapters
6. Updates chapter tracking database

Per-Library Configuration

Each library can have its own follow list and settings:

/manga/
├── follow.txt          # Library-specific follow list
├── Series A/
│   └── ...
└── Series B/
    └── ...

/comics/
├── follow.txt          # Different follow list for comics library
└── ...

Checking Status

View scheduled tasks:

curl http://localhost:25600/api/v1/downloads/scheduler

Response:

{
  "libraries": [
    {
      "libraryId": "abc123",
      "libraryName": "Manga",
      "enabled": true,
      "nextCheckAt": "2024-01-15T12:00:00Z",
      "lastCheckAt": "2024-01-14T12:00:00Z",
      "urlCount": 15
    }
  ]
}

Manual Trigger

Force an immediate check:

curl -X POST http://localhost:25600/api/v1/downloads/follow-check/{libraryId}

Best Practices

1. Start small - Add a few manga first to test
2. Use comments - Document why you’re following each manga
3. Check logs - Monitor for download errors
4. Set reasonable intervals - 24 hours is usually sufficient

Troubleshooting

New chapters not downloading

• Verify follow.txt exists and is readable
• Check if follow list checking is enabled
• Verify URLs are valid (MangaDex or gallery-dl supported sites)
• Check download queue for pending items

Duplicate downloads

• Run library scan to import existing .chapter-urls.json
• Check chapter URL database for gaps

Scheduler not running

• Verify application has write access to config directory
• Check application logs for scheduler errors
• Restart application if needed

This site is open source. Improve this page.