Skip to content
KitploitKITPLOIT
HerramientasBlog
Enviar
HerramientasBlog
Enviar

¡Herramientas de Hacking, PenTest y Ciberseguridad para tu Arsenal de Seguridad!

Kitploit es un directorio de herramientas de hacking, ciberseguridad y pentesting. Descubre las últimas actualizaciones de proyectos para encontrar vulnerabilidades, analizar sistemas, automatizar pruebas y fortalecer tu seguridad.

··Feeds·Contacto·Privacidad·© 2026 Kitploit

Directorio de Herramientas

Categorías

Ver todas las categorías
Loading categories
mboxshell — mboxShell. 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. | Kitploit
Herramientas/GitHubGitHub/dcarrero/mboxshell
Utilidades de Propósito GeneralScripting y AutomatizaciónAnálisis ForenseRecopilación de InformaciónRecuperación de DatosForensia DigitalSeguridad de Correo Electrónico
GitHubdcarrero/mboxshell

mboxshell

mboxShell. 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.

Ver Repositorio
314hace 12 díasRevisado por Kitploit

Más Populares

Ver todos →

Descubre las herramientas más usadas por nuestra comunidad.

Explora todas las herramientas

Explora nuestra colección de herramientas

Ver todas las herramientas →
Compartir
Sitio web

mboxShell

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.

License: MIT Rust

Read in English


Por que existe este proyecto

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.

Casos de uso

  • Consultar backups de Gmail (Google Takeout) con sus etiquetas originales
  • Analizar archivos de correo en servidores, migraciones o auditorias
  • Buscar mensajes en archivos MBOX de cualquier origen (Thunderbird, servidores Unix, etc.)
  • Exportar mensajes a EML, CSV o texto plano para procesamiento posterior
  • Extraer adjuntos de forma masiva o individual
  • Combinar varios MBOX en uno solo, eliminando duplicados

Tambien en Mac: mboxViewer

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.

Tambien en el navegador: Online Mbox Viewer

¿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.

Caracteristicas

  • No carga el archivo en memoria. Usa lectura streaming con buffer de 1 MB. Un MBOX de 100 GB consume los mismos ~500 MB de RAM que uno de 1 GB (solo el indice de metadatos vive en memoria).
  • Indexacion persistente. La primera apertura crea un indice binario (.mboxshell.idx) que permite abrir el archivo en menos de un segundo en sucesivas ejecuciones.
  • Soporte completo de Gmail. Detecta y muestra las etiquetas de X-Gmail-Labels como carpetas virtuales en un panel lateral, permitiendo filtrar por Inbox, Sent, Starred, etiquetas personalizadas, etc.
  • Codificaciones correctas. Decodifica encoded-words (RFC 2047), soporta UTF-8, ISO-8859-1, Windows-1252, KOI8-R y cualquier charset reconocido por encoding_rs.
  • Vista de conversaciones. Agrupa mensajes en hilos usando el algoritmo JWZ (el mismo que usaba Netscape/Mozilla).
  • Busqueda avanzada. Filtrado por campo (from:, subject:, date:, body:, has:attachment, label:, etc.), rangos de fechas, tamano, operadores AND/OR y negacion.
  • Exportacion flexible. Mensajes individuales o en masa a EML, CSV (compatible Excel), texto plano. Extraccion de adjuntos decodificados.

Instalacion

Binarios precompilados (recomendado)

Descarga la ultima version para tu plataforma desde la pagina de Releases:

Tras descargar, dale permisos de ejecucion y muevelo a tu PATH:

root@kitploit:~
# 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.

Compilar desde el codigo fuente

Requisitos: Rust 1.85 o superior.

root@kitploit:~
# 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/

Compilacion cruzada para otras plataformas

root@kitploit:~
# 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

Instalar via Cargo

root@kitploit:~
cargo install --git https://github.com/dcarrero/mboxshell.git

Uso rapido

root@kitploit:~
# 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

Comandos CLI

Flags globales:

FlagDescripcion
-f, --forceForzar reconstruccion del indice aunque exista
-v, --verbose

Interfaz de terminal

Captura de mboxShell

Atajos de teclado

Sintaxis de busqueda

