dcarrero/mboxshellmboxShell. Visor de terminal rápido para archivos MBOX de cualquier tamaño. Abre, busca y exporta correos electrónicos de copias de seguridad de Gmail Takeout (50 GB+) sin cargarlos en la memoria. Construido en Rust.
Visor rapido de terminal para archivos MBOX de cualquier tamano. Abre, busca y exporta correos de backups Gmail Takeout (50 GB+) sin cargarlos en memoria.
Cuando exportas tu correo de Gmail con Google Takeout, recibes uno o varios archivos .mbox que pueden pesar decenas de gigabytes. No existe una herramienta de terminal multiplataforma que permita abrir, buscar y consultar esos archivos de forma eficiente sin cargarlos enteros en memoria.
mboxShell nacio para resolver ese problema: abrir un MBOX de 50 GB en segundos, navegar entre cientos de miles de mensajes con fluidez, buscar por remitente, fecha o contenido, y exportar lo que necesites. Todo desde la terminal, sin interfaz grafica, sin servidor, sin dependencias externas.
Si prefieres una experiencia grafica nativa en macOS, echa un vistazo a mboxViewer — una app nativa para Mac creada por el mismo equipo. Ofrece una interfaz de buzon de correo familiar para abrir, explorar y buscar archivos MBOX sin necesidad de importarlos en un cliente de correo. Arrastra tu archivo .mbox y tendras acceso instantaneo a todos tus mensajes, adjuntos y etiquetas en una ventana nativa de macOS. Ideal para quienes quieren la potencia del motor de parsing de mboxShell con la comodidad de una interfaz de escritorio.
¿Solo necesitas echar un vistazo a un archivo MBOX sin instalar nada? Prueba Online Mbox Viewer — una app web gratuita y con licencia MIT del mismo autor. Abre y muestra archivos .mbox por completo en tu navegador: no se sube nada a ningun servidor, asi que tu correo nunca sale de tu equipo. Perfecto para una consulta rapida desde cualquier dispositivo. Codigo fuente en github.com/dcarrero/online-mbox-viewer.
.mboxshell.idx) que permite abrir el archivo en menos de un segundo en sucesivas ejecuciones.X-Gmail-Labels como carpetas virtuales en un panel lateral, permitiendo filtrar por Inbox, Sent, Starred, etiquetas personalizadas, etc.encoding_rs.from:, subject:, date:, body:, has:attachment, label:, etc.), rangos de fechas, tamano, operadores AND/OR y negacion.Descarga la ultima version para tu plataforma desde la pagina de Releases:
| Plataforma | Binario |
|---|---|
| Linux x86_64 | mboxshell-linux-x86_64 |
| Linux ARM64 | mboxshell-linux-aarch64 |
| Linux RISC-V 64 | mboxshell-linux-riscv64 |
| FreeBSD x86_64 | mboxshell-freebsd-x86_64 |
| macOS Intel | mboxshell-macos-x86_64 |
| macOS Apple Silicon | mboxshell-macos-aarch64 |
| Windows x86_64 | mboxshell-windows-x86_64.exe |
| Windows ARM64 | mboxshell-windows-arm64.exe |
Tras descargar, dale permisos de ejecucion y muevelo a tu PATH:
# Linux / macOS
chmod +x mboxshell-*
sudo mv mboxshell-* /usr/local/bin/mboxshell
# O colocalo en un directorio local de usuario
mv mboxshell-* ~/.local/bin/mboxshell
En Windows, mueve mboxshell-windows-x86_64.exe a una carpeta en tu PATH, o ejecutalo directamente.
Requisitos: Rust 1.85 o superior.
# Clonar y compilar
git clone https://github.com/dcarrero/mboxshell.git
cd mboxshell
cargo build --release
# El binario esta en target/release/mboxshell
# Instalar a nivel de sistema:
sudo cp target/release/mboxshell /usr/local/bin/
# O solo para el usuario actual:
cp target/release/mboxshell ~/.local/bin/
# Anadir el target que necesites
rustup target add aarch64-apple-darwin # macOS Apple Silicon
rustup target add x86_64-unknown-linux-gnu # Linux x86_64
rustup target add aarch64-unknown-linux-gnu # Linux ARM64
# Compilar para un target especifico
cargo build --release --target aarch64-apple-darwin
cargo install --git https://github.com/dcarrero/mboxshell.git
# Abrir un archivo MBOX en la interfaz de terminal
mboxshell correo.mbox
# Indexar y ver estadisticas
mboxshell index correo.mbox
mboxshell stats correo.mbox
# Buscar mensajes desde la linea de comandos
mboxshell search correo.mbox "from:[email protected] date:2024"
mboxshell search correo.mbox "has:attachment subject:factura" --json
# Exportar mensajes
mboxshell export correo.mbox --format eml --output ./emails/
mboxshell export correo.mbox --format csv --output resumen.csv
# Extraer adjuntos
mboxshell attachments correo.mbox --output ./adjuntos/
# Combinar varios MBOX eliminando duplicados
mboxshell merge archivo1.mbox archivo2.mbox -o combinado.mbox --dedup
# Generar completions para tu shell
mboxshell completions bash > /etc/bash_completion.d/mboxshell
mboxshell completions zsh > ~/.zfunc/_mboxshell
mboxshell completions fish > ~/.config/fish/completions/mboxshell.fish
| Comando | Descripcion |
|---|---|
mboxshell [ARCHIVO] | Abrir en la interfaz de terminal (accion por defecto) |
mboxshell open <ruta> | Abrir un fichero MBOX en la TUI |
mboxshell index <ruta> [-f/--force] | Construir o reconstruir el indice binario |
mboxshell stats <ruta> [--json] | Mostrar estadisticas de un archivo MBOX |
mboxshell search <ruta> <consulta> [--json] | Buscar mensajes desde la linea de comandos |
mboxshell export <ruta> -f <formato> -o <salida> [--query <q>] | Exportar mensajes (formatos: eml, csv, txt, html) |
mboxshell merge <archivos...> -o <salida> [--dedup] | Combinar varios archivos MBOX en uno |
mboxshell attachments <ruta> -o <salida> | Extraer todos los adjuntos |
mboxshell completions <shell> | Generar completions de shell (bash, zsh, fish, powershell, elvish) |
mboxshell manpage | Generar pagina de manual |
Flags globales: