goimagehash/README.md

goimagehash

Inspired by imagehash

A image hashing library written in Go. ImageHash supports:

• Average hashing
• Difference hashing
• Perception hashing
• Wavelet hashing [TODO]

Installation

go get github.com/corona10/goimagehash

Special thanks to

• Haeun Kim

Usage

func main() {
        file1, _ := os.Open("sample1.jpg")
        file2, _ := os.Open("sample2.jpg")
        defer file1.Close()
        defer file2.Close()

        img1, _ := jpeg.Decode(file1)
        img2, _ := jpeg.Decode(file2)
        hash1, _ := goimagehash.AverageHash(img1)
        hash2, _ := goimagehash.AverageHash(img2)
        distance, _ := hash1.Distance(hash2)
        fmt.Printf("Distance between images: %v\n", distance)

        hash1, _ = goimagehash.DifferenceHash(img1)
        hash2, _ = goimagehash.DifferenceHash(img2)
        distance, _ = hash1.Distance(hash2)
        fmt.Printf("Distance between images: %v\n", distance)
}

Release Note

v0.4.0(TBA)

• IMPORTANT goimagehash does not have compatible with the before version when it comes to the serialization based on string. bit set order is changed.

v0.3.0

• Support DifferenceHashExtend.
• Support AverageHashExtend.
• Support PerceptionHashExtend by @TokyoWolFrog.

v0.2.0

• Perception Hash is updated.
• Fix a critical bug of finding median value.

v0.1.0

• Support Average hashing
• Support Difference hashing
• Support Perception hashing
• Use bits.OnesCount64 for computing Hamming distance by @dominikh
• Support hex serialization methods to ImageHash by @brunoro