jjolano/shadow

A jailbreak detection bypass for modern iOS jailbreaks.

Logos

1,082

1,129 commits

updated Sep 18, 2026

See the code

README

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

PackageiOS
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).

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

ios
jailbreak-detection
jailbreak-tweak
objective-c

jjolano/shadow

A jailbreak detection bypass for modern iOS jailbreaks.

Logos

1,082

1,129 commits

updated Sep 18, 2026

See the code

README

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

PackageiOS
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).

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

ios
jailbreak-detection
jailbreak-tweak
objective-c

Significant stargazers

Hayden Bleasel

1,552 followers · starred Jan 2024

Jeroen Beckers

154 followers · starred Apr 2024

HoJeong Go

225 followers · starred Mar 2023

Mobile Security

640 followers · starred Oct 2019