root@kitploit:~
from:[email protected]              Buscar por remitente
to:[email protected]              Buscar por destinatario
cc:[email protected]                Buscar por destinatario en copia (Cc)
subject:factura                     Buscar en el asunto
body:texto importante               Buscar en el cuerpo del mensaje
filename:informe.pdf                Buscar por nombre de adjunto
id:<message-id@dominio>             Buscar por Message-ID
has:attachment                      Solo mensajes con adjuntos
has:no-attachment                   Solo mensajes sin adjuntos
label:Inbox                         Filtrar por etiqueta de Gmail
date:2024-01                        Mensajes de enero 2024
date:2024-01-01..2024-06-30         Rango de fechas
before:2024-06-01                   Antes de una fecha
after:2024-01-01                    Despues de una fecha
size:>1mb                           Mensajes de mas de 1 MB
-subject:spam                       Excluir mensajes con "spam"
"frase exacta"                      Buscar frase completa
from:juan subject:presupuesto       AND implicito (ambos deben coincidir)
term1 OR term2                      OR explicito

Formatos de entrada soportados

FormatoExtensionDescripcion
MBOX (mboxrd/mboxo).mboxFormato estandar. Google Takeout, Thunderbird, servidores Unix

Rendimiento

Probado con archivos MBOX reales de Google Takeout:

La navegacion por la lista de mensajes es instantanea gracias al virtual scrolling (solo se renderizan las filas visibles).

Configuracion

El archivo de configuracion se ubica en ~/.config/mboxshell/config.toml:

root@kitploit:~
[general]
default_sort = "date"
sort_order = "desc"
date_format = "%Y-%m-%d %H:%M"
log_level = "warn"

[display]
theme = "dark"
layout = "horizontal"
show_sidebar = false
max_cached_messages = 50

[export]
default_format = "eml"
csv_separator = ","

Arquitectura

root@kitploit:~
src/
+-- main.rs              # CLI con clap
+-- lib.rs               # Re-exporta modulos
+-- error.rs             # Tipos de error con thiserror
+-- config.rs            # Configuracion TOML
+-- i18n/                # Internacionalizacion (EN/ES)
+-- parser/
|   +-- mbox.rs          # Parser streaming (nunca carga el archivo en memoria)
|   +-- eml.rs           # Parser de archivos EML individuales
|   +-- mime.rs          # Decodificacion MIME, multipart, charsets
|   +-- header.rs        # Headers RFC 5322, encoded-words RFC 2047
+-- index/
|   +-- builder.rs       # Construccion del indice binario
|   +-- reader.rs        # Consulta del indice
|   +-- format.rs        # Formato binario con verificacion SHA-256
+-- model/
|   +-- mail.rs          # MailEntry, MailBody
|   +-- attachment.rs    # Metadatos de adjuntos
|   +-- address.rs       # Parsing de direcciones RFC 5322
+-- store/
|   +-- reader.rs        # Lectura por offset con cache LRU
+-- search/
|   +-- query.rs         # Parser de queries de busqueda
|   +-- metadata.rs      # Busqueda rapida en indice (O(n), < 200ms para 1M msgs)
|   +-- fulltext.rs      # Busqueda full-text streaming
+-- export/
|   +-- eml.rs           # Exportar a .eml
|   +-- csv.rs           # Exportar resumen a CSV (UTF-8 BOM)
|   +-- text.rs          # Exportar a texto plano
|   +-- attachment.rs    # Extraccion de adjuntos
|   +-- mbox.rs          # Merge de MBOX con deduplicacion
+-- tui/
    +-- app.rs           # Estado global (Elm Architecture)
    +-- event.rs         # Manejo de eventos de teclado
    +-- ui.rs            # Layout y dispatch de renderizado
    +-- threading.rs     # Algoritmo JWZ para hilos de conversacion
    +-- theme.rs         # Tema de colores
    +-- widgets/         # Componentes visuales
        +-- mail_list.rs       # Lista con virtual scrolling
        +-- mail_view.rs       # Visor de mensaje con scroll
        +-- sidebar.rs         # Panel de etiquetas/carpetas
        +-- header_bar.rs      # Barra superior
        +-- status_bar.rs      # Barra de estado
        +-- search_bar.rs      # Barra de busqueda
        +-- search_popup.rs    # Popup de filtros de busqueda
        +-- help_popup.rs      # Popup de ayuda
        +-- attachment_popup.rs # Popup de adjuntos
        +-- export_popup.rs     # Popup de exportacion

