Skip to content

Releases: fdenis75/VideoHash

Initial release

23 Feb 21:29

Choose a tag to compare

VideoHash v0.1.0

Initial public release of VideoHash, a Swift package for generating video fingerprints on macOS.

Highlights

  • Added VideoHashGenerator API to generate both:
    • PHash (perceptual hash for near-duplicate detection)
    • OSHash (OpenSubtitles hash for exact file identity)
  • Added videohashes-compatible PHash mode (ffmpeg-based preprocessing) for parity with peolic/videohashes (https://github.com/peolic/videohashes)
  • Added unit tests for OSHash behavior and PHash median/hex formatting behavior
  • Added GitHub publication essentials:
    • CI workflow (build + test)
    • CONTRIBUTING.md
    • SECURITY.md
    • LICENSE (MIT)
    • CHANGELOG.md

Requirements

  • macOS 26.0+
  • Swift 6.2+
  • Xcode 17+
  • ffmpeg available on PATH (or set HashConfiguration.ffmpegPath)

Install (SwiftPM)

.package(url: "https://github.com/fdenis75/VideoHash.git", from: "0.1.0")

Notes

  • Default PHash path is compatibility-focused (useFFmpegFrameExtraction = true)
  • PHash output is lowercase hexadecimal (non-zero-padded)

Validation

  • swift build ✅
  • swift test ✅