{"id":13721662,"url":"https://github.com/abrignoni/iLEAPP","last_synced_at":"2025-05-07T14:30:44.918Z","repository":{"id":37885007,"uuid":"229842283","full_name":"abrignoni/iLEAPP","owner":"abrignoni","description":"iOS Logs, Events, And Plist Parser","archived":false,"fork":false,"pushed_at":"2025-05-01T17:06:47.000Z","size":27374,"stargazers_count":862,"open_issues_count":41,"forks_count":180,"subscribers_count":31,"default_branch":"main","last_synced_at":"2025-05-01T18:23:15.950Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abrignoni.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-12-24T00:28:42.000Z","updated_at":"2025-05-01T17:06:51.000Z","dependencies_parsed_at":"2023-10-16T11:47:17.008Z","dependency_job_id":"4d84237d-f62d-4296-a95d-83a64e2cebc2","html_url":"https://github.com/abrignoni/iLEAPP","commit_stats":null,"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abrignoni%2FiLEAPP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abrignoni%2FiLEAPP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abrignoni%2FiLEAPP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abrignoni%2FiLEAPP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abrignoni","download_url":"https://codeload.github.com/abrignoni/iLEAPP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252895472,"owners_count":21821167,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T01:01:19.890Z","updated_at":"2025-05-07T14:30:39.906Z","avatar_url":"https://github.com/abrignoni.png","language":"Python","readme":"# iLEAPP\n\niOS Logs, Events, And Plists Parser  \nDetails in blog post here: https://abrignoni.blogspot.com/2019/12/ileapp-ios-logs-events-and-properties.html\n\nSupports iOS/iPadOS 11, 12, 13 and 14, 15, 16.\nSelect parsing directly from a compressed .tar/.zip file, or a decompressed directory, or an iTunes/Finder backup folder.\n\n## Features\n\nParses:  \n⚙️ Mobile Installation Logs  \n⚙️ iOS 12+ Notifications  \n⚙️ Build Info (iOS version, etc.)  \n⚙️ Wireless cellular service info (IMEI, number, etc.)  \n⚙️ Screen icons list by screen and in grid order.  \n⚙️ ApplicationState.db support for app bundle ID to data container GUID correlation.   \n⚙️ User and computer names that the iOS device connected to. Function updated by Jack Farley (@JackFarley248, http://farleyforensics.com/).  \netc...\n\n## Requirements\n\nPython 3.9 to latest version (older versions of 3.x will also work with the exception of one or two modules)\nIf on macOS (Intel) make sure Xcode is installed and have command line tools updated to be able to use Python 3.11. \n\n### Dependencies\n\nDependencies for your python environment are listed in `requirements.txt`. Install them using the below command. Ensure \nthe `py` part is correct for your environment, eg `py`, `python`, or `python3`, etc. \n\n`py -m pip install -r requirements.txt`  \nor  \n `pip3 install -r requirements.txt`\n\nTo run on **Linux**, you will also need to install `tkinter` separately like so:\n\n`sudo apt-get install python3-tk`\n\nTo install on Windows follow the guide, courtesy of Hexordia, here:\nhttps://www.hexordia.com/s/ILEAPP-Walkthrough.pdf\n\nWindows installation and walkthrough video, by Hexordia, here:\nhttps://www.youtube.com/watch?v=7qvVFfBM2NU\n\n## Compile to executable\n\nTo compile to an executable so you can run this on a system without python installed.\nIf using Python 3.10 and above delete the arguments from the following terminal commands.\n\n*Windows OS*\n\nTo create ileapp.exe, run:\n\n```\npyinstaller --onefile ileapp.spec\n```\n\nTo create ileappGUI.exe, run:\n\n```\npyinstaller --onefile --noconsole ileappGUI.spec\n```\n\n*macOS*\n\nTo create ileapp, run:\n\n```\npyinstaller --onefile ileapp_macOS.spec\n```\n\nTo create ileappGUI.app, run:\n\n```\npyinstaller --onefile --windowed ileappGUI_macOS.spec\n```\n\n## Usage\n\n### CLI\n\n```\n$ python ileapp.py -t \u003czip | tar | fs | gz\u003e -i \u003cpath_to_extraction\u003e -o \u003cpath_for_report_output\u003e\n```\n\n### GUI\n\n```\n$ python ileappGUI.py \n```\n\n### Help\n\n```\n$ python ileapp.py --help\n```\n\n## Contributing artifact plugins\n\nEach plugin is a Python source file which should be added to the `scripts/artifacts` folder which will be loaded dynamically each time ILEAPP is run.\n\nThe plugin source file must contain a dictionary named `__artifacts_v2__` at the very beginning of the module, which defines the artifacts that the plugin processes. The keys in the `__artifacts_v2__` dictionary should be IDs for the artifact(s) which must be unique within ILEAPP. The values should be dictionaries containing the following keys:\n\n- `name`: The name of the artifact as a string.\n- `description`: A description of the artifact as a string.\n- `author`: The author of the plugin as a string.\n- `version`: The version of the artifact as a string.\n- `date`: The date of the last update to the artifact as a string.\n- `requirements`: Any requirements for processing the artifact as a string.\n- `category`: The category of the artifact as a string.\n- `notes`: Any additional notes as a string.\n- `paths`: A tuple of strings containing glob search patterns to match the path of the data that the plugin expects for the artifact.\n- `function`: The name of the function which is the entry point for the artifact's processing as a string.\n\nFor example:\n\n```python\n__artifacts_v2__ = {\n    \"cool_artifact_1\": {\n        \"name\": \"Cool Artifact 1\",\n        \"description\": \"Extracts cool data from database files\",\n        \"author\": \"@username\",\n        \"version\": \"0.1\",\n        \"date\": \"2022-10-25\",\n        \"requirements\": \"none\",\n        \"category\": \"Really cool artifacts\",\n        \"notes\": \"\",\n        \"paths\": ('*/com.android.cooldata/databases/database*.db',),\n        \"function\": \"get_cool_data1\"\n    },\n    \"cool_artifact_2\": {\n        \"name\": \"Cool Artifact 2\",\n        \"description\": \"Extracts cool data from XML files\",\n        \"author\": \"@username\",\n        \"version\": \"0.1\",\n        \"date\": \"2022-10-25\",\n        \"requirements\": \"none\",\n        \"category\": \"Really cool artifacts\",\n        \"notes\": \"\",\n        \"paths\": ('*/com.android.cooldata/files/cool.xml',),\n        \"function\": \"get_cool_data2\"\n    }\n}\n```\n\nThe functions referenced as entry points in the `__artifacts__` dictionary must take the following arguments:\n\n* An iterable of the files found which are to be processed (as strings)\n* The path of ILEAPP's output folder(as a string)\n* The seeker (of type FileSeekerBase) which found the files\n* A Boolean value indicating whether or not the plugin is expected to wrap text\n\nFor example:\n\n```python\ndef get_cool_data1(files_found, report_folder, seeker, wrap_text):\n    pass  # do processing here\n```\n\nPlugins are generally expected to provide output in ILEAPP's HTML output format, TSV, and optionally submit records to \nthe timeline. Functions for generating this output can be found in the `artifact_report` and `ilapfuncs` modules. \nAt a high level, an example might resemble:\n\n```python\n__artifacts_v2__ = {\n    \"cool_artifact_1\": {\n        \"name\": \"Cool Artifact 1\",\n        \"description\": \"Extracts cool data from database files\",\n        \"author\": \"@username\",  # Replace with the actual author's username or name\n        \"version\": \"0.1\",  # Version number\n        \"date\": \"2022-10-25\",  # Date of the latest version\n        \"requirements\": \"none\",\n        \"category\": \"Really cool artifacts\",\n        \"notes\": \"\",\n        \"paths\": ('*/com.android.cooldata/databases/database*.db',),\n        \"function\": \"get_cool_data1\"\n    }\n}\n\nimport datetime\nfrom scripts.artifact_report import ArtifactHtmlReport\nimport scripts.ilapfuncs\n\ndef get_cool_data1(files_found, report_folder, seeker, wrap_text):\n    # let's pretend we actually got this data from somewhere:\n    rows = [\n     (datetime.datetime.now(), \"Cool data col 1, value 1\", \"Cool data col 1, value 2\", \"Cool data col 1, value 3\"),\n     (datetime.datetime.now(), \"Cool data col 2, value 1\", \"Cool data col 2, value 2\", \"Cool data col 2, value 3\"),\n    ]\n    \n    headers = [\"Timestamp\", \"Data 1\", \"Data 2\", \"Data 3\"]\n    \n    # HTML output:\n    report = ArtifactHtmlReport(\"Cool stuff\")\n    report_name = \"Cool DFIR Data\"\n    report.start_artifact_report(report_folder, report_name)\n    report.add_script()\n    report.write_artifact_data_table(headers, rows, files_found[0])  # assuming only the first file was processed\n    report.end_artifact_report()\n    \n    # TSV output:\n    scripts.ilapfuncs.tsv(report_folder, headers, rows, report_name, files_found[0])  # assuming first file only\n    \n    # Timeline:\n    scripts.ilapfuncs.timeline(report_folder, report_name, rows, headers)\n\n```\n\n## Acknowledgements\n\nThis tool is the result of a collaborative effort of many people in the DFIR community.\n","funding_links":[],"categories":["Tools","Python","iOS"],"sub_categories":["Mobile Forensics","Static Analysis Tools","Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabrignoni%2FiLEAPP","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabrignoni%2FiLEAPP","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabrignoni%2FiLEAPP/lists"}