Skip to content
/ shadow Public

Repository files navigation

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.

About

A jailbreak detection bypass for modern iOS jailbreaks.

Topics

Resources

Stars

1.1k stars

Watchers

30 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages