iLEAPP CLI is a command-line tool designed to parse iOS logs, events, and plist files, providing detailed forensic analysis of device data. It supports iOS/iPadOS versions 11 through 17 and can process compressed .tar/.zip files, decompressed directories, or iTunes/Finder backups.
Key Features:
Parses Mobile Installation Logs, iOS 12+ notifications, build info (iOS version, etc.), wireless cellular service details, screen icons by grid order, application state data for app bundle ID correlation, and user/device connection history.
Supports parsing directly from compressed files or decompressed directories, including iTunes/Finder backups.
Available in both CLI and GUI versions for flexible workflow preferences.
Extensible with artifact plugins that can be added to enhance functionality.
Audience & Benefit:
Ideal for forensic investigators, incident responders, and researchers who need to extract detailed information from iOS devices. iLEAPP CLI provides a powerful toolset for analyzing device data without requiring jailbreaking, enabling efficient extraction of critical forensic evidence in both criminal and civil investigations.
README
iOS Logs, Events, And Plists Parser
iLEAPP parses iOS and iPadOS forensic extractions and produces HTML, TSV, timeline, KML, and LAVA output. It supports iOS/iPadOS 11 through current versions.
Browse the full searchable artifact list at leapps.org/artifacts (filter by LEAPP tool).
Quick Start (Recommended)
Download a pre-built release — no Python installation required.
iTunes/Finder backup folder with hashed paths and names
file
Single file input
Encrypted iTunes/Finder backups (-t itunes) are supported. The GUI will prompt for a password before processing when encryption is detected. On the CLI, pass the password with --itunes_password (see Optional parsing options below).
CLI Arguments
These options apply only to the CLI build (ileapp / ileapp.exe / python ileapp.py). The GUI (ileappGUI) exposes the same settings through its interface instead of command-line flags.
Run ileapp --help (or python ileapp.py --help from source) for the built-in reference.
Parsing a case
These three arguments are required for a normal parse run:
Argument
Long form
Description
-t
Input type: fs, tar, zip, gz, itunes, or file
-i
--input_path
Path to the input file or folder
-o
--output_path
Path to the output folder (must already exist)
Example:
ileapp -t zip -i /path/to/extraction.zip -o /path/to/output/
Optional parsing options
Argument
Long form
Description
-w
--wrap_text
Pass this flag to disable text wrapping in output files
-m
--load_profile
Path to an iLEAPP profile file (.ilprofile) to limit which modules run
-d
--load_case_data
Path to a LEAPP case data file (.lcasedata)
--custom_output_folder
Custom name for the report output subfolder
--custom_artifacts_path
Extra folder to load artifact modules from (e.g. scripts/alternate_artifacts)
--itunes_password
Standalone utility modes
These modes do not parse a case. Use them alone — without -t, -i, or -o:
Argument
Long form
Description
-p
--artifact_paths
Write all artifact search paths to path_list.txt in the current directory
-c
--create_profile_casedata
Interactive wizard to create a .ilprofile or .lcasedata file in the given folder
Examples:
ileapp -p
ileapp -c /path/to/output/folder/
Contributing
Artifact modules live in scripts/artifacts/ and are loaded dynamically at runtime.