v3.1.623

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

v3.1.622

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

v3.1.621

Changelog

Bug fixes

• 95f4679: fix: IPSW SQL Schema error for buildid field (@blacktop)
• 727cd3f: fix: extract BUND with kernel/apps in ipsw fw exc command 🇮🇹 (@blacktop)
• 07e21eb: fix: re-type IM4P duing ipsw img4 create cmd (@blacktop)

Dependency updates

• c280ccf: chore(deps): bump github/codeql-action from 3.29.1 to 3.29.2 (#787) (@dependabot[bot])

Documentation updates

• 7ae9010: docs: update CLI docs (@blacktop)

Other work

• 1c53ae3: chore: make ipsw img3 commands the same syntax as the ipsw img4 commands (@blacktop)
• 59c4d9b: chore: un-hide the ipsw lsbom and ipsw device-info commands (@blacktop)

Summary

Full Changelog: v3.1.620...v3.1.621

What to do next?

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

v3.1.620

Changelog

Highlights

Check IPSW signing status

❱ ipsw dl tss --version 17.5.1 --signed --device iPhone15,2
   ⨯ 💀 No longer being signed  build=21F90 device=iPhone15,2 version=17.5.1

❱ ipsw dl tss --version 18.5 --signed --device iPhone17,1
   • ✅ Is still being signed   build=22F76 device=iPhone17,1 version=18.5

❱ ipsw dl tss --version 26.0 --beta --signed --device iPhone17,1
   • ✅ Is still being signed   beta=true build=23A5260n device=iPhone17,1 version=26.0

Download SHSH blob

ipipsw dl tss --version 26.0 --beta --device iPhone17,1 --output SHSH.26.0.blob
   • SHSH blob saved           output=SHSH.26.0.blob

Examine

❱ ipsw img4 im4m extract SHSH.26.0.blob
   • Extracting IM4M           path=SHSH.26.0.blob.im4m size=12 kB

❱ ipsw img4 im4m info SHSH.26.0.blob.im4m
IM4M (Manifest):
  Tag:        IM4M
  Version:    0
  Body Size:  9831 bytes
  Raw Size:   12196 bytes
  Properties: 22
    Device Properties:
      CHIP (ApChipID): 33088
      BORD (ApBoardID): 12
      ECID (ExclusiveChipID): 1234567890
      SDOM (ApSecurityDomain): 1
      CEPO (CertificateEpoch): 1
    Security Properties:
      CPRO (CertificateProductionStatus): true
      CSEC (CertificateSecurityMode): true
      srvn (SecurityRevisionNumber): 5eb61ffea80974636ceb9eda6b93fdf46d7e8a58
      snon (SecurityNonce): 1deac0d8449ec99f69b5fe44104fdb2f65a8c386
      BNCH (BootNonceHash): d0a5b110379645182bdfdedd7b168213bdc2bbf44d9ce6aa7147f0a5b069d4d5
    Version Properties:
      love (ApOSLongVersion): 23.1.260.5.14,0
      prtp (ApProductType): iPhone17,1
      sdkp (ApSDKPlatform): iphoneos
    Other Properties:
      apmv (ProductMarketingVersion): 26.0
      eply: 7801018081
      esdm: 0
      nrde: 0
      pcrp: 0440465e12b073bab7885be45281833fa8f676ba71482c6c482383683408a86c1de77c19274c48248bf44537f64d2efefeee0ace1ac03736f5f6bf93433c2a149329869de6237c98e29ba420573f9164bb0cb400c7f7ed5815d7eaf9788a0df012
      pndp: 1
      tagt (ApTarget): D93AP
      tatp (ApTargetType): d93
      uidm: false
<SNIP>

Bug fixes

• c2cdf26: fix: ipsw download tss cmd, now correctly checking signed status and downloading SHSH blobs (@blacktop)
• 249dfa8: fix: ipsw download cmd extra flags inherited from parent (@blacktop)
• a9a305f: fix: ipsw fw exc cmd's IPSW auto folder generation (@blacktop)

Dependency updates

• c6626e7: chore(deps): bump deps (@blacktop)

Documentation updates

• 2a0afe2: docs: update CLI docs (@blacktop)
• 6795f49: docs: update CLI docs (@blacktop)

Other work

• 3857a6d: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• a04c1bc: chore: add usage examples to download cmds (@blacktop)
• 1d50b18: chore: more download cmd cleanup (@blacktop)
• d50004e: chore: move more cmds/code over to using the NEW img4 APIs (@blacktop)
• 7c8a215: chore: unhide pbzx, comp and decomp cmds (@blacktop)

Summary

Full Changelog: v3.1.619...v3.1.620

What to do next?

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

v3.1.619

Changelog

New Features

• 8f1c756: feat: add NEW 'hidden' ipsw comp and ipsw decomp cmds to use libcompression.dylib (@blacktop)
• 98b9ae7: feat: add NEW --lookup flag to ipsw img4 im4p extract to auto grab the --iv-key (@blacktop)
• e223d9f: feat: add NEW comp package (@blacktop)
• bd25e35: feat: auto-detect --lookup-device and --lookup-build based on ipsw extracted im4p folder (@blacktop)

Bug fixes

• 9bded99: fix: ipsw img4 create --extra format (@blacktop)
• 77b7d88: fix: a few more minor fixes to img4 code (@blacktop)
• 2dce560: fix: minor fixes to img4 code (@blacktop)
• ef97109: fix: update ipsw img4 to use NEW comp pkg (@blacktop)

Dependency updates

• fc5ddf1: chore(deps): bump deps (@blacktop)
• 49df0c7: chore(deps): bump github/codeql-action from 3.29.0 to 3.29.1 (#786) (@dependabot[bot])
• 97f4350: chore(deps): bump lzss (@blacktop)
• 482d94e: chore(deps): update deps (@blacktop)

Documentation updates

• 6b67da5: docs: Update img4 guide (@blacktop)
• 8731512: docs: update CLI docs (@blacktop)

Other work

• 25d50fb: chore: add single letter aliases to ipsw img4 sub-cmds + CLI help usage examples (@blacktop)
• 9af921e: chore: check for more lzfse start block types in magic pkg (@blacktop)
• 899a23d: chore: cleanup ipsw img4 im4m extract cmd (@blacktop)
• 6a3286d: chore: greatly improve UX of ipsw img4 im4m verify command (@blacktop)
• b608695: chore: hide ipsw img4 person and ipsw img4 im4m verify for now (@blacktop)
• 16fb837: chore: minor ipsw img4 cmd log fmt change (@blacktop)
• b644259: chore: show usage on no input for ipsw img4 cmds (@blacktop)

Summary

Full Changelog: v3.1.618...v3.1.619

What to do next?

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

v3.1.618

Changelog

Bug fixes

• c439135: fix: ipsw dl macos --list --latest #783 (@blacktop)
• 46d1279: fix: ipsw img4 create --compress 'none' using lzss instead (@blacktop)
• 5914534: fix: ipsw img4 im4m parsing bug #777 (@blacktop)
• ee1afb3: fix: few more ipsw img4 related fixes (@blacktop)
• f6a6219: fix: few more fixes to ipsw img4 cmd #777 (@blacktop)

Documentation updates

• 02c3a47: docs: update CLI docs (@blacktop)

Other work

• cce9b1f: chore: compression when using --extra in img4 commands (@blacktop)

Summary

Full Changelog: v3.1.617...v3.1.618

What to do next?

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

v3.1.617

Changelog

New Features

• bdd14cf: feat: add --json flag to ipsw kernel kexts cmd (@blacktop)
• 245fcf3: feat: add caching for downloading fw keys from the applewiki; used in cmds like ipsw mount --lookup (@blacktop)
• 3cded00: feat: revamp ipsw img4 commands to bring inline with tools like img4lib (#784) (@blacktop)
• a51fd93: feat: support mounting on linux for OLD HFS+ DMGs (@blacktop)

Bug fixes

• 179929f: fix: ipsw dl ota --show-latest-build to show release when not using --beta (@blacktop)
• 8003cfd: fix: ipsw dl ota --show-latest for --platform macos (@blacktop)
• 9a2e062: fix: ipsw img4 create cmd #777 (@blacktop)
• ad2d95c: fix: ipsw img4 extraction (@blacktop)
• 2d0e2d2: fix: add new fat/universal macho helper func and use in ipsw macho and ipsw kernel cmds #775 (@blacktop)
• 823fed5: fix: brew x86 extras libheif import (@blacktop)
• 3071fd6: fix: file close issue in ipsw kernel kext cmd #775 (@blacktop)
• 4e59708: fix: handle older device-trees that don't have a time-stamp #772 (@blacktop)
• 514a3f6: fix: iOS build using simulator as platform (@blacktop)
• 01275cf: fix: if only 1 arch auto select it in OpenFatMachOWithConfig (@blacktop)
• 8216228: fix: json_mini to be posix-compliant (@blacktop)
• 4b39da5: fix: macho helper closing file early #775 (@blacktop)
• 957a758: fix: some lint errors (@blacktop)
• cd411b8: fix: update fcs-keys GH action's use of the watch cache JSON (@blacktop)
• eed6667: fix: use root cert with asset sets URL (@blacktop)

Documentation updates

• 4edc462: docs: refresh some docs (@blacktop)
• 88c4ffa: docs: update CLI docs (@blacktop)
• b50f0bb: docs: update CLI docs (@blacktop)

Other work

• d2e2e55: chore(fcs): bump fcs keys (@blacktop)
• 98fad5d: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 65ad8b1: chore(fcs-keys): update FCS keys (stable,RC,beta) [skip ci] (@github-actions[bot])
• 3f47372: chore(fcs-keys): update beta FCS keys (iOS: 22G5054d, macOS: 24F74, visionOS: ) [skip ci] (@github-actions[bot])
• 28b7a13: chore: add ipsw img4 validate and ipsw im4m personalize and verify + lzss Compress support (@blacktop)
• 1776766: chore: add ipsw img4 create cmds (@blacktop)
• d32f3e3: chore: add ability to print/extract im4p extra data #777 (@blacktop)
• 185387d: chore: img4 pkg refactor/cleanup (@blacktop)
• cc26b75: chore: improve ipsw img4 im4r command (@blacktop)
• c3333a2: chore: improve ipsw img4 info (@blacktop)
• 3fca987: chore: more ipsw img4 cmd fixes (@blacktop)
• c8a1e1a: chore: move img3 cmd from img4 to it's own group (@blacktop)
• 6a07e83: chore: some ipsw img4 sub-cmd reorg (@blacktop)
• 9817cde: chore: start to flesh out the rest ipsw img4 cmds (@blacktop)
• 9b6fe00: chore: update ota audiences (@blacktop)

Summary

Full Changelog: v3.1.616...v3.1.617

What to do next?

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

v3.1.616

Changelog

New Features

• d1f5ac8: feat: add ipsw img3 cmd to parse/decrypt img3 files (@blacktop)

Bug fixes

• 7ec6dfc: fix: attempt to fix ipsw class-dump --headers for the Virtualization framework #771 (@blacktop)

Dependency updates

• 8a06d60: chore(deps): bump google.golang.org/genai (@blacktop)

Summary

Full Changelog: v3.1.615...v3.1.616

What to do next?

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

v3.1.615

Changelog

Bug fixes

• b6f9048: fix: ipsw watch --pattern cache (@blacktop)
• 74e355a: fix: duplicate values in entitlement DB (@blacktop)
• f490a46: fix: fixed a few lint errors (@blacktop)

Documentation updates

• c573463: docs: many optimizations to decrease DB size and amount of queries to keep us in the supabase free tier 🤞 (@blacktop)

Other work

• 9cd42e3: chore: update frida (@blacktop)

Summary

Full Changelog: v3.1.614...v3.1.615

What to do next?

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

v3.1.614

Changelog

New Features

• 5e0e45f: feat: added --headers to swift-dump like in class-dump. (#754) (@elongl)

Bug fixes

• ad8e389: fix: broken entitlement DB (@blacktop)
• ca32bd1: fix: cache struct + entitlement db auto ingest (@blacktop)
• d7d0b7b: fix: macOS sucatalog #769 (@blacktop)
• 3a57ac0: fix: secret hidden ipsw apsctl cmd iOS build (@blacktop)

Dependency updates

• 052f1da: chore(deps): bump deps (@blacktop)

Documentation updates

• 0a911c0: docs: CORS! (@blacktop)
• 30f1dd6: docs: git lfs is a fail (@blacktop)
• beac6c4: docs: entitlement database - move from sql.js-httpvfs to hosted postgres (#770) (@blacktop)
• 33a6b87: docs: fix docs (@blacktop)
• d9ed200: docs: fix docs (@blacktop)
• c07b43b: docs: fix entitlements page (@blacktop)
• 9f4dc78: docs: fix github-pages to use git lfs (@blacktop)
• 9fe35af: docs: fix version drop down in entitlements db (@blacktop)
• a32498f: docs: this is a nightmare (@blacktop)
• 86dedbb: docs: update CLI docs (@blacktop)
• 9c7eb80: docs: update entitlements DB schema (@blacktop)
• e48a380: docs: update entitlements page to use new schema (@blacktop)

Other work

• 771d9eb: chore(ents): update to https://updates.cdn-apple.com/2025SpringFCS/fullrestores/082-45783/9A345601-C46E-4195-A367-4BCA31447055/iPhone17,1_18.5_22F76_Restore.ipsw [skip ci] (@github-actions[bot])
• 9cf9e01: chore(ents): update to https://updates.cdn-apple.com/2025SpringFCS/fullrestores/082-45783/9A345601-C46E-4195-A367-4BCA31447055/iPhone17,1_18.5_22F76_Restore.ipsw [skip ci] (@github-actions[bot])
• b8c2166: chore: rm old sqlite db (@blacktop)
• 8af4753: chore: update entitlements DB code to decrease the size of the DB (@blacktop)

Summary

Full Changelog: v3.1.613...v3.1.614

What to do next?

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