Skip to main content

extraire

Actions Status Code style: black License: 0BSD Supported Python versions: 3.6.2, 3.7, 3.8, 3.9, 3.10

extraire (verb): to extract

Simple program to dump onboard SHSH blobs with a valid generator for jailbroken iOS devices. Supports Windows, macOS and Linux.

What's this?

This program dumps the IMG4 ApTicket from /dev/disk1 on the device, copies it to your computer and converts it to a valid SHSH blob, no external dependencies required.

Even though the dumped SHSH blob is valid, you will still be limited by a few factors:

  • SEP/Baseband/Rose firmware compatibility with the currently signed iOS version
  • If you've updated to your current iOS version with the Settings app, you cannot use the dumped blob without a bootROM exploit (e.g. checkm8).

Requirements

OpenSSH Server installed on your jailbroken device. That's it!

Installation

From PyPI

pip install -U extraire

Standalone binaries

Standalone binaries for Windows, macOS and Linux can be found here.

You will need to allow executable permission for macOS and Linux after downloading. Run chmod +x /path/to/extraire in a terminal (replace /path/to/extraire with the actual path).

Usage

Run extraire only for an interactive guide.

❯ extraire --help
usage: extraire [-h] [-p PASSWORD] [-o OUTPUT] [--non-interactive] [HOST[:PORT]]

positional arguments:
  HOST[:PORT]           The device's IP address

optional arguments:
  -h, --help            show this help message and exit
  -p PASSWORD, --password PASSWORD
                        The device's root user password
  -o OUTPUT, --output OUTPUT
                        Where to save the dumped blob
  --non-interactive     Don't interactively ask for missing value (assume default if missing)

Running/building from source

Clone this repo, install the dependencies with poetry install or pip install ., and run python3 -m extraire

To build a wheel, do poetry build.

Credits

tihmstar: without his img4tool code I wouldn't be able to write code for dealing with IMG4s in Python.

Release files for extraire 0.1.4.post1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for extraire 0.1.4.post1
File Size Uploaded
extraire-0.1.4.post1.tar.gz 6.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for extraire 0.1.4.post1
File Interpreter ABI Platform
extraire-0.1.4.post1-py3-none-any.whl Python 3 none any Details

Total release size: 13.4 kB

Release files / extraire-0.1.4.post1.tar.gz

Download URL extraire-0.1.4.post1.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
024e22784557193c71a1e3083b3292b6121c97b78b0dbc39b57877820ab0a143
BLAKE2b-256 checksum
How to use checksums
829940d30f800c6631a5f9f9b7b4a1396236bcb2cd500b9a5b3a43a97b2a7c5d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.2.0 keyring/23.4.1 rfc3986/1.5.0 colorama/0.4.4 CPython/3.9.9

Release files / extraire-0.1.4.post1-py3-none-any.whl

Download URL extraire-0.1.4.post1-py3-none-any.whl
Size 7.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
af1b6c37bc909e77ebb903fff5cb00dcd3fb590245d03f984a8d252c244500c4
BLAKE2b-256 checksum
How to use checksums
2d1faf14de40b52a44a05b1aceed5a47754609cd971dd79efe1fd3897b1819ed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.2.0 keyring/23.4.1 rfc3986/1.5.0 colorama/0.4.4 CPython/3.9.9

Release history Release notifications | RSS feed

This release

0.1.4.post1 This release

2 release files

0.1.4

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page