Setup¶
Aletheia is a reasonably simple program that stands on top of a few well-known software packages out there. In order to use it, you’ll need to install the requirements first, and then install Aletheia with the Python package manager.
Requirements¶
System Dependencies¶
Aletheia requires libmagic, which comes standard with most Linux & BSD
systems, but may need to be installed on your system if you’re running OSX or
Windows. For OSX, you can install this with Homebrew with
brew install libmagic, but I’m not sure what happens with Windows.
In addition to libmagic, Aletheia needs to have the ability to talk to two external programs:
Installing both of these is easy on any platform though, even Windows ;-)
The download & installation instructions for your operating system of choice
can be found on their respective project pages. Once that’s finished, and you
can successfully execute ffmpeg and exiftool on the command line,
you’re ready to install Aletheia.
Python¶
Aletheia was written for modern versions of Python, so you’ll need Python 3.5 or higher to get things running. If you’re stuck using a system without a modern version available, the pyenv project provides a handy means of getting modern python on any system that can run Bash.
Installation¶
As Aletheia is just a Python package, installing it is easy with pip:
$ pip install aletheia
This will download the package and install it for you. Along with the Python
library (so you can import aletheia), you also get the command line
program, which you can call like this:
$ aletheia generate
$ aletheia sign /path/to/file.jpg example.com
$ aletheia verify /path/to/file.jpg
See The Command Line API for more information about how to use Aletheia on the command line, and the The Python API for how to use it in your own scripts.