#### Compilación multiplataforma```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/

El archivo `hack-browser-data.exe` resultante incluye el descifrado completo de cookies ABE en Chromium 127+.

## Uso```
$ 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 claves maestras en texto plano — trátalo como un secreto. `dumpkeys -o` lo escribe con permisos `0600`; prefiere transmitirlo por un canal seguro en lugar de dejarlo en el disco.

#### `dumpkeys` - Exportar claves maestras para descifrado entre hosts

Deriva las claves maestras de cada instalación de Chromium en el host de origen y las escribe como JSON (Firefox / Safari no tienen clave portátil y se omiten). Por defecto usa stdout para que pueda ser canalizado por SSH.

| Flag            | Short | Default  | Description                                     |
|-----------------|-------|----------|-------------------------------------------------|
| `--browser`     | `-b`  | `all`    | Navegador objetivo (all\|chrome\|edge\|...)     |
| `--output`      | `-o`  | *stdout* | Archivo de salida (escrito con `0600`); stdout si se omite |
| `--keychain-pw` |       |          | Contraseña del llavero de macOS                 |

#### `archive` - Empaquetar archivos relevantes para el descifrado para su transporte

Recolecta solo los archivos que una restauración realmente necesita (cookies, datos de inicio de sesión, historial, …) a través del mismo bypass de archivos bloqueados utilizado para la extracción, por lo que los archivos SQLite en vivo se leen de forma segura en Windows. El zip está organizado como `<browser-key>/<User Data layout>`, por lo que un archivo puede contener varios navegadores y la restauración permanece sin ambigüedades. Los nombres de las entradas siempre usan barra inclinada, por lo que un archivo producido en Windows se restaura en macOS / Linux.

| Flag         | Short | Default            | Description                             |
|--------------|-------|--------------------|-----------------------------------------|
| `--browser`  | `-b`  | `all`              | Navegador objetivo (all\|chrome\|edge\|...) |
| `--category` | `-c`  | `all`              | Categorías de datos, separadas por comas |
| `--output`   | `-o`  | `browser-data.zip` | Ruta del archivo de salida              |

#### `restore` - Descifrar datos copiados con claves exportadas

Reconstruye cada motor Chromium directamente desde `keys.json` y descifra los datos suministrados — nunca consulta la tabla local del navegador del analista, por lo que **los navegadores que puedes restaurar son exactamente los cofres en tu `keys.json`**. Proporciona los datos de una de dos maneras (se requiere exactamente una):

- `--data-zip` — un zip producido por `archive`; se extrae a un directorio temporal y se elimina después.
- `--data-dir` — un directorio. Ya sea la estructura de `archive` (`<browser-key>/...`, varios navegadores a la vez), o la raíz `User Data` copiada manualmente de un navegador, que solo es inequívoca para un solo navegador — así que combínalo con `-b`.

`-b` es un **filtro opcional** sobre los cofres del volcado, no un selector obligatorio.

| Flag         | Short | Default    | Description                                                |
|--------------|-------|------------|------------------------------------------------------------|
| `--keys`     |       | *required* | Archivo de claves de `dumpkeys` (usa `-` para stdin)       |
| `--data-zip` |       |            | Zip de `archive` (excluyente mutuo con `--data-dir`)       |
| `--data-dir` |       |            | Directorio de datos copiados (excluyente mutuo con `--data-zip`) |
| `--browser`  | `-b`  |            | Restaurar solo este navegador; debe coincidir con un cofre en `--keys` |
| `--category` | `-c`  | `all`      | Categorías de datos, separadas por comas                   |
| `--format`   | `-f`  | `json`     | Formato de salida (csv\|json\|cookie-editor)               |
| `--dir`      | `-d`  | `results`  | Directorio de salida                                       |
| `--zip`      |       | `false`    | Comprimir salida a zip                                     |

#### Ejemplos entre hosts```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

### Banderas globales

| Bandera      | Corto | Descripción           |
|--------------|-------|-----------------------|
| `--verbose`  | `-v`  | Habilitar registro de depuración |

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