{"id":19439838,"url":"https://github.com/matteyeux/autodecrypt","last_synced_at":"2025-04-06T02:07:26.215Z","repository":{"id":36933013,"uuid":"171001021","full_name":"matteyeux/autodecrypt","owner":"matteyeux","description":"Tool to decrypt 64 bits iOS firmware images (iBoot/LLB/iBSS/iBEC).","archived":false,"fork":false,"pushed_at":"2023-05-31T16:56:32.000Z","size":218,"stargazers_count":178,"open_issues_count":8,"forks_count":38,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-03-30T01:11:18.419Z","etag":null,"topics":["checkm8","checkra1n","iboot"],"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/matteyeux.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}},"created_at":"2019-02-16T12:23:37.000Z","updated_at":"2025-03-29T00:37:33.000Z","dependencies_parsed_at":"2025-01-19T23:14:12.188Z","dependency_job_id":"144a716f-347d-4528-b20a-7ae5c958bb6a","html_url":"https://github.com/matteyeux/autodecrypt","commit_stats":{"total_commits":76,"total_committers":7,"mean_commits":"10.857142857142858","dds":0.4342105263157895,"last_synced_commit":"15cb32927c1be8a8ce583e2c0a742561b43f274b"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matteyeux%2Fautodecrypt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matteyeux%2Fautodecrypt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matteyeux%2Fautodecrypt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matteyeux%2Fautodecrypt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matteyeux","download_url":"https://codeload.github.com/matteyeux/autodecrypt/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247423513,"owners_count":20936626,"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":["checkm8","checkra1n","iboot"],"created_at":"2024-11-10T15:26:59.177Z","updated_at":"2025-04-06T02:07:26.189Z","avatar_url":"https://github.com/matteyeux.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# autodecrypt\n[![PyPI version](https://badge.fury.io/py/autodecrypt.svg)](https://badge.fury.io/py/autodecrypt)\n\nSimple tool to decrypt iOS firmware images.\n\nGoing to the iPhone wiki and copying and pasting firmware keys to your terminal is boring.\n\nautodecrypt will grab keys for you and decrypt the firmware image you want.\n\n## Usage\n```\nUsage: autodecrypt [OPTIONS]\n\nOptions:\n  -f, --filename TEXT             File  [required]\n  -d, --device TEXT               Device  [required]\n  -i, --ios_version TEXT          iOS version\n  -b, --build TEXT                Build ID of iOS version\n  -k, --ivkey TEXT                IV and key to decrypt file\n  -l, --local                     Use path to local file\n  -D, --download                  Download file\n  -B, --beta                      Specify that it is a beta firmware\n  -P, --pongo                     Use PongoOS over USB for decryption\n  --install-completion [bash|zsh|fish|powershell|pwsh]\n                                  Install completion for the specified shell.\n  --show-completion [bash|zsh|fish|powershell|pwsh]\n                                  Show completion for the specified shell, to\n                                  copy it or customize the installation.\n  --help                          Show this message and exit.\n```\n\n## Dependencies\n- [img4](https://github.com/xerub/img4lib)\n\nTo run autodecrypt, use poetry with a virtualenv:\n- `virtualenv -p python3 env`\n- `pip3 install poetry`\n- `poetry install`\n\n\n## Installation\n`pip3 install autodecrypt`\n\n\n## Examples\n\n#### Download and decrypt iBSS using keys from theiphonewiki\n```\n» autodecrypt -f iBSS.iphone6.RELEASE.im4p -i 10.3.3 -d iPhone6,2\n[i] downloading iBSS.iphone6.RELEASE.im4p\n[i] image : ibss\n[i] grabbing keys for iPhone6,2/14G60\n[x] iv  : f2aa35f6e27c409fd57e9b711f416cfe\n[x] key : 599d9b18bc51d93f2385fa4e83539a2eec955fce5f4ae960b252583fcbebfe75\n[i] decrypting iBSS.iphone6.RELEASE.im4p to iBSS.iphone6.RELEASE.bin...\n[x] done\n```\n\n#### Download and decrypt SEP firmware by specifying keys\n```\n» autodecrypt -f sep-firmware.n841.RELEASE.im4p -b 17C5053a -d iPhone11,8 -k 9f974f1788e615700fec73006cc2e6b533b0c6c2b8cf653bdbd347bc1897bdd66b11815f036e94c951250c4dda916c00\n[i] downloading sep-firmware.n841.RELEASE.im4p\n[x] iv  : 9f974f1788e615700fec73006cc2e6b5\n[x] key : 33b0c6c2b8cf653bdbd347bc1897bdd66b11815f036e94c951250c4dda916c00\n[i] decrypting sep-firmware.n841.RELEASE.im4p to sep-firmware.n841.RELEASE.bin...\n[x] done\n```\n\n#### Use [foreman](https://github.com/GuardianFirewall/foreman) instance to grab firmware keys\n```\n» export FOREMAN_HOST=\"https://foreman-public.sudosecuritygroup.com\"\n» autodecrypt -f LLB.n112.RELEASE.im4p -i 13.2.3 -d iPod9,1\n[i] downloading LLB.n112.RELEASE.im4p\n[i] image : llb\n[i] grabbing keys for iPod9,1/17B111\n[i] grabbing keys from https://foreman-public.sudosecuritygroup.com\n[x] iv  : 85784a219eb29bcb1cc862de00a590e7\n[x] key : f539c51a7f3403d90c9bdc62490f6b5dab4318f4633269ce3fbbe855b33a4bc7\n[i] decrypting LLB.n112.RELEASE.im4p to LLB.n112.RELEASE.bin...\n[x] done\n```\n\n#### Decrypt keys with PongoOS\n\u003e I you wanna use this on Linux, you may have some USB permissions. I recommend copying the file `66-pongos.rules` available on this repository to `/etc/udev/rules.d/`.\n\n```\n» autodecrypt -f iBoot.n71.RELEASE.im4p -d iPhone8,1 -i 14.1 -p\n[i] downloading iBoot.n71.RELEASE.im4p\n[i] grabbing keys from PongoOS device\n[i] kbag : 03C9E01CA99FE6475566C791777169C0625B04B7BD4E593DE0F61ABF4E8DB1A987D9D6155C5A1F41D9113694658AC61C\n[x] iv  : 245a9b52e53a704fe73d7b58734b00ae\n[x] key : d3aa3c8cc20fa9d61e466f46aee374a92a125abb5b3f57264025c8c72127e321\n[i] decrypting iBoot.n71.RELEASE.im4p to iBoot.n71.RELEASE.bin...\n[x] done\n```\n\n#### Log\n\nFor debugging purposes you can check `autodecrypt.log` :\n```\n11/02/2019 21:39:41 Launching \"['autodecrypt/autodecrypt.py', '-d', 'iPhone9,3', '-f', 'iBoot.d10.RELEASE.im4p', '-i', '12.3.1']\"\n11/02/2019 21:39:41 requesting IPSW's API for iPhone9,3\n11/02/2019 21:39:41 done, now looking for version or build\n11/02/2019 21:39:41 grabbing firmware codename for 16F203\n11/02/2019 21:39:42 codename : PeaceF\n11/02/2019 21:39:42 grabbing IPSW file URL for iPhone9,3/12.3.1\n11/02/2019 21:39:42 downloading iBoot...\n11/02/2019 21:39:43 img4 -i iBoot.d10.RELEASE.im4p iBoot.d10.RELEASE.bin 978fd4680cd4b624b0dfea22a417f51f0ee2b871defed42277fe18885053b1eb5c7ffe82f38ab8cf7772c69a0db5d386\n```\n\n\n### Credits\n- checkra1n team for AES patches, kbag.m and [PongoOS](https://github.com/checkra1n/pongoos)\n- tihmstar for wiki parsing ([my method](https://github.com/matteyeux/ios-tools/blob/master/scrapkeys.py) was pretty bad)\n- m1stadev for [PyIMG4](https://github.com/m1stadev/PyIMG4)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatteyeux%2Fautodecrypt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatteyeux%2Fautodecrypt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatteyeux%2Fautodecrypt/lists"}