# i3t4an/libre-hacktivator_ios_12-16 architecture

> Architecture diagram of the GitHub repository i3t4an/libre-hacktivator_ios_12-16, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/i3t4an/libre-hacktivator_ios_12-16
- Repository: https://github.com/i3t4an/libre-hacktivator_ios_12-16

## Overview

LIBRE-HACKTIVATOR is a menu-driven iOS activation-lock bypass toolkit. The user selects a flow in `start.sh`: legacy iOS 12–14 options relay device connections and perform SSH/SFTP operations, while newer-device options use palera1n or OS-specific recovery and bypass helpers. The graph preserves the documented SIM, PHP activation, account cleanup, shell, jailbreak, and recovery branches. Relationships for unsampled subsystems follow README descriptions; the legacy helper-to-usbmux links are supported by the sampled Python excerpts and source index.

Main entry points: [`start.sh`](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/start.sh) (Menu launcher), [`source/scripts/usbmux.py`](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/usbmux.py) (USB device relay), [`source/scripts/phpbypass/var/www/crypt/RSA.php`](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/var/www/crypt/RSA.php) (RSA operations), [`source/scripts/php.py`](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/php.py) (PHP flow wrapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Menu entry"]
  node_launcher["Menu launcher<br/>[start.sh]"]
end

subgraph group_legacy["iOS 12–14 flows"]
  node_legacy_bypass["Legacy bypass<br/>[bypass.py]"]
  node_account_cleanup["Account cleanup"]
  node_root_shell["Interactive shell<br/>[shell.py]"]
  node_sim_transfer["SIM transfer<br/>[sim.py]"]
  node_device_relay["USB device relay<br/>[usbmux.py]"]
end

subgraph group_activation["PHP activation"]
  node_php_wrapper["PHP flow wrapper<br/>[php.py]"]
  node_php_server["Activation handler<br/>[activator.php]"]
  node_rsa["RSA operations<br/>[RSA.php]"]
  node_bigint["Big integers<br/>[BigInteger.php]"]
  node_hash["Hash operations<br/>[Hash.php]"]
  node_random["Random generation<br/>[Random.php]"]
end

subgraph group_modern["palera1n flows"]
  node_palera1n["Jailbreak flow<br/>[palera1n.sh]"]
  node_payloads["Boot payloads"]
end

subgraph group_device_tools["Device utilities"]
  node_device_bypass["Device bypass"]
  node_recovery_entry["Enter recovery"]
  node_recovery_exit["Exit recovery"]
end

node_user(("User"))
node_ios_device(("iOS device"))
node_activation_service(("Activation service"))

node_user -->|"selects flow"| node_launcher
node_launcher -->|"dispatches option"| node_legacy_bypass
node_launcher -->|"dispatches option"| node_php_wrapper
node_launcher -->|"dispatches option"| node_account_cleanup
node_launcher -->|"dispatches option"| node_root_shell
node_launcher -->|"dispatches option"| node_sim_transfer
node_launcher -->|"dispatches option"| node_palera1n
node_launcher -->|"dispatches option"| node_device_bypass
node_launcher -->|"dispatches option"| node_recovery_entry
node_launcher -->|"dispatches option"| node_recovery_exit
node_legacy_bypass -->|"connects through"| node_device_relay
node_account_cleanup -->|"connects through"| node_device_relay
node_root_shell -->|"connects through"| node_device_relay
node_sim_transfer -->|"connects through"| node_device_relay
node_php_wrapper -->|"connects through"| node_device_relay
node_php_wrapper -->|"starts activation flow"| node_php_server
node_php_server -->|"uses"| node_rsa
node_rsa -->|"uses"| node_bigint
node_rsa -->|"uses"| node_hash
node_rsa -->|"uses"| node_random
node_hash -->|"uses"| node_bigint
node_php_server -->|"activation request"| node_activation_service
node_palera1n -.->|"uses payload assets"| node_payloads
node_device_bypass -->|"patches device"| node_ios_device
node_recovery_entry -->|"enters recovery"| node_ios_device
node_recovery_exit -->|"exits recovery"| node_ios_device
node_device_relay -->|"relays connection"| node_ios_device

click node_launcher "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/start.sh"
click node_legacy_bypass "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/bypass.py"
click node_account_cleanup "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/remove_oldicloud.py"
click node_root_shell "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/shell.py"
click node_sim_transfer "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/sim.py"
click node_device_relay "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/usbmux.py"
click node_php_wrapper "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/php.py"
click node_php_server "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/activator.php"
click node_rsa "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/var/www/crypt/RSA.php"
click node_bigint "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/var/www/crypt/BigInteger.php"
click node_hash "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/var/www/crypt/Hash.php"
click node_random "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/var/www/crypt/Random.php"
click node_palera1n "https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/palera1n/palera1n.sh"
click node_payloads "https://github.com/i3t4an/libre-hacktivator_ios_12-16/tree/main/palera1n/other"
click node_device_bypass "https://github.com/i3t4an/libre-hacktivator_ios_12-16/tree/main/device"
click node_recovery_entry "https://github.com/i3t4an/libre-hacktivator_ios_12-16/tree/main/device"
click node_recovery_exit "https://github.com/i3t4an/libre-hacktivator_ios_12-16/tree/main/device"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_launcher,node_user toneBlue
class node_legacy_bypass,node_account_cleanup,node_root_shell,node_sim_transfer,node_device_relay toneAmber
class node_php_wrapper,node_php_server,node_rsa,node_bigint,node_hash,node_random toneMint
class node_palera1n,node_payloads toneRose
class node_device_bypass,node_recovery_entry,node_recovery_exit,node_ios_device,node_activation_service toneIndigo
```

## Components

### Menu entry

- [Menu launcher](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/start.sh): `start.sh`

### iOS 12–14 flows

- [Legacy bypass](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/bypass.py): `source/scripts/bypass.py`
- [Account cleanup](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/remove_oldicloud.py): `source/scripts/remove_oldicloud.py`
- [Interactive shell](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/shell.py): `source/scripts/shell.py`
- [SIM transfer](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/sim.py): `source/scripts/sim.py`
- [USB device relay](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/usbmux.py): `source/scripts/usbmux.py`

### PHP activation

- [PHP flow wrapper](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/php.py): `source/scripts/php.py`
- [Activation handler](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/activator.php): `source/scripts/phpbypass/activator.php`
- [RSA operations](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/var/www/crypt/RSA.php): `source/scripts/phpbypass/var/www/crypt/RSA.php`
- [Big integers](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/var/www/crypt/BigInteger.php): `source/scripts/phpbypass/var/www/crypt/BigInteger.php`
- [Hash operations](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/var/www/crypt/Hash.php): `source/scripts/phpbypass/var/www/crypt/Hash.php`
- [Random generation](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/source/scripts/phpbypass/var/www/crypt/Random.php): `source/scripts/phpbypass/var/www/crypt/Random.php`

### palera1n flows

- [Jailbreak flow](https://github.com/i3t4an/libre-hacktivator_ios_12-16/blob/main/palera1n/palera1n.sh): `palera1n/palera1n.sh`
- [Boot payloads](https://github.com/i3t4an/libre-hacktivator_ios_12-16/tree/main/palera1n/other): `palera1n/other`

### Device utilities

- [Device bypass](https://github.com/i3t4an/libre-hacktivator_ios_12-16/tree/main/device): `device`
- [Enter recovery](https://github.com/i3t4an/libre-hacktivator_ios_12-16/tree/main/device): `device`
- [Exit recovery](https://github.com/i3t4an/libre-hacktivator_ios_12-16/tree/main/device): `device`

### Other components

- **User**
- **iOS device**
- **Activation service**

## Connections

- User → Menu launcher: selects flow (evidence: `README.md`)
- Menu launcher → Legacy bypass: dispatches option (evidence: `README.md`)
- Menu launcher → PHP flow wrapper: dispatches option (evidence: `README.md`)
- Menu launcher → Account cleanup: dispatches option (evidence: `README.md`)
- Menu launcher → Interactive shell: dispatches option (evidence: `README.md`)
- Menu launcher → SIM transfer: dispatches option (evidence: `README.md`)
- Menu launcher → Jailbreak flow: dispatches option (evidence: `README.md`)
- Menu launcher → Device bypass: dispatches option (evidence: `README.md`)
- Menu launcher → Enter recovery: dispatches option (evidence: `README.md`)
- Menu launcher → Exit recovery: dispatches option (evidence: `README.md`)
- Legacy bypass → USB device relay: connects through (evidence: `source/scripts/bypass.py`)
- Account cleanup → USB device relay: connects through (evidence: `source/scripts/remove_oldicloud.py`)
- Interactive shell → USB device relay: connects through (evidence: `source/scripts/shell.py`)
- SIM transfer → USB device relay: connects through (evidence: `source/scripts/sim.py`)
- PHP flow wrapper → USB device relay: connects through (evidence: `source/scripts/php.py`)
- PHP flow wrapper → Activation handler: starts activation flow (evidence: `README.md`)
- Activation handler → RSA operations: uses (evidence: `source/scripts/phpbypass/activator.php`)
- RSA operations → Big integers: uses (evidence: `source/scripts/phpbypass/var/www/crypt/RSA.php`)
- RSA operations → Hash operations: uses (evidence: `source/scripts/phpbypass/var/www/crypt/RSA.php`)
- RSA operations → Random generation: uses (evidence: `source/scripts/phpbypass/var/www/crypt/RSA.php`)
- Hash operations → Big integers: uses (evidence: `source/scripts/phpbypass/var/www/crypt/Hash.php`)
- Activation handler → Activation service: activation request (evidence: `README.md`)
- Jailbreak flow → Boot payloads: uses payload assets
- Device bypass → iOS device: patches device (evidence: `README.md`)
- Enter recovery → iOS device: enters recovery (evidence: `README.md`)
- Exit recovery → iOS device: exits recovery (evidence: `README.md`)
- USB device relay → iOS device: relays connection (evidence: `README.md`)