Imagemeta

Image Metadata (Exif and XMP) extraction for JPEG, HEIC, AVIF, TIFF, and Camera Raw in golang. Imagetype identifcation. Zero allocation Perceptual Image Hash. Goal is features that are precise and performance oriented for working with images.

Documentation

See Documentation for more information.

Example Usage

Example usage:

    package main

    import (
        "fmt"
        "os"

        "github.com/evanoberholster/imagemeta"
    )

    f, err := os.Open("image.jpg")
    if err != nil {
        panic(err)
    }
    defer f.Close()

    e, err := imagemeta.Decode(f)
    if err != nil {
        panic(err)
    }
    fmt.Println(e)

Imagehash

Zero allocation PerceptualHash algorithm (64Bit and 256Bit) github.com/evanoberholster/imagemeta/imagehash. Adapted from https://github.com/corona10/goimagehash. Image will need to be resized to 64x64 prior to image hashing.

Contributing

Issues, Suggestions and Pull Requests are welcome.

Benchmarks

See BENCHMARK.md To run your own benchmarks see bench_test.go

Imagetype Identification

Images can be identified with: "github.com/evanoberholster/imagemeta/imagetype" package.

TODO

[x] Stabilize ImageTypes API
[x] Add Exif parsing for individual image types (jpg, heic, cr2, tiff, dng)
[x] Add CR3 and Heic image metadata support.
[x] Add Avif image metadata support
[ ] Add Canon Exif Makernote support
[ ] Add Nikon Exif Makernote support
[ ] Add Camera Make and Model Lookup tables
[ ] Add Preview Image extraction
[ ] Refactor XMP parsing as "xmp" package
[ ] Stabalize Imagemeta API
[ ] Improve test coverage
[ ] Add Webp image metadata support
[ ] Add CRW image metadata support (ciff format images)
[ ] Documentation

Based on and Inspired by

Inspired by Phil Harvey http://exiftool.org, go-exif https://github.com/dsoprea/go-exif, and RW Carlsen https://github.com/rwcarlsen/goexif

Special Thanks to:

The go4 Authors (https://github.com/go4org/go4) for their work on a BMFF parser and HEIF structure in golang.
Laurent Clévy (@Lorenzo2472) (https://github.com/lclevy/canon_cr3) for Canon CR3 structure.
Lasse Heikkilä (https://trepo.tuni.fi/bitstream/handle/123456789/24147/heikkila.pdf) for HEIF structure from his thesis.
Imagehash authors (https://github.com/corona10/goimagehash)

Contributors

Anders Brander abrander
Dobrosław Żybort matrixik

evanoberholster / imagemeta

readme