Installation¶
General¶
This is a python 3.8 project.
In general, you can just clone or download the whole repository (https://github.com/kieranjol/IFIscripts) and run the scripts from your cloned path. In the Irish Film Institute, on linux, OSX and Windows, we create a folder in the home directory called ifigit
, then we run git clone https://github.com/kieranjol/ifiscripts
. Then we add the ifiscripts
folder to $PATH
which allows us to access the scripts from any directory, not just ifigit/ifiscripts
. We will be moving to using pip
and setup.py
for installs and updates in the future.
However some folks just cd
into the cloned repository and run the scripts from there, for example to run makeffv1.py
you might run:
python makeffv1.py path/to.filename.mov
.
External dependencies are listed below, but lxml
is the main python library that must be installed for most scripts.
pip install lxml
should work fine.
External Dependencies¶
There are some external subprocess
dependencies for most of the scripts. The most frequently used ones are:
- ffmpeg
- ffprobe
- mediainfo
but the following are also needed for many scripts:
- mkvpropedit (installed via mkvtoolnix)
- siegfried aka sf
- exiftool
- git
- clairmeta (this requires other dependencies - https://github.com/Ymagis/ClairMeta)
- qcli
- openssl
- rsync
- gcp (installed via gnu-coreutils on OSX)
- rawcooked
- 7zip aka 7za aka p7zip-full
- md5deep
- mediaconch
Specific Instructions - Windows¶
- install 64-bit git-bash using all the default settings https://git-scm.com/downloads - make sure it’s the 64-bit version!
- install 64-bit python3, making sure to tick the option to ADD TO PATH https://www.python.org/downloads/
- open cmd and
mkdir ifiscripts
andgit clone https://github.com/kieranjol/ifiscripts
- add this ifiscripts path (eg
C:\Users\KAZETCCCC\ifigit\ifiscripts
)to the environmental path, following these steps: https://www.computerhope.com/issues/ch000549.htm - ffmpeg the default option works well - 64-bit static https://ffmpeg.zeranoe.com/builds/ and place in scripts folder * OR install media-autobuild-suite but extract to the C:mas folder due to long path issues
- mediainfo - get the 64-bit CLI version https://mediaarea.net/en/MediaInfo/Download/Windows
- install lxml with
pip install lxml
- install siegfried exe (https://www.itforarchivists.com/siegfried/)file to the ifiscripts folder and run
sf -update
in cmd - download exiftoolinstaller and select the ‘latest build’ option - make sure that the option to add to path is ticked - https://oliverbetz.de/pages/Artikel/ExifTool-for-Windows
- install notepad++ - https://notepad-plus-plus.org/downloads/
- install libreoffice - https://www.libreoffice.org/download/download/
Specific Instructions - Ubuntu¶
A lot of these can be installed on Ubuntu with a single line:
sudo apt update && sudo apt install python3-pip ffmpeg mkvtoolnix exiftool git md5deep p7zip-full
In order to add the rest, refer to the installation instructions of the relevant tools. For mediaarea tools, it can be easiest to use their own snapshot repository:
wget https://mediaarea.net/repo/deb/repo-mediaarea-snapshots_1.0-13_all.deb && sudo dpkg -i repo-mediaarea-snapshots_1.0-13_all.deb && sudo apt update && sudo apt install mediainfo dvrescue qcli rawcooked mediaconch
Using pip/setup.py¶
the following is currently experimental, but it should work fine:
You can get a selection of scripts by making sure that pip
installed, then running:
pip install ifiscripts
or cd
into the ifiscripts
cloned folder and run
pip install .
You may need to run the pip
commands with sudo
.
The pip installation methods have the added benefit of installing the python dependencies such as lxml
.