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.2.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. Con F1 ves la sintaxis completa sin salir del programa.

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. Las páginas HTML llevan dentro las imágenes integradas del mensaje, sin ficheros aparte.

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.2.0, se publicó el 18 de octubre de 2026.

v1.2.0

18 de octubre de 2026

Las imágenes integradas ya salen en el export HTML

  • Los exports HTML incrustan ahora las imágenes integradas del mensaje (#49). Cada <img src="cid:…"> se sustituye por la imagen del propio mensaje como URI data:, así que la página muestra logos e imágenes sin ficheros al lado y sin descargar nada. Antes desaparecían. Viene activado por defecto en export -f html y en el export HTML de la app; --no-inline-images lo desactiva.
  • Solo se incrustan PNG, JPEG, GIF y WebP, reconocidos por sus primeros bytes y no por el tipo que declaran, así que un SVG (que puede llevar scripts) nunca se incrusta.
  • Un theme desconocido en el fichero de configuración se ignoraba sin avisar; ahora avisa como cualquier otro valor no válido, y el aviso sale traducido. 5 tests nuevos (316 en total).
Notas de la versión v1.2.0

v1.1.0

18 de octubre de 2026

Toda la sintaxis de búsqueda, sin salir del programa

  • La ayuda (?) enumera ahora todos los operadores de búsqueda —from:, to:, cc:, subject:, body:, filename:, label:, id:, has:attachment, date:, rangos de fechas, after:/before:, size:, OR y -—, con el formato de fecha y un enlace al manual (#48). Antes solo mostraba 8 de los 15. 3 tests nuevos (311 en total).
  • F1 abre la ayuda directamente en la sintaxis de búsqueda, también desde la barra de búsqueda, donde ? forma parte de la consulta; Esc te devuelve a la consulta tal como la dejaste. En la línea de comandos, search --help y export --help terminan con la misma lista de operadores, en inglés o en español.
  • Seguridad: ammonia, la biblioteca que sanea las exportaciones HTML, pasa a la 4.2.4 por tres avisos RUSTSEC (RUSTSEC-2026-0373, RUSTSEC-2021-0157 y RUSTSEC-2021-0158). Las versiones anteriores de mboxShell están afectadas, así que conviene actualizar.
Notas de la versión v1.1.0

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