Forge Miniv1.0.0Feature Complete

File Extension Truth Checker

Compare filename extensions with recognizable file signatures and propose collision-aware corrections without renaming anything.

Current release v1.0.0 View source

v1.0.0Current release

MITSource license

3Supported platform groups

Files & ArchivesCatalog category

The problem it solves

File Extension Truth Checker File Extension Truth Checker compares a filename's extension with recognizable bytes inside the file. It reports matches, mismatches, unknown signatures, safe proposed names, and destination collisions without renaming or uploading anything.

Who File Extension Truth Checker is for

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

Intended result

Compare filename extensions with recognizable file signatures and propose collision-aware corrections without renaming anything.

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

Features in v1.0.0

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

File Extension Truth Checker compares a filename's extension with recognizable bytes inside the file. It reports matches, mismatches, unknown signatures, safe proposed names, and destination collisions without renaming or uploading anything.

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

Quick start

The shortest documented path into the current release.

extension-truth suspicious-download.bin
extension-truth "C:\Downloads" --recursive
extension-truth collection --format csv --output extension-review.csv --fail-on-mismatch

The command is read-only. Exit code 1 is available for automation when a recognized mismatch exists; unknown signatures are reported without guesses.

Current limitations

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

Files stay local. Only a short header and, for ZIP-family containers, the internal directory and identifying entries are read.
A matching extension does not prove that a file is safe, complete, authentic, or free of malicious content.
Shared container signatures can be ambiguous. The tool uses conservative families and accepted extension aliases.
Proposed names are review suggestions. This project deliberately performs no renames; pair reviewed results with a safe rename tool if needed.

Privacy and licensing

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

Privacy and safety

Files stay local. Only a short header and, for ZIP-family containers, the internal directory and identifying entries are read.
A matching extension does not prove that a file is safe, complete, authentic, or free of malicious content.
Shared container signatures can be ambiguous. The tool uses conservative families and accepted extension aliases.
Proposed names are review suggestions. This project deliberately performs no renames; pair reviewed results with a safe rename tool if needed.

License and release

File Extension Truth Checker is published under MIT. The current cataloged release is v1.0.0, published 2026-07-19.

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