Shadow

A modern jailbreak detection bypass.

If Shadow is useful to you, consider sponsoring or buying me a coffee.

Install

Add https://ios.jjolano.me to your package manager and install me.jjolano.shadow. Or grab the latest release.

Needs AltList + libSandy (opa334) and HookKit >= 3.0.4 (jjolano; >= 2.5.0 on rootful legacy). Injection Foundation (PoomSmart) recommended.

Use

Settings app → Shadow → global defaults or per-app config. shdw -d keeps the app ruleset in sync.

Compatibility

Package	iOS
Rootful legacy (iphoneos-arm)	9–13
Rootful modern (iphoneos-arm)	14+
Rootless (iphoneos-arm64)	15+
RootHide (iphoneos-arm64e)	15–17

No guarantee every app/detection SDK works everywhere.

These are declared package ranges, not a device-tested version matrix. CI builds all four lanes and checks package metadata and Mach-O compatibility; public host tests do not verify hook installation or behavior on each iOS version. An open-ended range does not establish compatibility with future releases.

Troubleshooting

• Disable other tweaks per-app (Choicy).
• Downgrade the app; don't stack multiple bypass tweaks.
• Rootless/semi-untethered: test in stock jailed state to isolate.

Building

Requires Theos. One lane at a time:

.github/scripts/build-deps.sh rootful-modern
./build.sh rootful-modern

Lanes: rootful-legacy, rootful-modern, rootless, roothide. See build-support/lanes.sh for the matrix. Tests: make -C tests test (details).

Legal

Copyright Act, RSC 1985, c C-42, s 41.12.