Attachments

Fuglu has advanced attachment handling capabilities, depending on installed Python libraries. The following dependencies are highly recommended:

magic

pyton-magic supports detection of MIME types. Alternatively python-file can be used.

psutil

Optional dependency, will try to determine the maximum available memory that can be used to extract archives. This will prevent OOM errors on large archives.

rarfile

Required for analyzing rar archives. The Python library alone will allow access to rar metadata. To extract files from rar archives the command line unrar utility is requirered. For best results install unrar-nonfree. If you prefer an entirely free system, use unrar-free or bsdtar, however they will fail on many rar archives.

py7zr

Required for analyzing and extracting 7zip archives. Alternatively py7zlib can be used, but it’s less stable.

pypdf

Required for analyzing and extracting pdf files. Attached pdf files are handled like archives. Images, text parts, attachments are handled like files in an archive file. Additionally, URI links and e-mail addresses can be extracted from metadata and text parts. Be careful not to confuse it with PyPDF/PyPDF2. Alternatively mupdf/fitz can be used, but it’s less stable.

ssdeep

Required for generating fuzzy hash representations of attached files.

imagehash and numpy

Required for generating various types of fuzzy hash representations of attached image files. Imagehash will also require PIL. Numpy will also require cv2.