# android-unlock-and-more-box

Open-Source-Werkzeugkasten für Android-Recovery (FRP, Bootloader-Tasks, NV-Reparatur).
Läuft auf jedem Linux-PC oder Pi 4 — der PC ist in der Regel die bessere Wahl
(schneller bei CRC, schneller bei Firmware-Dumps, mehr RAM). Pi 4 ist nett
wenn man ein dediziertes Werkstatt-Gerät will. Kein Voodoo, keine Wunder —
Aggregation öffentlicher Protokolle und Workflows.

## Status

Pre-Alpha. Aktueller Fokus: **Huawei P10 Lite (WAS-LX1, Kirin 658)** ohne
funktionierenden Bootloader-Unlock und ohne IMEI/NV.

Siehe [docs/huawei-p10-lite.md](docs/huawei-p10-lite.md).

## Was das hier ist — und was nicht

**Ist:**
- Lokale Web-UI (FastAPI, kein Build-Step, kein Node)
- Geräte-Erkennung über USB-VID:PID, live im Browser
- Datei-Browser sandboxed auf die Firmware-Library
- SQLite-Index der Firmware-Library mit Auto-Identifikation
  (Huawei `update.app` voll, MTK/Samsung als Stub)
- Wrapper um `adb`, `fastboot`, `pyusb`
- Implementierung des Kirin-Download-Mode-Protokolls (hisi-idt)
- Geräte-spezifische Workflows mit klaren Schritt-für-Schritt-Anweisungen
- Läuft auf jedem Linux-System: PC, Pi 4, Container

**Ist nicht:**
- Ersatz für Octopus/UnlockTool/Z3X — die Datenbanken und Loader-Sammlungen
  dort sind das eigentliche Asset. Hier baust du dir das selbst auf.
- Magic-Exploit-Sammlung. Wenn ein SoC keinen öffentlichen BROM-Bypass hat
  (z.B. Kirin 658), braucht es leider Hersteller-Loader, die du selbst
  beschaffen musst (siehe `loaders/README.md`).

## Zwei Wege zum Start

### A) Nativ (einfachste Variante)

Funktioniert auf Debian/Ubuntu/Mint/Pi OS gleichermaßen.

```bash
sudo bash scripts/setup-linux.sh   # einmalig: Pakete + udev + venv
source .venv/bin/activate
python -m aubox detect
python -m aubox p10lite frp-remove --method erecovery
```

### B) Web-UI im Container  (empfohlen)

```bash
sudo bash scripts/setup-linux.sh   # udev-Regeln müssen auf dem Host liegen
docker compose up -d
```

Browser auf <http://127.0.0.1:8080>. Fertig. Smartphone per USB anstecken,
Geräte-Seite zeigt es live mit dem erkannten Modus.

Was die Compose-Datei macht:
- `./firmware` ↔ `/firmware` (read-write, hier liegt deine Firmware-Library + SQLite-Index)
- `./loaders` ↔ `/loaders` (read-only, Hersteller-Loader)
- `/dev/bus/usb` ↔ `/dev/bus/usb` (komplett, damit Re-Enumeration funktioniert)
- Port 8080 nur an 127.0.0.1 gebunden — nichts geht ins LAN raus

### C) Container per Wrapper-Script (für CLI-Nutzung)

```bash
./scripts/run-docker.sh detect
./scripts/run-docker.sh p10lite frp-remove --method dload-erase
```

### PC vs. Pi 4 — kurze Entscheidungshilfe

| Kriterium               | Linux-PC           | Pi 4                       |
|-------------------------|--------------------|----------------------------|
| Geschwindigkeit         | viel schneller     | ok                         |
| Firmware-Dumps (>4 GB)  | spürbar besser     | langsam (USB shared)       |
| Dediziertes Werkstatt-Gerät | nein           | ja, kann immer laufen      |
| Strom/Mobilität         | schlechter         | besser                     |
| USB-3-Bandbreite        | volles xHCI        | ~250 MB/s effektiv         |

## Lizenz

Privat, noch nicht entschieden.