Forge Miniv1.2.0Feature Complete

ComicInfo Editor Lite

Require optional archive SHA-256 and exact old-field preconditions before metadata changes. Absent and empty fields remain distinct; independent batch failures preserve page bytes and unknown XML.

Current release v1.2.0 View source

v1.2.0Current release

MITSource license

3Supported platform groups

Comics & CollectionsCatalog category

The problem it solves

ComicInfo.xml Editor Lite Plan or apply focused ComicInfo.xml metadata changes while preserving comic page bytes. Version 1.1 supports single archives, dry-run field diffs, JSON or CSV batch manifests, reusable JSON templates, recursive CBZ discovery, per-archive results, and transaction evidence. Writes always create separate validated CBZ archives.

Who ComicInfo Editor Lite is for

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

Intended result

Require optional archive SHA-256 and exact old-field preconditions before metadata changes. Absent and empty fields remain distinct; independent batch failures preserve page bytes and unknown XML.

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

Features in v1.2.0

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

Plan or apply focused ComicInfo.xml metadata changes while preserving comic page bytes. Version 1.1 supports single archives, dry-run field diffs, JSON or CSV batch manifests, reusable JSON templates, recursive CBZ discovery, per-archive results, and transaction evidence. Writes always create separate validated CBZ archives.

Verified examples

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

examples/batch.csvVerified example included in the current source repository.examples/expected-fields.jsonVerified example included in the current source repository.examples/metadata.jsonVerified 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

Changelog

Release notes from the canonical v1.2.0 source tag.

Added optional archive SHA-256 and exact old-field-value preconditions for single and batch editing.
Added synthetic regression fixtures for failure isolation and output preservation.

Added dry-run before/after metadata plans with explicit set, remove, and unchanged actions.
Added JSON and CSV batch manifests, reusable JSON templates, and recursive CBZ directory discovery.
Added per-job success and failure reports, source and output fingerprints, field-level change evidence, and transactional write status.
Preserved source archives and validated temporary outputs before atomic placement.

Added focused ComicInfo.xml field updates and removals.
Added source-preserving CBZ output with archive-path and size limits.
Added post-write XML, archive, and unchanged-member verification.

Read the complete changelog

Quick start

The shortest documented path into the current release.

Before running these source commands, download the v1.2.0 source archive, extract it, and open a terminal in the extracted project folder containing README.md. Follow the tagged README for required runtimes and any platform-specific setup.

python -m pip install .
comicinfo-edit issue.cbz examples/metadata.json --dry-run
comicinfo-edit issue.cbz examples/metadata.json --output issue-metadata.cbz
comicinfo-edit --batch examples/batch.csv --template examples/metadata.json --dry-run
comicinfo-edit --source-dir comics --output-dir updated --template examples/metadata.json --recursive

CSV batches require source and output columns and may include any supported ComicInfo field. Empty cells inherit the template or make no per-row change; __REMOVE__ explicitly removes a field. JSON batches contain a jobs array with source, optional output for dry runs, and a patch object.

Current limitations

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

Only ZIP-based CBZ archives are supported. The tool does not edit CBR or CB7, fetch metadata, modify images, normalize the full ComicInfo schema, infer issue numbers from filenames, overwrite sources or outputs, or make a multi-archive batch globally atomic. Keep backups of valuable archives. Python 3.10 or newer is required.

Part of the Logan Pendragon Forge open-source collection. Licensed under the MIT License.

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

ComicInfo Editor Lite is published under MIT. The current cataloged release is v1.2.0, published 2026-10-16.

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