The Python package for near duplicate video detection
⭐️ Introduction
Videohash is a Python library for detecting near-duplicate videos (Perceptual Video Hashing). Any video input can be used to build a 64-bit equivalent hash value with this package. The hash-values for identical/near-duplicate videos are the same or similar, implying that if the video is enlarged (upscaled/downscaled), transcoded, slightly cropped, or black-bars added/removed, the hash-value should remain unchanged or not vary substantially.
How the hash values are calculated.
- Every one second, a frame from the input video is extracted, the frames are shrunk to a 144x144 pixel square, a collage is constructed that contains all of the resized frames(square-shaped), the collage's wavelet hash is the video hash value for the original input video.
When not to use Videohash.
- Videohash cannot be used to verify whether one video is a part of another (video fingerprinting). If the video is reversed or rotated by a substantial angle (greater than 10 degrees), Videohash will not provide the same or similar hash result, but you can always reverse the video manually and generate the hash value for reversed video.
How to compare the video hash values stored in a database.
🏗 Installation
To use this software, you must have FFmpeg installed. Please read
how to install FFmpeg if you don't already know how.
Install videohash
- Using pip:
pip install videohash
- Install directly from GitHub:
pip install git+https://github.com/akamhy/videohash.git
🌱 Features
- Generate videohash of a video directly from its URL or its path.
- Can be used to implement scalable Near Duplicate Video Retrieval.
- The end-user can access the image representation(the collage) of the video.
- A videohash instance can be compared to a 64-bit stored hash, its hex representation, bitlist, and other videohash instances.
- Faster than the old method of comparing each frame individually. The videohash package generates a single 64-bit video hash value, which saves a significant amount of database space. And the number of comparisons required drops dramatically.
🚀 Usage
In the following usage example the first three instances of VideoHash class are computing the hash for the same video and the last one is a different video.
- videohash1 is the video at https://www.youtube.com/watch?v=PapBjpzRhnA.
- videohash2 is downscaled copy of https://www.youtube.com/watch?v=PapBjpzRhnA contained in Matroska Multimedia Container.
- videohash3 is the same video as videohash2 but on local storage.
- videohash4 uses a completely different video at https://www.youtube.com/watch?v=_T8cn2J13-4.
>>> from videohash import VideoHash
>>> # video: Artemis I Hot Fire Test
>>> videohash1 = VideoHash(url="https://www.youtube.com/watch?v=PapBjpzRhnA", download_worst=False)
>>>
>>> videohash1.hash # video hash value of the file, value is same as str(videohash1)
'0b0011010000011111111011111111111110001111011110000000000000000000'
>>>
>>> #VIDEO:Artemis I Hot Fire Test
>>> url2="https://raw.githubusercontent.com/akamhy/videohash/main/assets/rocket.mkv"
>>> videohash2 = VideoHash(url=url2)
>>> videohash2.hash
'0b0011010000011111111011111111111110001111011110000000000000000000'
>>> videohash2.hash_hex
'0x341fefff8f780000'
>>> videohash2.hash_hex
'0x341fefff8f780000'
>>> videohash1 - videohash2
0
>>> videohash1 == videohash2
True
>>> videohash1 == "0b0011010000011111111011111111111110001111011110000000000000000000"
True
>>> videohash1 != videohash2
False
>>> path3 = "/home/akamhy/Downloads/rocket.mkv" #VIDEO: Artemis I Hot Fire Test
>>> videohash3 = VideoHash(path=path3)
>>> videohash3.hash
'0b0011010000011111111011111111111110001111011110000000000000000000'
>>> videohash3 - videohash2
0
>>> videohash3 == videohash1
True
>>> url4 = "https://www.youtube.com/watch?v=_T8cn2J13-4" #VIDEO: How We Are Going to the Moon
>>> videohash4 = VideoHash(url=url4)
>>> videohash4.hash_hex
'0x7cffff000000eff0'
>>> videohash4 - "0x7cffff000000eff0"
0
>>> videohash4.hash
'0b0111110011111111111111110000000000000000000000001110111111110000'
>>> videohash4 - videohash2
34
>>> videohash4 != videohash2
True
Run the above code @ https://replit.com/@akamhy/videohash-usage-2xx-example-code-for-video-hashing#main.py
Extended Usage : https://github.com/akamhy/videohash/wiki/Extended-Usage
API Reference : https://github.com/akamhy/videohash/wiki/API-Reference
🛡 License
Released under the MIT License. See license for details.
The VideoHash logo was created by iconolocode. See license for details.
Videos are from NASA and are in the public domain.
NASA videos are in the public domain. NASA copyright policy states that "NASA material is not protected by copyright unless noted".
Metadata
Release files for videohash 2.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| videohash-2.1.1.tar.gz | 18.8 kB | Without provenance | Details for videohash-2.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| videohash-2.1.1-py3-none-any.whl | Python 3 | none | any | Details for videohash-2.1.1-py3-none-any.whl |
Total release size: 37.8 kB
Release files / videohash-2.1.1.tar.gz
| Download URL | videohash-2.1.1.tar.gz |
|---|---|
| Size | 18.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
41f87f3c294789b374e0bcaae4e541c24b7662dab2c589b92ba3956158be4335
|
|
BLAKE2b-256 checksum How to use checksums |
963b18b53e9934c9ffe5b2dd4095e75eb48ae1e9be6d9810ee32051fc8765b2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7
|
Release files / videohash-2.1.1-py3-none-any.whl
| Download URL | videohash-2.1.1-py3-none-any.whl |
|---|---|
| Size | 19.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
14a4a7d18c8bef90ad15ddae5b68a9a265dc2dfd214c6e6d4da1adb686ebcf56
|
|
BLAKE2b-256 checksum How to use checksums |
688e836994b046eeadea6624cef4f1dd339d82c3e7885eb6a76c7ffcdfc5fefc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7
|
Security for videohash 2.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.