Forge Miniv1.1.0Feature Complete

Variant Cover Organizer

Plan comic cover groups, report byte-identical files, and export verified source-to-destination manifests.

v1.1.0Current release

MITSource license

3Supported platform groups

Comics & CollectionsCatalog category

The problem it solves

Variant Cover Organizer [](https://github.com/loganpendragonmultiverse/variant-cover-organizer/actions/workflows/ci.yml)

Who Variant Cover Organizer is for

Collectors and readers who need a conservative way to organize or inspect their own files.
Users working with comics, covers, variants who want the documented v1.1.0 behavior.
People who prefer an open-source release with visible limitations, source, and license terms.

Intended result

Plan comic cover groups, report byte-identical files, and export verified source-to-destination manifests.

This summary is reconciled from the current catalog and repository documentation.

Features in v1.1.0

Capabilities below come from the current project README and release documentation.

[](https://github.com/loganpendragonmultiverse/variant-cover-organizer/actions/workflows/ci.yml)

Variant Cover Organizer converts an explicit CSV inventory into a safe grouping plan for comic cover variants. It validates source files, issue and variant labels, duplicate assignments, and destination collisions before optionally copying files into issue folders.

Verified examples

Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.

examples/covers/north-signal-4-a.svgVerified example included in the current source repository.examples/covers/north-signal-4-b.svgVerified example included in the current source repository.examples/covers/relay-team-1.svgVerified example included in the current source repository.examples/variants.csvVerified example included in the current source repository.

Platforms and implementation

The public release claims only the cataloged platforms and technologies.

Supported platforms

Windows
macOS
Linux

Built with

Python

Quick start

The shortest documented path into the current release.

python -m pip install .
variant-cover-organizer examples/variants.csv --source examples/covers
variant-cover-organizer variants.csv --source covers --copy-to organized-covers --output plan.json

Planning is the default. Reports flag byte-identical covers by grouping the SHA-256 fingerprints already calculated for safety. --copy-to creates a new destination through a staged directory, preserves every source file, and writes manifest.json mapping each source to its destination and fingerprint. Paths in the CSV must be relative and remain inside the selected source folder.

The tool does not identify cover art, scrape publisher metadata, or decide whether visually similar images are official variants. The user supplies the issue and variant identities. Requires Python 3.10 or newer.

Part of the Logan Pendragon Forge open-source collection. Licensed under the [MIT License](LICENSE).

Current limitations

These boundaries are part of the product and prevent the page from implying unverified capability.

The current v1.1.0 release is bounded by the behavior documented in its README and changelog. It does not claim unsupported platforms, automatic interpretation, or results beyond the evidence it produces.

Privacy and licensing

Review the actual data boundary before using a tool with sensitive inputs.

Privacy and safety

No privacy behavior beyond the current repository documentation is claimed. Review the source, security policy, and input/output behavior before using sensitive material.

License and release

Variant Cover Organizer is published under MIT. The current cataloged release is v1.1.0, published 2026-07-27.

Release and downloads Read the license

Related projects

Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.

Current public release