#### Plattformübergreifender Build```bash
# For Windows (standard build, no Chromium 127+ ABE cookie support)
GOOS=windows GOARCH=amd64 go build ./cmd/hack-browser-data/

# For Linux
GOOS=linux GOARCH=amd64 go build ./cmd/hack-browser-data/

Die resultierende `hack-browser-data.exe` enthält vollständige ABE-Cookie-Entschlüsselung auf Chromium 127+.

## Verwendung```
$ hack-browser-data -h
hack-browser-data decrypts and exports browser data from Chromium-based
browsers and Firefox on Windows, macOS, and Linux.

GitHub: https://github.com/moonD4rk/HackBrowserData

Usage:
  hack-browser-data [flags]
  hack-browser-data [command]

Available Commands:
  archive     Pack decryption-relevant profile files into a zip for cross-host restore
  dump        Extract and decrypt browser data (default command)
  dumpkeys    Export Chromium master keys as JSON for cross-host decryption
  help        Help about any command
  list        List detected browsers and profiles
  restore     Decrypt copied profile data using exported master keys
  version     Print version information

Flags:
  -b, --browser string        target browser: all|chrome|firefox|edge|... (default "all")
  -c, --category string       data categories (comma-separated): all|password,cookie,... (default "all")
  -d, --dir string            output directory (default "results")
  -f, --format string         output format: csv|json|cookie-editor (default "json")
  -h, --help                  help for hack-browser-data
      --keychain-pw string    macOS keychain password
  -p, --profile-path string   custom profile dir path, get with chrome://version
  -v, --verbose               enable debug logging
      --zip                   compress output to zip

Use "hack-browser-data [command] --help" for more information about a command.

> `keys.json` enthält die Master-Schlüssel im Klartext — behandeln Sie sie wie ein Geheimnis. `dumpkeys -o` schreibt sie mit Berechtigungen `0600`; ziehen Sie das Streamen über einen sicheren Kanal vor, anstatt sie auf der Festplatte zu belassen.

#### `dumpkeys` – Master-Schlüssel für die entschlüsselung auf anderen Rechnern exportieren

Leitet die Master-Schlüssel jeder Chromium-Installation auf dem Ursprungsrechner ab und schreibt sie als JSON (Firefox / Safari haben keinen portablen Schlüssel und werden übersprungen). Standardmäßig wird nach stdout ausgegeben, damit es über SSH weitergeleitet werden kann.

| Flag            | Short | Default  | Description                                     |
|-----------------|-------|----------|-------------------------------------------------|
| `--browser`     | `-b`  | `all`    | Zielbrowser (all\|chrome\|edge\|...)         |
| `--output`      | `-o`  | *stdout* | Ausgabedatei (geschrieben mit `0600`); stdout, wenn weggelassen |
| `--keychain-pw` |       |          | macOS-Schlüsselbund-Passwort                         |

#### `archive` – Verschlüsselungsrelevante Dateien für den Transport packen

Sammelt nur die Dateien, die eine Wiederherstellung tatsächlich benötigt (Cookies, Anmeldedaten, Verlauf, …) über denselben Umgehungsmechanismus für gesperrte Dateien, der auch bei der Extraktion verwendet wird, sodass aktive SQLite-Dateien unter Windows sicher gelesen werden können. Das Zip-Archiv ist als `<browser-key>/<User Data layout>` strukturiert, sodass ein Archiv mehrere Browser enthalten kann und die Wiederherstellung eindeutig bleibt. Eintragsnamen verwenden immer Schrägstriche, sodass ein unter Windows erstelltes Archiv unter macOS / Linux wiederhergestellt werden kann.

| Flag         | Short | Default            | Description                             |
|--------------|-------|--------------------|-----------------------------------------|
| `--browser`  | `-b`  | `all`              | Zielbrowser (all\|chrome\|edge\|...) |
| `--category` | `-c`  | `all`              | Datenkategorien, durch Kommas getrennt        |
| `--output`   | `-o`  | `browser-data.zip` | Ausgabepfad des Archivs                     |

#### `restore` – Kopierte Daten mit exportierten Schlüsseln entschlüsseln

Stellt jede Chromium-Engine direkt aus `keys.json` wieder her und entschlüsselt die bereitgestellten Daten – es konsultiert niemals die lokale Browsertabelle des Analysten, daher **sind die Browser, die Sie wiederherstellen können, genau die Tresore in Ihrer `keys.json`**. Stellen Sie die Daten auf eine von zwei Arten bereit (genau eine ist erforderlich):

- `--data-zip` – ein von `archive` erstelltes Zip-Archiv; wird in ein temporäres Verzeichnis extrahiert und danach entfernt.
- `--data-dir` – ein Verzeichnis. Entweder das `archive`-Layout (`<browser-key>/...`, mehrere Browser auf einmal) oder das manuell kopierte `User Data`-Wurzelverzeichnis eines Browsers, was nur für einen einzelnen Browser eindeutig ist – daher kombinieren Sie es mit `-b`.

`-b` ist ein **optionaler Filter** über die Tresore des Dumps, kein erforderlicher Selektor.

| Flag         | Short | Default    | Description                                                |
|--------------|-------|------------|------------------------------------------------------------|
| `--keys`     |       | *required* | Schlüsseldatei von `dumpkeys` (verwenden Sie `-` für stdin)              |
| `--data-zip` |       |            | Zip-Archiv von `archive` (gegenseitig ausschließend mit `--data-dir`)  |
| `--data-dir` |       |            | Kopiertes Datenverzeichnis (gegenseitig ausschließend mit `--data-zip`)     |
| `--browser`  | `-b`  |            | Nur diesen Browser wiederherstellen; muss einem Tresor in `--keys` entsprechen  |
| `--category` | `-c`  | `all`      | Datenkategorien, durch Kommas getrennt                           |
| `--format`   | `-f`  | `json`     | Ausgabeformat (csv\|json\|cookie-editor)                   |
| `--dir`      | `-d`  | `results`  | Ausgabeverzeichnis                                           |
| `--zip`      |       | `false`    | Ausgabe in Zip komprimieren                                     |

#### Beispiele für rechnerübergreifende Nutzung```bash
# Stream keys over SSH (no keys.json on disk), data copied separately
ssh origin "hack-browser-data dumpkeys" | \
  hack-browser-data restore --keys - --data-zip browser-data.zip

# Restore one browser from a hand-copied User Data folder (no archive)
hack-browser-data restore --keys keys.json --data-dir ./chrome-userdata -b chrome

### Globale Flags

| Flag        | Kurz | Beschreibung             |
|-------------|------|--------------------------|
| `--verbose` | `-v` | Debug-Logging aktivieren |

### Beispiele```bash
# Extract all data from all browsers (default)
hack-browser-data

# Extract specific browser and categories
hack-browser-data dump -b chrome -c password,cookie

# Export in CSV format to a custom directory (JSON is the default)
hack-browser-data dump -b chrome -f csv -d output

# Export cookies in CookieEditor format
hack-browser-data dump -f cookie-editor

# Compress output to zip
hack-browser-data dump --zip

# List detected browsers and profiles
hack-browser-data list

# List with per-category entry counts
hack-browser-data list --detail

# Use custom profile path
hack-browser-data dump -b chrome -p "/path/to/User Data/Default"