mac_apt
Open sourceActive
mac_apt is a Python-based DFIR framework that processes macOS full disk images or live machines through per-artefact plugins. It also includes ios_apt, a launcher that applies the shared parsing code to iOS and iPadOS images, and the README states ios_apt can read a GrayKey extracted file system. Output goes to XLSX, CSV, TSV, JSONL or SQLite. It parses and exports artefacts from disk images or live Mac machines; the README describes no device unlocking or imaging features.
Facts
| Website | github.com |
|---|---|
| Vendor | Yogesh Khatri (SwiftForensics) and contributors |
| Licence | Open source (MIT) |
| Category | Artefact parsers |
| Functions | Parsing, Analysis, Reporting |
| Targets | macOS, iOS, iPadOS |
| Runs on | Windows, macOS, Linux |
| Pricing | Free |
| Users | Open-source DFIR community, Research, Law enforcement |
| Last activity | 2026-10 · v.1.36.2 release (2026-10-10); latest commit 2026-10-27 [github.com] |
| GitHub activity | ydkhatri/mac_apt · 1,099 stars · last push 2026-11-09 · latest release v.1.39.0 (2026-11-06) · checked 2026-11-10 |
Capabilities
- Processes Mac computer full disk images or live machines and extracts forensic data via plugins for individual artefacts; works on E01, VMDK, AFF4, DD, split-DD, DMG, sparseimage, UAC collections and Velociraptor collected files. [github.com]
- Includes ios_apt for processing iOS/iPadOS images, and the README states ios_apt can read a GrayKey extracted file system. [github.com]
- Plugins listed in the README include IDEVICEBACKUPS (reads and exports iPhone/iPad backup databases), IDEVICEINFO (details of connected iDevices), IMESSAGE, CALLHISTORY, SAFARI, NOTES, SCREENTIME, WIFI, BIOME and BASICINFO. [github.com]
- Native HFS and APFS parsers; can process encrypted APFS images with a password or recovery key; outputs XLSX, CSV, TSV, JSONL and SQLite and exports analysed files for later review. [github.com]
- Cross-platform Python tool: the README states Python 3.10 or above (64 bit), tested up to Python 3.14 on Windows and macOS, and links standalone Windows binaries on the releases page. [github.com]
- The installation wiki covers Windows, Linux/Windows Subsystem for Linux and macOS, and recommends Python 3.12 or higher when running from source. [github.com]
Limitations
- The December 2020 announcement of ios_apt states it 'only works on full file system images extracted out to a folder' with no support yet for zip/tar/7z archives, and lists 11 initial plugins (APPS, BASICINFO, FSEVENTS, NETUSAGE, NETWORKING, NOTES, SAFARI, SCREENTIME, SPOTLIGHT, TERMSESSIONS, WIFI). The current README adds that ios_apt can read a GrayKey extracted file system, so the 2020 limits may no longer apply in full. [swiftforensics.com]
- The README's plugin table is predominantly macOS artefacts; the README does not state which plugins apply to iOS images beyond ios_apt itself. [github.com]
Links
Related tools
- iLEAPP · Artefact parsers
- Plaso (log2timeline) · Analysis
- Autopsy · Forensic suites
- ccl_bplist · Utilities and libraries
Sources
- mac_apt README (github.com)
- mac_apt installation wiki (github.com)
- Introducing ios_apt (SwiftForensics, December 2020) (swiftforensics.com)
- mac_apt v.1.36.2 release (github.com)
- GitHub: ydkhatri/mac_apt commits (github.com)
Reviewed . Spotted an error? See the corrections policy.