Metadata-Version: 2.2
Name: exifool
Version: 0.1.8
Summary: Metadata retrieval tool
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1.8
Requires-Dist: pypdf>=5.2.0
Requires-Dist: rich>=13.9.4

# Exifool

![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fsapph2c%2Fexifool%2Fmain%2Fpyproject.toml&style=for-the-badge&logo=python&logoSize=auto)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/sapph2c/exifool/ci.yml?style=for-the-badge&logo=github&logoSize=auto)
![GitHub deployments](https://img.shields.io/github/deployments/sapph2c/exifool/pypi?style=for-the-badge&logo=pypi&logoColor=white&logoSize=auto)

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

Currently supported file formats include:

- `pdf`

## Install

Exifool is available as a python package on PyPi:

```
pip install exifool
```

## Usage

CLI options:

```
exifool --help

Usage: exifool [OPTIONS]

  ___________      .__  _____             .__
  \_   _____/__  __|__|/ ____\____   ____ |  |
  |     __)_\  \/  /  \   __\/  _ \ /  _ \|  |
  |         \>    <|  ||  | (  <_> |  <_> )  |__
  /_______  /__/\_ \__||__|  \____/ \____/|____/
          \/      \/

  Written with ❤️ by sapph2c

  Metadata analysis tool written for CSEC-473

Options:
  --path TEXT  Path to the file to perform metadata analysis on.
  --help       Show this message and exit.

```

Retrieving metadata from a pdf:

```bash
exifool --path example.pdf
```

Sample output:

```bash
{
    '/Author': '',
    '/CreationDate': 'D:20250205020514Z',
    '/Creator': 'LaTeX with hyperref',
    '/Keywords': '',
    '/ModDate': 'D:20250205020514Z',
    '/PTEX.Fullbanner': 'This is pdfTeX, Version 3.141592653-2.6-1.40.25 (TeX Live 2023) kpathsea version 6.3.5',
    '/Producer': 'pdfTeX-1.40.25',
    '/Subject': '',
    '/Title': '',
    '/Trapped': '/False'
}
```
