Forge Miniv1.1.0Feature Complete

Archive Contents Indexer

Index ZIP, CBZ, and EPUB contents with SHA-256 fingerprints, compression evidence, duplicates, extensions, and largest entries.

Current release v1.1.0 View source

v1.1.0Current release

MITSource license

4Supported platform groups

Files & ArchivesCatalog category

The problem it solves

Archive Contents Indexer [](https://github.com/loganpendragonmultiverse/archive-contents-indexer/actions/workflows/ci.yml)

Who Archive Contents Indexer is for

People who need a small, purpose-built utility instead of a broad platform.
Users working with archives, ZIP, CBZ who want the documented v1.1.0 behavior.
People who prefer an open-source release with visible limitations, source, and license terms.

Intended result

Index ZIP, CBZ, and EPUB contents with SHA-256 fingerprints, compression evidence, duplicates, extensions, and largest entries.

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/archive-contents-indexer/actions/workflows/ci.yml)

Archive Contents Indexer creates a searchable static HTML or JSON inventory of ZIP, CBZ, and EPUB contents without permanently extracting files. Reports include member paths, sizes, compressed sizes, CRC values, encryption flags, and unsafe path warnings.

Verified examples

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

examples/README.mdVerified 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
Web

Built with

Python
HTML

Quick start

The shortest documented path into the current release.

python -m pip install .
archive-index ~/Books --output archive-index.html
archive-index example.cbz --format json

Directory scans continue past corrupt archives and report each error. Version 1.1 adds archive SHA-256 fingerprints, per-member compression ratios, duplicate-member warnings, extension totals, and the ten largest entries. HTML output is self-contained, searchable, responsive, and escapes archive-supplied filenames. Existing reports are never replaced.

Current limitations

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

The tool reads archive metadata with Python's ZIP parser and does not extract members. It flags absolute, drive-prefixed, and parent-traversal names, but it is an indexer rather than a malware scanner or full archive verifier. Do not treat a successful index as proof that contents are safe to open.

Requires Python 3.10 or newer. Development checks use Ruff, pytest with branch coverage, and package builds.

Part of the Logan Pendragon Forge open-source collection. Licensed under the [MIT License](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

Archive Contents Indexer 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