Comic Gap Finder
Find likely missing issue numbers and anomalies from local comic filenames. Per-series expected integer ranges and intentional omissions with reasons; decimal, annual, duplicate and ambiguous filename evidence remains visible.
The problem it solves
Comic Gap Finder Comic Gap Finder scans local comic filenames for likely issue numbers, groups conservative series-name matches, and reports missing integers, duplicate numbers, decimal issues, and filenames too ambiguous to classify safely. It does not require an account or an external metadata service.
Who Comic Gap Finder is for
- Collectors and readers who need a conservative way to organize or inspect their own files.
- Users working with comics, collections, missing issues who want the documented v1.1.1 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Find likely missing issue numbers and anomalies from local comic filenames. Per-series expected integer ranges and intentional omissions with reasons; decimal, annual, duplicate and ambiguous filename evidence remains visible.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.1.1
Capabilities below come from the current project README and release documentation.
Comic Gap Finder scans local comic filenames for likely issue numbers, groups conservative series-name matches, and reports missing integers, duplicate numbers, decimal issues, and filenames too ambiguous to classify safely. It does not require an account or an external metadata service.
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
Changelog
Release notes from the canonical v1.1.1 source tag.
- Correct release wording and the original publication date; update installation references. Feature behavior is unchanged.
- Add per-series expected ranges and reasoned intentional omissions with bounded validation.
- Detect likely missing and duplicate issue numbers from local comic filenames.
- Prefer explicit issue markers and quarantine ambiguous fallback matches.
- Export Markdown and JSON with expected-range and recursive-scan options.
Quick start
The shortest documented path into the current release.
Before running these source commands, download the v1.1.1 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.
python -m pip install "comic-gap-finder @ https://github.com/loganpendragonmultiverse/comic-gap-finder/releases/download/v1.1.1/comic_gap_finder-1.1.1-py3-none-any.whl" comic-gap-finder "D:\Comics\Night Watch" --markdown gaps.md --json gaps.json comic-gap-finder "D:\Comics\Night Watch" --expected-start 1 --expected-end 50 --fail-on-gaps
Recognized containers are CBZ, CBR, CB7, PDF, ZIP, RAR, and 7Z. Explicit markers such as “#12” and “Issue 12” are preferred. A filename without a marker is accepted only when one non-year, non-volume number remains.
Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
The current v1.1.1 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
This is a filename audit, not a completeness authority. Annuals, specials, skipped numbers, legacy numbering, reboots, decimal issues, variants, and deliberately absent issues require human review. The tool never opens archives, renames files, or looks up publication data.
Processing is read-only and local. Reports can reveal collection filenames, so review them before sharing.
License and release
Comic Gap Finder is published under MIT. The current cataloged release is v1.1.1, published 2026-10-16.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Comic Gap Finder v1.1.1
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: bf409402a87ac2d9.