Troubleshooting¶
Libmagic¶
Aletheia depends on libmagic, and uses the file-magic
module to access it.
Unfortunately, libmagic operates differently from environment to environment,
and sometimes it can have trouble. In cases when this presents a problem,
it’ll be documented here.
Alpine Linux¶
Alpine systems currently require a patch to play nice with Python’s
file-magic
module, so you’ll have to add the following to your
Dockerfile
:
FROM python:3-alpine ... RUN wget https://patch-diff.githubusercontent.com/raw/python/cpython/pull/10461.patch -O - \ | patch /usr/local/lib/python3.7/ctypes/util.py ENV LD_LIBRARY_PATH /usr/lib/
FFmpeg¶
A lot of Aletheia’s functions require a working installation of FFmpeg.
Thankfully, this program is Free software and is available for all major
platforms out there. Installing it should be relatively easy, but if Aletheia
is complaining about how you don’t have it installed even after you’re sure
you installed it, note that FFmpeg must be installed and available in your
system PATH
.
This means that if you type ffmpeg -version
on the command line, regardless
of what directory you’re in, you should see something like this:
built with gcc 8.1.1 (GCC) 20180531
configuration: --prefix=/usr --disable-debug --disable-static --disable-stripping --enable-avresample --enable-fontconfig --enable-gmp --enable-gnutls --enable-gpl --enable-ladspa --enable-libaom --enable-libass --enable-libbluray --enable-libdrm --enable-libfreetype --enable-libfribidi --enable-libgsm --enable-libiec61883 --enable-libmodplug --enable-libmp3lame --enable-libopencore_amrnb --enable-libopencore_amrwb --enable-libopenjpeg --enable-libopus --enable-libpulse --enable-libsoxr --enable-libspeex --enable-libssh --enable-libtheora --enable-libv4l2 --enable-libvidstab --enable-libvorbis --enable-libvpx --enable-libwebp --enable-libx264 --enable-libx265 --enable-libxcb --enable-libxml2 --enable-libxvid --enable-nvenc --enable-omx --enable-shared --enable-version3
libavutil 56. 14.100 / 56. 14.100
libavcodec 58. 18.100 / 58. 18.100
libavformat 58. 12.100 / 58. 12.100
libavdevice 58. 3.100 / 58. 3.100
libavfilter 7. 16.100 / 7. 16.100
libavresample 4. 0. 0 / 4. 0. 0
libswscale 5. 1.100 / 5. 1.100
libswresample 3. 1.100 / 3. 1.100
libpostproc 55. 1.100 / 55. 1.100
If you see command not found
or Bad command or file name
, then either
FFmpeg isn’t installed, or it’s not in your PATH
. You’ll have to talk to
someone who knows more about your operating system to figure out how to get
that to work.