CBZ Page Auditor
Audit CBZ, CB7 and CBR comic archives for integrity and page-quality issues without modifying them, with version-bound resume checkpoints.
The problem it solves
CBZ Page Auditor CBZ Page Auditor inspects ZIP/CBZ, 7Z/CB7, and RAR/CBR comic archives without rewriting them. It catches damaged images, duplicate pages, suspicious numbering, unusual dimensions, nearly blank pages, and likely double-page spreads before they become library surprises.
Who CBZ Page Auditor is for
- Collectors and readers who need a conservative way to organize or inspect their own files.
- Users working with comics, CBZ, CB7 who want the documented v1.3.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Audit CBZ, CB7 and CBR comic archives for integrity and page-quality issues without modifying them, with version-bound resume checkpoints.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.3.0
Capabilities below come from the current project README and release documentation.
ZIP/CBZ, 7Z/CB7, and RAR/CBR integrity with conservative archive safety limits
Decodability of every supported page image
Exact duplicate page data
Possible gaps in numeric page filenames
Small pages and substantial dimension outliers
Nearly black or white pages
Verified examples
Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.
Verified release evidence
This project does not currently publish a screenshot or dedicated example folder. The current README, tests, changelog, tagged release, and source repository remain the verified examples of its behavior.
Platforms and implementation
The public release claims only the cataloged platforms and technologies.
Supported platforms
- Windows
- macOS
- Linux
Built with
- Python
- Pillow
- py7zr
- rarfile
Changelog
Release notes from the canonical v1.3.0 source tag.
- Bound resume checkpoints to the engine, decoder versions, schema and audit limits.
- Re-audit stale or malformed records and detect archive changes before advancing state.
- Added configurable CLI audit limits and checkpoint regression fixtures.
- Apply the same effective audit limits when rendering HTML thumbnail previews.
- Repair formatting and add local finding contact sheets, decoder diagnostics and resumable per-archive checkpoints.
- Added regression coverage for the audited behavior and invalid inputs.
- Added read-only 7Z/CB7 auditing with automatically deleted temporary extraction.
- Added RAR/CBR auditing through an installed UnRAR, 7-Zip,
unar, orbsdtarbackend. - Expanded directory scans, package metadata, safety checks, tests, and documentation for all six accepted extensions.
- Added read-only CBZ integrity and image decoding audits.
- Added exact duplicate, numbering-gap, dimension, blank-page, and possible-spread findings.
- Added batch terminal, JSON, and static HTML reports.
- Added archive entry and uncompressed-size safety limits.
Quick start
The shortest documented path into the current release.
Before running these source commands, download the v1.3.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 3.10 or newer is required. ZIP/CBZ and 7Z/CB7 work from the installed Python dependencies. RAR/CBR additionally requires one compatible local backend on PATH: UnRAR, 7-Zip, unar, or bsdtar.
python -m venv .venv
python -m pip install -e .Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
- RAR/CBR decompression depends on an installed local backend because Python's RAR reader does not ship the proprietary decompressor.
- Duplicate detection is byte-exact; visually identical recompressed pages will not match.
- Blank-page and spread detection are useful review hints, not editorial conclusions.
- Filename gap detection works best with simple numeric page names.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
Archives remain local and are opened read-only. The auditor does not contact metadata services or permanently retain extracted images. 7Z members are decoded inside an automatically deleted temporary directory; ZIP and RAR members are read through their archive libraries. Entry count and total uncompressed-size limits reduce exposure to archive bombs, but untrusted archives should still be handled cautiously.
License and release
CBZ Page Auditor is published under MIT. The current cataloged release is v1.3.0, published 2026-10-16.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
CBZ Page Auditor v1.3.0
Use the tagged release for downloads and release notes. Use the repository for source, issues, contribution guidance, security reporting, and complete documentation.
Page source: current Forge catalog plus README and CHANGELOG from the canonical GitHub release tag. Fingerprint: 4b0b0b2487dde43b.