This is a set of utilities I developed while moving my 70,000+ comic library to Komga.

As I've continued to work on it, add features and discuss with other users, I wanted to pivot away from usage as an accessory to Komga and focus on it as a stand-alone app.

The app is intended to allow users to manage their remote comic collections, performing many actions in bulk, without having direct access to the server. You can convert, rename, move, enhance CBZ files within the app.

Full documention and install steps have moved to Gitbook.io

Here's a quick list of features

1. Rename - All Files in Diretory
2. Convert Directory (CBR / RAR Only)
3. Rebuild Directory - Rebuild All Files in Diretory
4. Convert PDF to CBZ
5. Missing File Check
6. Enhance Images
7. Clean / Update ComicInfo.xml

1. Rebuild/Convert (CBR --> CBZ)
2. Crop Cover
3. Remove First Image
4. Full GUI Editing of CBZ (rename/rearrange files, delete files, crop images)
5. Add blank Image at End
6. Enhance Images (New in 2.0)
7. Delete File

1. Send Downloads from GetComics.org Directly to your Server
2. Support for GetComics, Pixeldrain and Mega
3. Chrome Extension
4. Download Queue
5. Custom Header Support (for Auth or other variables)
6. Support for PixelDrain API Key

1. Source and Destination file browsing
2. Drag and drop to move directories and files
3. Rename directories and files
4. Delete directories or files
5. Rename All Files in Directory
6. Remove Text from All Files in Directory

1. Auto-Renaming: Based on the manually triggered renaming, this option will monitor the configured folder.
2. Auto-Convert to CBZ: If this is enabled, files that are not CBZ will be converted to CBZ when they are moved to the /downloads/processed location
3. Processing Sub-Directories: If this is enabled, the app will monitor and perform all functions on any sub-directory within the default monitoring location.
4. Auto-Upack: If enabled, app will extract contents of ZIP files when download complete
5. Move Sub-Directories: If enabled, when processing files in sub-directories, the sub-directory name will be cleaned and moved
6. Custom Naming Patterns: Define how files are renamed in the Settings of the App

1. Follow the steps in the full documentation to create a mySQL server running an export of the Grand Comics Database (GCD) data dump and quickly add metadata to files.

Copy the following and edit the environment variables

⚠️ Windows/WSL Users: If you're deploying on Windows with WSL, see WINDOWS_WSL_SETUP.md for important PUID/PGID configuration instructions.

version: '3.9'
services:
    comic-utils:
        image: allaboutduncan/comic-utils-web:latest

        container_name: comic-utils
        logging:
            driver: "json-file"
            options:
                max-size: '20m'  # Reduce log size to 20MB
                max-file: '3'     # Keep only 3 rotated files
        restart: always
        ports:
            - '5577:5577'
        volumes:
            - '/var/run/docker.sock:/tmp/docker.sock:ro' # do not change this line
            - '/path/to/local/config:/config' # Maps local folder to container
            ## update the line below to map to your library.
            ## Your library MUST be mapped to '/data' for the app to work
            - 'D:/Comics:/data'
            ## Additional folder if you want to use Folder Monitoring.
            - 'F:/downloads:/downloads'
        environment:
            - FLASK_ENV=development
            ## Set to 'yes' if you want to use folder monitoring.
            - MONITOR=yes/no
            ## Set the User ID (PUID) and Group ID (PGID) for the container.
            ## This is often needed to resolve permission issues, especially on systems like Unraid
            ## where a specific user/group owns the files.
            ## For Unraid, PUID is typically 99 (user 'nobody') and PGID is typically 100 (group 'users').
            ## For Windows/WSL, you need to set these to match your Windows user ID (see WINDOWS_WSL_SETUP.md)
            # - PUID=99
            # - PGID=100
            ## Set the file creation mask (UMASK). 022 is a common value.
            # - UMASK=022

Update your Docker Compose: Mapping the /config directory is required now to ensure that config settings are persisted on updates. First Install: On the first install with new config settings, visit the config page, ensure everything is configured as desired.

• Save your Config settings
• Click the Restart App button

For the utility to work, you need to map your Library to /data

I am running Komga on my Windows home server, via Docker.

My comics are located in D:/Comics therefore, my mapping is: - "D:/Comics:/data"

In your browser, navigate to http://localhost:5577

You'll be presented with the main screen, where you can select which option you'd like to perform. The app will default to "Directory" operations.

If you enjoyed this, want to say thanks or want to encourage updates and enhancements, feel free to

With the 2.0 release, full documention and install steps have moved to Gitbook.io