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
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.
There are some external
subprocess dependencies for most of the scripts. The most frequently used ones are:
but the following are also needed for many scripts:
- mkvpropedit (installed via mkvtoolnix)
- siegfried aka sf
- clairmeta (this requires other dependencies - https://github.com/Ymagis/ClairMeta)
- gcp (installed via gnu-coreutils on OSX)
- 7zip aka 7za aka p7zip-full
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
git 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 -updatein 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
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
cd into the
ifiscripts cloned folder and run
pip install .
You may need to run the
pip commands with
The pip installation methods have the added benefit of installing the python dependencies such as