MetaStalk

About

MetaStalk is a tool that can be used to generate graphs from the metadata of JPEG, TIFF, and HEIC images, which are tested. More formats are supported but untested. It currently creates graphs for:

• GPS coordinates (map)
• Focal Length, Camera model, Camera manufacturer, Producer information (Pie Chart)
• Timestamp information (Chart)

Examples photos from ianare/exif-samples, exiftool, drewmpales/metadata-extractor-images.

All development is done on GitLab and mirrored to GitHub. Please read contributing.md for development.

Python 3.6 and up.

How to use

MetaStalk is available as a package on pypi.org or you can do a source install.

usage: MetaStalk [-h] [-a] [-d] [-e {pdf,svg,webp,jpeg,png,html,html_offline}]
                 [--no-open] [-o OUTPUT] [-t] [-v]
                 [files [files ...]]

Tool to graph image metadata.

positional arguments:
  files                 Path of photos to check.

optional arguments:
  -h, --help            show this help message and exit

  -a, --alphabetic      Sorts charts in alphabetical order rather than the
                        default order

  -d, --debug           Sets logging level to DEBUG.

  -e, --export {pdf,svg,webp,jpeg,png,html,html_offline}
                        Exports the graphs rather than all on one webpage

  --no-open             Will only start the server and not open the browser to
                        view it

  -o OUTPUT, --output OUTPUT
                        The name of the directory to output exports to. Will
                        be created if it does not exist. Defaults to
                        metastalk_exports.

  -t, --test            Does not show the graphs at the end.

  -v, --verbose         Sets logging level to INFO

Extras

MetaStalk has extra installs available for an increased feature set.

• metastalk[image] Allows for exporting charts to images in png, jpeg, webp, svg and pdf formats.

  • Orca is required.

• metastalk[heic] Allows for parse of heic images. Linux or Mac is requirement because Metastalk uses pyheif and thus libheif.

• metastalk[full] Combination of [image] and [heic]. Requires Linux or Mac and needs orca installed.

PyPi Install

pip install metastalk
metastalk <Path to files>
#i.e. metastalk ./ExamplePhotos/

Source Install

git clone https://gitlab.com/Cyb3r-Jak3/metastalk
cd metastalk
setup.py install
metastalk <Path to files>
#i.e. metastalk ./ExamplePhotos/

Disclaimer

This is for educational/proof of concept purposes only. What you do with MetaStalk is your responsibility.