Skip to content
Go Perceptual image hashing package
Go
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows Update github action to use gomodule (#39) Dec 7, 2019
_examples dct: Improve DCT1D to O(nlogn) algorithm (#29) Mar 19, 2019
etcs
transforms dct: Improve DCT1D to O(nlogn) algorithm (#29) Mar 19, 2019
.gitignore Initial commit Jul 28, 2017
AUTHORS.md add PerceptionHashExtend function (#18) Feb 8, 2019
CODEOWNERS [goimagehash] First implement. Jul 31, 2017
Gopkg.lock Update dependencies from go module and dep tool. (#36) Dec 7, 2019
Gopkg.toml Update dependencies from go module and dep tool. (#36) Dec 7, 2019
LICENSE Initial commit Jul 28, 2017
README.md README: Update Dec 6, 2019
doc.go
go.mod
go.sum Update dependencies from go module and dep tool. (#36) Dec 7, 2019
hashcompute.go dct: Improve DCT1D to O(nlogn) algorithm (#29) Mar 19, 2019
hashcompute_test.go
imagehash.go Fix typo on the GoDoc for LoadImageHash. (#35) Nov 26, 2019
imagehash18.go Use bits.OnesCount64 when available May 2, 2018
imagehash19.go Use bits.OnesCount64 when available May 2, 2018
imagehash_test.go hashcompute: Update Extend API (#28) Mar 18, 2019

README.md

GitHub Action GoDoc Go Report Card

goimagehash

Inspired by imagehash

A image hashing library written in Go. ImageHash supports:

Installation

go get github.com/corona10/goimagehash

Special thanks to

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)
        width, height := 8, 8
        hash3, _ = goimagehash.ExtAverageHash(img1, width, height)
        hash4, _ = goimagehash.ExtAverageHash(img2, width, height)
        distance, _ = hash3.Distance(hash4)
        fmt.Printf("Distance between images: %v\n", distance)
        fmt.Printf("hash3 bit size: %v\n", hash3.Bits())
        fmt.Printf("hash4 bit size: %v\n", hash4.Bits())

        var b bytes.Buffer
        foo := bufio.NewWriter(&b)
        _ = hash4.Dump(foo)
        foo.Flush()
        bar := bufio.NewReader(&b)
        hash5, _ := goimagehash.LoadExtImageHash(bar)
}

Release Note

v1.0.1

  • Perception/ExtPerception hash creation times are reduced

v1.0.0

IMPORTANT goimagehash v1.0.0 does not have compatible with the before version for future features

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
You can’t perform that action at this time.