Skip to content
Mbox Viewer Pro

mboxShell

La herramienta de terminal libre que hay detrás de Mbox Viewer. Abre, busca y exporta archivos MBOX de cualquier tamaño, directamente desde tu shell, en Linux, macOS, FreeBSD y Windows.

Última v1.0.0 Libre y de código abierto Escrito en Rust MIT
mboxshell
mboxShell ejecutándose en una terminal, mostrando un archivo MBOX con su lista de mensajes, carpetas y panel de lectura.

Un kit MBOX completo en tu terminal

Todo lo necesario para trabajar con enormes archivos de correo —leer, buscar, agrupar en hilos y exportar— sin interfaz gráfica y sin nube.

Cualquier tamaño

Un parser en streaming con buffer de 1 MB abre copias de Gmail Takeout de más de 50 GB manteniendo la RAM en torno a 500 MB.

Reapertura instantánea

Un índice binario persistente —verificado con SHA-256— reabre incluso el archivo más grande en menos de un segundo.

Búsqueda por campos

Filtra con from:, subject:, date:, body:, has:attachment y label:, además de frases exactas y un OR que agrupa alternativas: a OR b c se lee como (a OR b) AND c, en la TUI o desde la línea de comandos.

Etiquetas de Gmail y Google Groups

Detecta X-Gmail-Labels y las convierte en carpetas virtuales por las que navegar y filtrar. En un archivo de Google Takeout, cada buzón de Grupos aparece con el nombre de su grupo.

Hilos de conversación

Agrupa mensajes relacionados en conversaciones con el clásico algoritmo de hilos JWZ, y usa el identificador de conversación de Google (X-GM-THRID) cuando el buzón lo trae.

Exporta a donde quieras

Guarda mensajes como MBOX, Maildir, EML, CSV, TXT o HTML, y extrae adjuntos de uno en uno o en lote.

Fusiona y deduplica

Combina varios archivos MBOX en uno, con deduplicación opcional para no importar nada dos veces.

Interfaz de terminal completa

Una TUI basada en ratatui con tres modos de diseño, navegación estilo vi, temas oscuro, claro y sin colores, un cursor que los lectores de pantalla pueden seguir y autocompletado para bash, zsh, fish, PowerShell y elvish.

Multiplataforma y bilingüe

Un único binario de ~5 MB sin dependencias en tiempo de ejecución. Funciona en Linux, macOS, FreeBSD y Windows, con interfaz en inglés y español.

Novedades

Las tres últimas versiones. La más reciente, la v1.0.0, se publicó el 6 de octubre de 2026.

v1.0.0

6 de octubre de 2026

Primera versión estable, con un archivo de configuración que por fin funciona

  • Es la primera versión estable. A partir de ahora, la línea de comandos y el archivo de configuración siguen el versionado semántico (SemVer): cualquier cambio que los rompa llegará solo con una nueva versión mayor. 7 tests nuevos (308 en total).
  • Nuevo comando mboxshell config [path|show|defaults] (#40). path indica dónde está el archivo de configuración y si ya existe; show lo muestra con un aviso por cada valor que se ignora, y defaults imprime todas las opciones con su valor por defecto como un archivo comentado. No modifica nada y solo escribe en la salida estándar, así que basta con redirigir defaults a un archivo para tener un punto de partida.
  • La mayoría de las opciones del archivo de configuración no hacían nada: solo se leían el nivel de log, el tema y las dos opciones de adjuntos. Ahora funcionan default_sort, sort_order, date_format, layout, show_sidebar, max_cached_messages, csv_separator y cache_dir, y un valor no válido vuelve a su valor por defecto con un aviso en lugar de ignorarse en silencio. En macOS el archivo está en ~/Library/Application Support/mboxshell/config.toml, no en ~/.config/mboxshell como decía el README.
Notas de la versión v1.0.0

v0.9.0

5 de octubre de 2026

Exportaciones que casan con sus carpetas de adjuntos

  • export acepta ahora --dirname dts|seq-no|seq-no0 y --seq-width N, igual que attachments y con los mismos valores por defecto del archivo de configuración (#39). Con seq-no, cada archivo EML, TXT o HTML se llama como la carpeta de adjuntos de su mensaje —0007.html va con la carpeta 0007/—, así que es fácil emparejar cada correo exportado con sus adjuntos; las exportaciones TXT y HTML muestran además esa carpeta debajo de la lista de adjuntos. Con dts, la opción por defecto, los nombres no cambian.
  • En un buzón que empieza con una marca de orden de bytes UTF-8 (BOM), el primer mensaje se exportaba mal (#38): su archivo EML o Maildir perdía el asunto, y export --format mbox le ponía delante un separador duplicado. Ahora se descarta el BOM y el primer mensaje se exporta como cualquier otro. 7 tests nuevos (301 en total).
Notas de la versión v0.9.0

v0.8.2

4 de octubre de 2026

Se acabó el cierre al exportar nombres con tilde

  • Arregla un cierre inesperado al exportar mensajes cuyo asunto o remitente lleva una letra acentuada cerca del principio (#37). La comprobación de nombres reservados de Windows añadida en v0.8.0 cortaba el nombre en mitad de un carácter de varios bytes; afectaba a las exportaciones HTML, EML y de texto y a la extracción de adjuntos en todas las plataformas.
Notas de la versión v0.8.2
Ver el changelog completo

A un comando de distancia

mboxshell
$ mboxshell archive.mbox
# Abre la interfaz de terminal interactiva
$ mboxshell search archive.mbox "from:jane has:attachment"
# Busca directamente desde la línea de comandos
$ mboxshell export archive.mbox -f eml -o out/
# Exporta mensajes a MBOX, Maildir, EML, CSV, TXT o HTML
$ mboxshell merge a.mbox b.mbox -o all.mbox --source-header
# Fusiona archivos —los duplicados se eliminan por defecto (--no-dedup para conservarlos)— anotando de qué buzón venía cada mensaje
$ mboxshell attachments archive.mbox -o files/
# Extrae todos los adjuntos de una vez

Instálalo

Descarga un binario precompilado para Linux, macOS, FreeBSD o Windows desde la página de versiones, o compílalo tú mismo con Cargo:

$ cargo install --git https://github.com/dcarrero/mboxshell.git

El motor de código abierto que impulsa Mbox Viewer

Mbox Viewer para Mac y Windows nació de mboxShell. La app lleva la misma idea —leer archivos MBOX de cualquier tamaño, totalmente sin conexión— a una interfaz nativa cuidada, con búsqueda, etiquetas, hilos y soporte EML. ¿Prefieres la terminal? mboxShell es libre y con licencia MIT.

github.com/dcarrero/mboxshell