ForensiScan/requirements.txt at main · Soumit-Santra/ForensiScan · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# ─────────────────────────────────────────────────────────────────
#  ForensiScan v6.0.0 — Requirements
#  Author: Sayan Pal  |  Collaborator: Soumit Santra
# ─────────────────────────────────────────────────────────────────

# Core image processing (EXIF, GPS, PIL)
Pillow

# PDF processing
PyPDF2

#  Word document processing (metadata + text extraction)
python-docx

# Audio / video tag extraction
mutagen

#  File type / MIME detection (libmagic wrapper)
# Windows:
python-magic-bin; sys_platform == 'win32'
# Linux / macOS (requires system libmagic: sudo apt install libmagic1):
python-magic; sys_platform != 'win32'

#  PE (Windows executable) analysis
pefile

# Terminal styling & progress bars
colorama
tqdm

#  Deep / fallback metadata parser
hachoir

#  YARA malware rule scanning
# Enables built-in ruleset: EICAR, UPX, PowerShell cradles,
# PHP webshells, Base64 PE, reverse shells, crypto-miners.
yara-python

#  Streaming / mmap helpers (stdlib — no install needed)
# mmap, hashlib, math, io  →  all part of Python standard library

#  GUI (stdlib — no install needed)
# tkinter  →  bundled with Python on Windows/macOS
# On Debian/Ubuntu: sudo apt install python3-tk

# ─────────────────────────────────────────────────────────────────
#  OPTIONAL — install only what you need
# ─────────────────────────────────────────────────────────────────

# Video stream metadata (requires ffprobe/ffmpeg binary in PATH)
# ffmpeg-python

# Forensic disk image support — partition listing & filesystem walk
# Linux recommended (pytsk3 build may fail on Windows)
# pytsk3
# pyewf        # E01/EWF image support (requires libewf)
# pyaff4-snappy  # AFF4 image support

# ─────────────────────────────────────────────────────────────────
#  EXTERNAL BINARY TOOLS (not pip — install separately)
# ─────────────────────────────────────────────────────────────────
#
#  ExifTool  →  https://exiftool.org   (highly recommended)
#    Windows : download exiftool.exe, place in PATH
#    Linux   : sudo apt install libimage-exiftool-perl
#    macOS   : brew install exiftool
#
#  ffprobe   →  https://ffmpeg.org    (required for video metadata)
#    Linux   : sudo apt install ffmpeg
#    macOS   : brew install ffmpeg
#    Windows : download from ffmpeg.org, add to PATH