Changelog

New Features

• f521f3f: feat: add support for --remote to ipsw extract --dmg cmd #888 (@blacktop)

Bug fixes

• dfb4ba2: fix: ipsw disass --dec-llm claude temp/topp issue #909 (@blacktop)
• 1713529: fix: ipsw kernel dec --output issue #901 (@blacktop)

Dependency updates

• 9aed248: chore(deps): bump deps (@blacktop)
• c6bbb88: chore(deps): bump github/codeql-action from 4.30.8 to 4.30.9 (#908) (@dependabot[bot])
• d5351d4: chore(deps): bump go-macho which fixes #910 (@blacktop)

Other work

• ffdd57a: chore(fcs): bump fcs keys (@blacktop)
• 211305d: chore(fcs): bump fcs keys (@blacktop)
• 15defd1: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• e4b9947: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])

Summary

Full Changelog: v3.1.630...v3.1.631

What to do next?

• Read the documentation
• Follow us on Twitter
• Follow us on Mastodon
• Follow us on Bluesky
• Join our Discord

Changelog

Bug fixes

• be31187: fix: CLI flag pkg viper's IsSet function is bugged - switching to other options (@blacktop)

Dependency updates

• 7808d23: chore(deps): bump actions/setup-node from 5 to 6 (#905) (@dependabot[bot])
• a7dbc7d: chore(deps): bump deps (@blacktop)
• 1e297fa: chore(deps): bump estree-util-value-to-estree in /www (#907) (@dependabot[bot])
• 90467e2: chore(deps): bump github/codeql-action from 3.30.6 to 4.30.8 (#904) (@dependabot[bot])
• b89be34: chore(deps): bump stefanzweifel/git-auto-commit-action (#902) (@dependabot[bot])

Other work

• e83c23b: chore(ents): update entitlements DB for iOS macOS [skip ci] (@github-actions[bot])
• b4a1334: chore(fcs): update fcs keys (@blacktop)
• fdd1094: chore(fcs-keys): update FCS keys (beta) [skip ci] (@github-actions[bot])
• 556fef7: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• f8d4e66: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 37cd36d: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 24f209c: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 19cce01: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 2c43533: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• e77d844: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• d77dffa: chore: add new devices to ipsw DB (@blacktop)
• d02be93: chore: stringer changes (@blacktop)

Summary

Full Changelog: v3.1.629...v3.1.630

What to do next?

• Read the documentation
• Follow us on Twitter
• Follow us on Mastodon
• Follow us on Bluesky
• Join our Discord

Changelog

New Features

• 57b95a4: feat: add --lookup to ipsw img3 extract cmd (@blacktop)

Bug fixes

• 5522d73: fix: ipsw disass --dec not finding NEW Sonnet 4.5 model (@blacktop)
• 37c1409: fix: ipsw dsc disass --dec when --dec-model doesn't exist (@blacktop)
• eca1a79: fix: ipsw idev img sign plist Marshal error 👨🏾‍🔬 (@blacktop)
• c1aca6e: fix: ipsw img3 extract flag parsing (@blacktop)
• c87206e: fix: ipsw macho dump --section (@blacktop)
• f118cc1: fix: ent db CI sometimes fails (@blacktop)

Dependency updates

• 6e7f0da: chore(deps): bump deps (@blacktop)
• dafcc89: chore(deps): bump github/codeql-action from 3.30.3 to 3.30.6 (#889) (@dependabot[bot])

Documentation updates

• caad891: docs: update CLI docs (@blacktop)

Other work

• 30fed6a: chore(ents): update entitlements DB for iOS macOS [skip ci] (@github-actions[bot])

Summary

Full Changelog: v3.1.628...v3.1.629

What to do next?

• Read the documentation
• Follow us on Twitter
• Follow us on Mastodon
• Follow us on Bluesky
• Join our Discord

Changelog

Highlights

Download OTA AEA fcs keys as a JSON database (databases are additive so can be updated)

❯ ipsw download ota --platform ios --beta --fcs-keys
   • Added 35 new entries to ota_fcs_keys.json (total: 53)

Use these OTA AEA fcs keys DB to extract files from AEA encrypted OTAs offline

❯ ipsw ota extract --kernel --key-db ota_fcs_keys.json 0f4c99698a4bac876ea6688d7d1d94170b7b757ea6c74263009de2a3f36beb5b.aea 
   • Extracting kernelcache(s)
      • 23B5044l__iPhone18,1/AssetData/boot/kernelcache.release.v53

New Features

• ed612d0: feat: add --ent-der to ipsw macho info cmd to dump DER entitlements as XML (@blacktop)
• c47db3e: feat: add --fcs-keys to ipsw download ota command 🧅 (@blacktop)
• 77166f3: feat: add auto-aea + fcs-key DB support to all ipsw ota commands (@blacktop)
• 9af1e5a: feat: add launch constraints to ipsw diff --ent (@blacktop)

Bug fixes

• 141045a: fix: ipsw diff cleanup original file .aea files properly (@blacktop)
• 6c94b4a: fix: ipsw download ota --build filtering not working correctly 🥙 (@blacktop)
• 3faee26: fix: ipsw macho sign flag verification + add --verify to verify via codesign signed macho/app (@blacktop)
• daeae84: fix: make build on systems without gh (@blacktop)
• d4f8296: fix: cleanup/refactor ipsw download ota --fcs-key command (@blacktop)
• 6b23a97: fix: for ipsw diff --ent if ents are empty but DER ents exist use them (@blacktop)
• cac6764: fix: prevent NEW launch constraints from breaking ent DB (@blacktop)

Dependency updates

• 5def560: chore(deps): bump brace-expansion from 1.1.11 to 1.1.12 in /www (#879) (@dependabot[bot])
• d661e11: chore(deps): bump dep + fcs keys (@blacktop)
• 0ec998a: chore(deps): bump deps (@blacktop)
• 6d0b904: chore(deps): bump deps (@blacktop)
• 8094ecc: chore(deps): bump deps + fcs keys (@blacktop)
• 69f3e29: chore(deps): bump mermaid from 11.6.0 to 11.12.0 in /www (#881) (@dependabot[bot])
• d060c6f: chore(deps): bump webpack-dev-server from 4.15.2 to 5.2.2 in /www (#880) (@dependabot[bot])

Documentation updates

• 0ceb222: docs: bump docusaurus (@blacktop)
• f889361: docs: bump docusaurus (@blacktop)
• d7b994a: docs: update CLI docs (@blacktop)
• a2d18cf: docs: update CLI docs (@blacktop)
• 973eb48: docs: use proper platform name in word copy for version count (#876) (@nmggithub)

Other work

• 4072510: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 6c55180: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 245396c: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 189c526: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 58cabf8: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 28e40b3: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])

Summary

Full Changelog: v3.1.627...v3.1.628

What to do next?

• Read the documentation
• Follow us on Twitter
• Follow us on Mastodon
• Follow us on Bluesky
• Join our Discord

Changelog

New Features

• 6e31eb5: feat: add support for 'rdisk' to ipsw mount cmd 🇬🇧 (@blacktop)

Bug fixes

• f9e7104: fix: ipsw ota info not parsing Info.plist properly due to .Name() not being full path (@blacktop)

Dependency updates

• 8070b02: chore(deps): bump deps (@blacktop)
• d7b6707: chore(deps): bump deps (@blacktop)
• 6348663: chore(deps): bump github/codeql-action from 3.30.1 to 3.30.3 (#865) (@dependabot[bot])

Other work

• 7dbb038: chore(ents): update entitlements DB for iOS macOS [skip ci] (@github-actions[bot])
• 4f33267: chore(ents): update entitlements DB for iOS macOS [skip ci] (@github-actions[bot])
• 293a4e5: chore(ents): update entitlements DB for iOS macOS [skip ci] (@github-actions[bot])
• 67b66ed: chore(fcs): update fcs keys (@blacktop)
• 498cb3f: chore(fcs-keys): update FCS keys (beta) [skip ci] (@github-actions[bot])
• 131f74a: chore(fcs-keys): update FCS keys (beta) [skip ci] (@github-actions[bot])
• 27ecae6: chore(fcs-keys): update FCS keys (beta) [skip ci] (@github-actions[bot])
• 40cc1af: chore(fcs-keys): update FCS keys (beta) [skip ci] (@github-actions[bot])
• 50fb41a: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 49c9c38: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 2eed877: chore: fix ota audiences for 26.1 (@blacktop)

Summary

Full Changelog: v3.1.626...v3.1.627

What to do next?

• Read the documentation
• Follow us on Twitter
• Follow us on Mastodon
• Follow us on Bluesky
• Join our Discord

Changelog

Bug fixes

• 29648b6: fix: ipsw ota ls and ipsw ota extract cmds (@blacktop)

Summary

Full Changelog: v3.1.625...v3.1.626

What to do next?

• Read the documentation
• Follow us on Twitter
• Follow us on Mastodon
• Follow us on Bluesky
• Join our Discord

Changelog

Bug fixes

• bd63f25: fix: ipsw dl dev cmd (apple changed the dev portal html) (@blacktop)
• d95682c: fix: add --pg-poolmode to ipsw ent cmd (@blacktop)

Dependency updates

• cf088d2: chore(deps): bump actions/setup-go from 5 to 6 (#855) (@dependabot[bot])
• 879ea3a: chore(deps): bump actions/setup-node from 4 to 5 (#852) (@dependabot[bot])
• f87d8ea: chore(deps): bump actions/stale from 9 to 10 (#854) (@dependabot[bot])
• ba97275: chore(deps): bump actions/upload-pages-artifact from 3 to 4 (#844) (@dependabot[bot])
• 031a50a: chore(deps): bump deps (@blacktop)
• eb8b1dc: chore(deps): bump deps (@blacktop)
• 7d219ea: chore(deps): bump deps (@blacktop)
• 3dc22bf: chore(deps): bump github/codeql-action from 3.29.10 to 3.29.11 (#842) (@dependabot[bot])
• 39fd2b4: chore(deps): bump github/codeql-action from 3.29.11 to 3.30.0 (#850) (@dependabot[bot])
• 31d9a3d: chore(deps): bump github/codeql-action from 3.29.9 to 3.29.10 (#835) (@dependabot[bot])
• b6b993e: chore(deps): bump github/codeql-action from 3.30.0 to 3.30.1 (#859) (@dependabot[bot])
• 366561a: chore(deps): bump golang from 1.24 to 1.25 (#833) (@dependabot[bot])
• 31203b7: chore(deps): bump gorm.io/gorm from 1.30.1 to 1.30.3 (#858) (@dependabot[bot])
• 9c381ce: chore(deps): bump sarisia/actions-status-discord from 1.15.3 to 1.15.4 (#837) (@dependabot[bot])

Documentation updates

• fd96d0e: docs: update entitlement browser UI + add support for macOS IPSWs (@blacktop)

Other work

• 3e42b77: chore(ents): update entitlements DB for iOS [skip ci] (@github-actions[bot])
• 9ed5b39: chore(ents): update entitlements DB for iOS [skip ci] (@github-actions[bot])
• b858815: chore(ents): update entitlements DB for iOS macOS [skip ci] (@github-actions[bot])
• 67c8793: chore(ents): update entitlements DB for iOS macOS [skip ci] (@github-actions[bot])
• c01c4c2: chore(ents): update entitlements DB for iOS macOS [skip ci] (@github-actions[bot])
• 24de060: chore(ents): update entitlements DB for macOS [skip ci] (@github-actions[bot])
• 2904652: chore(ents): update entitlements DB for macOS [skip ci] (@github-actions[bot])
• 6008185: chore(fcs-keys): update FCS keys (beta) [skip ci] (@github-actions[bot])
• 3389904: chore(fcs-keys): update FCS keys (beta) [skip ci] (@github-actions[bot])
• 687a4b9: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• daa7121: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• f653e3c: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• a914a6f: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 934be5a: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 7459ee5: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 2e7aab4: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 2e3e797: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 82e48f3: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 1b73bdf: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 5270cdb: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• a3391a3: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 21b55ec: chore: add NEW iPhone 17 models to ipsw DB (@blacktop)
• 0be6300: chore: add public beta OTA audiences + watches to ipsw DB (@blacktop)

Summary

Full Changelog: v3.1.624...v3.1.625

What to do next?

• Read the documentation
• Follow us on Twitter
• Follow us on Mastodon
• Follow us on Bluesky
• Join our Discord

Changelog

New Features

• e1ad160: feat: added --mount-point|-m flag to ipsw mount cmd to let you pick the mount location + docs update (@blacktop)

Bug fixes

• ca27345: fix: ipsw car handle KEYFORMATWORKAROUND blocks #823 (@blacktop)
• 042e5ce: fix: ipsw diff cmd (@blacktop)
• 478a569: fix: add partial --insecure support to fcs key pem download in AEA commands (@blacktop)

Dependency updates

• c71432e: chore(deps): bump actions/checkout from 4 to 5 (#831) (@dependabot[bot])
• fee1680: chore(deps): bump deps (@blacktop)
• ebff4f6: chore(deps): bump deps (@blacktop)
• 13c79a5: chore(deps): bump docker (@blacktop)
• 3a23cf5: chore(deps): bump github/codeql-action from 3.29.2 to 3.29.4 (#815) (@dependabot[bot])
• 634effe: chore(deps): bump github/codeql-action from 3.29.4 to 3.29.7 (#829) (@dependabot[bot])
• 8c3193f: chore(deps): bump github/codeql-action from 3.29.7 to 3.29.9 (#832) (@dependabot[bot])
• 1584bf3: chore(deps): bump on-headers and compression in /www (#810) (@dependabot[bot])

Documentation updates

• 060a85b: docs: enhance mobile search UI and improve error handling (@blacktop)

Other work

• 84f6854: chore(fcs): re-tar fcs-keys (@blacktop)
• eb388ee: chore(fcs): update fcs keys (@blacktop)
• 62fb966: chore(fcs): update fcs keys (@blacktop)
• 53712d6: chore(fcs-keys): update FCS keys (beta) [skip ci] (@github-actions[bot])
• 8cb580e: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• f14244e: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 423bf3a: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• fea0542: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• a5a33ab: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 79acf14: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• ed2e74d: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 17f73cc: chore(fcs-keys): update FCS keys (stable,RC) [skip ci] (@github-actions[bot])
• 8cb2626: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• d012e7e: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 90208b1: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 197d033: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• a83d1da: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 1262781: chore: add macOS 16 and 26 installer catalog URLs (@blacktop)
• 57d3699: chore: add viper config to all commands (@blacktop)
• 93c6369: chore: expand paths in yml/env_var config (@blacktop)
• d96b670: chore: more command cleanup (@blacktop)
• f0108e4: chore: standardize the CLI to show usage on error/no-input #813 (@blacktop)
• 3f64dee: chore: update fcs Makefile targets (@blacktop)
• fb02c65: chore: various command typos (@blacktop)

Summary

Full Changelog: v3.1.623...v3.1.624

What to do next?

• Read the documentation
• Follow us on Twitter
• Follow us on Mastodon
• Follow us on Bluesky
• Join our Discord

Changelog

New Features

• 1093591: feat: add --plain and --json flags to ipsw device-list command #803 (@blacktop)

Bug fixes

• 28a54ae: fix: ipsw extract --dyld issues with temporarily extracting DMGs to current directory #800 (@blacktop)
• cdcc127: fix: ipsw macho disass panic on macOS bins + --arch flag typo (@blacktop)
• 52a85d2: fix: attempt to fix apfs-fuse not being found errors (#793 #774) (@blacktop)
• e427ad3: fix: bind UDID flag to viper config in idev command #801 (@blacktop)

Documentation updates

• 7e531f5: docs: update download guide to include all new-ish commands (@blacktop)

Other work

• 0e16377: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 316e7db: chore: add --info flag to ipsw dl pcc command (@blacktop)
• af7b1b6: chore: add regex to ipsw device-info cmd (@blacktop)
• 7400ccd: chore: json_mini sort keys (more idempotent w/ Github Action CI for fcs-keys) (@blacktop)

Summary

Full Changelog: v3.1.622...v3.1.623

What to do next?

• Read the documentation
• Follow us on Twitter
• Follow us on Mastodon
• Follow us on Bluesky

Changelog

Highlights

Improved ipsw download wp command to preview/download wallpapers

New Features

• d9d116e: feat: greatly improve the ipsw dl wp cmd 🌈 (@blacktop)

Bug fixes

• 2ef609d: fix: ipsw dl ipsw --macos --show-latest-build #797 (@blacktop)
• 45ec30f: fix: a few more ipsw download flag validation issues (@blacktop)

Dependency updates

• 8e278d4: chore(deps): remove tablewriter dependency (@blacktop)
• 07c6acb: chore(deps): update go-termimg (@blacktop)

Documentation updates

• e4a9030: docs: add example usage to ipsw pl cmd (@blacktop)
• 2341d75: docs: add examples to more cmds (@blacktop)
• 4dcfa0b: docs: update CLI docs (@blacktop)

Other work

• 0291642: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 2bd5f04: chore: add profiling helper functions (@blacktop)
• 94359af: chore: move from iterm2 only terminal images to go-termimg pkg (@blacktop)
• 9be8aff: chore: update ipsw dl wp cmd to use NEW go-termimg pkg (@blacktop)

Summary

Full Changelog: v3.1.621...v3.1.622

What to do next?

• Read the documentation
• Follow us on Twitter
• Follow us on Mastodon
• Follow us on Bluesky