metafind 1.0.0

Metadata analysis tool written for CSEC-473 - Penetration Testing

Metafind

Metafind is a metadata analysis tool written for CSEC-473 - Penetration Testing.

Features

• Ability to retrieve and scrub file metadata.
• Lists unique discovered metadata tags.

Install

Metafind is available as a Python package on PyPI and can be installed using uv (recommended), pipx, or pip.

Note: python 3.13+ is required

Install using uv:

uv install tool metafind@latest

Install using pipx:

pipx install metafind

Install using pip:

pip install metafind

Usage

[!IMPORTANT]
Metafind requires a metadata backend to be available within your system path.

This can be specified in the CLI via --backend, which defaults to exiftool.

For a full list of supported backends, see Supported Backends

CLI options:

> metafind --help

Usage: metafind [OPTIONS] COMMAND [ARGS]...

  Metadata analysis tool created for CSEC-473 - Penetration Testing.

  Authored by sapph2c

Options:
  --help  Show this message and exit.

Commands:
  fetch   get file(s) metadata
  scrub   scrub file(s) metadata
  unique  get unique tags from file(s)

Retrieving file metadata:

metafind fetch <path-to-file>

Scrubbing metadata: (It's recommended to make a backup of the specified file(s), as this operation is non-reversible)

metafind scrub <path-to-file>

Listing all unique metadata tags:

metafind unique <path-to-file>

Supported Backends

• Exiftool