Dependencias principales

Patrocinadores

mboxshell se desarrolla en abierto y cuenta con el apoyo de:

Colorvivo      Stackscale

  • Colorvivo — expertos en WordPress, IA y medios de comunicación.
  • Stackscale — expertos en infraestructura cloud privado.

Si tu empresa usa mboxshell y quiere apoyar su desarrollo, consulta .github/FUNDING.yml o escribe a través de carrero.es.

Documentación

El manual de usuario completo cubre todos los comandos, atajos de teclado, operadores de búsqueda, opciones de exportación y claves de configuración:

  • docs/MANUAL-ES.md — Manual de usuario (Español)
  • docs/MANUAL.md — User manual (English)

Changelog

Consulta CHANGELOG-ES.md (English: CHANGELOG.md) para el historial completo de versiones.

Licencia

MIT - Copyright (c) 2026 David Carrero Fernandez-Baillo - https://carrero.es

Codigo fuente: https://github.com/dcarrero/mboxshell

Descargar herramienta
  • Binario unico. Sin runtime, sin dependencias. Un ejecutable de ~5 MB que funciona en Linux, macOS y Windows.
  • Interfaz de terminal completa. Navegacion con teclado (estilo vi), tres modos de layout, barra de busqueda interactiva, atajos configurables.
  • Bilingue. Interfaz disponible en ingles y espanol, deteccion automatica del idioma del sistema.
  • PlataformaBinario
    Linux x86_64mboxshell-linux-x86_64
    Linux ARM64mboxshell-linux-aarch64
    Linux RISC-V 64mboxshell-linux-riscv64
    FreeBSD x86_64mboxshell-freebsd-x86_64
    macOS Intelmboxshell-macos-x86_64
    macOS Apple Siliconmboxshell-macos-aarch64
    Windows x86_64mboxshell-windows-x86_64.exe
    Windows ARM64mboxshell-windows-arm64.exe
    ComandoDescripcion
    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 manpageGenerar pagina de manual
    Aumentar verbosidad del log (-v info, -vv debug, -vvv trace)
    --lang <en|es>Forzar idioma de la interfaz (auto-detectado por defecto)
    TeclaAccion
    j / kMensaje siguiente / anterior
    g / GPrimer / ultimo mensaje
    PgDn / PgUpPagina abajo / arriba
    EnterAbrir mensaje / cambiar a vista de mensaje
    Shift-↑ / Shift-↓Scroll del cuerpo del mensaje (mantiene foco en lista); un indicador de posición (Inicio / NN% / Fin) aparece en el borde del mensaje
    Tab / Shift-TabCambiar panel
    EscVolver a la lista / cerrar popup
    /Abrir barra de busqueda
    fAbrir popup de filtros de busqueda
    n / NSiguiente / anterior resultado de busqueda
    SpaceMarcar / desmarcar mensaje
    *Marcar / desmarcar todos
    sCambiar columna de ordenacion (Fecha, De, Asunto, Tamano)
    SInvertir direccion de ordenacion
    eExportar mensaje (EML, TXT, CSV, Adjuntos)
    aVer adjuntos (j/k para navegar, Enter para guardar, A para guardar todos)
    tAlternar vista de conversaciones (threads)
    lMostrar / enfocar / ocultar panel de etiquetas
    hMostrar todos los headers
    rMostrar mensaje en formato raw
    1 / 2 / 3Layout: solo lista / horizontal / vertical
    ?Ayuda
    qSalir
    Tamano del archivoMensajesIndexacionRe-apertura
    500 MB~5.000~3 s< 1 s
    5 GB~50.000~30 s< 1 s
    50 GB~500.000~5 min< 1 s
    CrateUso
    ratatui + crosstermInterfaz de terminal
    mail-parserParsing MIME/RFC 5322
    encoding_rsDecodificacion de charsets
    chronoFechas y zonas horarias
    clapLinea de comandos
    serde + bincodeSerializacion del indice
    sha2Integridad del indice
    lruCache de mensajes decodificados
    tracingLogging estructurado