mediasim is a CLI tool and Go library to calculate the similarity of images & videos.
You can use mediasim in two ways: as a command-line interface (CLI) tool or a Go library.
The CLI tool is a standalone application that can be used to compare the similarity between media files, while the library can be integrated into your own Go projects.
The binaries are available for Windows, macOS, and Linux. Download the latest release that matches your computer architecture and operating system.
If you want to compare two or more files, run the command below in the terminal:
$ mediasim -f <media1>,<media2> ...Where:
-f(mandatory): the path to the media files you want to compare. You must pass at least two files, separated by comma.
If you want to compare a folder with multiple files, run the command below:
$ mediasim -d <directory>Where:
-d(mandatory): the path to the directory where the media files are located.-mt(optional): the file types to be included in the comparison. You can choose betweenimage,video, orall(default).
Other parameters you can use:
-t(optional): the threshold for the similarity score; a value between 0-1, where 0 is completely different and 1 is identical. The default value is0.8, which means only files with 80% similarity or higher will be reported.-o(optional): the output format; you can choosereport(default) or, if you prefer a raw output,jsonorcsv.
For the full list of parameters, type mediasim --help in the terminal.
If the comparison of videos is not working, it may be due to the fact that you don't have FFmpeg working in your computer, which is required to extract frames from the video files.
When FFmpeg is not found, mediasim will try to automatically download and install it for you. Even though this will work in most cases, it may fail for unpredictable reasons.
The best option to make sure the video comparison is working is to install FFmpeg yourself in your computer and make sure it is available in your PATH.
Comparing videos is inherently resource-intensive because it requires analyzing multiple frames from each video to get an accurate similarity score. For instance, comparing two 15-second videos requires roughly 100 times more CPU resources than comparing two images.
Therefore, if you have many videos to compare, especially long ones, the process may take a significant amount of time, and unfortunately, there is not much that can be done to speed it up.
For a couple of years now, Apple has required developers to join their "Developer Program" to gain the pretentious status of an identified developer 😛.
Translating to non-BS language, this means that if you’re not registered with Apple (i.e., paying the fee), you can’t freely distribute macOS software. Apps from unidentified developers will display a message saying the app is damaged and can’t be opened.
To bypass this, open the Terminal and run the command below, replacing <path-to-app> with the correct path to where you’ve installed the app:
$ xattr -d com.apple.quarantine <path-to-app>In order to build this project you will need the following dependencies installed in your computer:
With all the dependencies installed, in the project's root folder run the command:
$ task build os=<operating-system> arch=<architecture>Where:
<operating-system>: can bewindows,darwin(macOS), orlinux.<architecture>: can beamd64orarm64.
For example, if I wanted to build the CLI for Windows, on architecture AMD64, I would run the command:
$ task build os=windows arch=amd64This app collects information about the data that you're comparing to help me track bugs and improve the general stability of the software.
No identifiable information about you or your computer is tracked. But if you still want to stop the telemetry, you can do that by adding the flag --no-telemetry in the CLI tool.
mediasim is released under the MIT License. See LICENSE for details.
Vinicius Egidio (vinicius.io)