Skip to content
Mbox Viewer

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 v0.7.1 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 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 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 v0.7.1, se publicó el 20 de agosto de 2026.

v0.7.1

20 de agosto de 2026

Búsquedas que significan lo que escribes

  • OR ya tiene precedencia. Antes era un flag de la consulta entera, así que un solo OR en cualquier parte convertía todos los términos en alternativas: from:ana OR from:luis subject:factura no significaba «de cualquiera de los dos, sobre facturas», sino que devolvía todo lo de ana, todo lo de luis y todo lo que llevara «factura» en el asunto, viniera de quien viniera. En un buzón de 6.787 mensajes, eso son 49 resultados o 2.102. Ahora una consulta es una lista de grupos unidos por AND, cada grupo una lista de términos unidos por OR, y OR es lo que mete dos términos en el mismo grupo: a OR b c se lee como (a OR b) AND c. Paréntesis sigue sin haber.
  • after:X before:Y era imposible de expresar. La consulta guardaba un único filtro de fecha, así que el segundo pisaba al primero sin avisar y solo sobrevivía el before:, con lo que la mitad de lo que escribías se descartaba en silencio. Los filtros de fecha y de tamaño se acumulan ahora, lo que además convierte size:>1mb size:<5mb en una banda de verdad.
  • after: incluye ya su propio día y before: sigue excluyendo el suyo, así que after:2024-01-01 before:2025-01-01 es exactamente el año 2024: la lectura semiabierta que usan los operadores de Gmail y la que ya tenía date:A..B, que era inclusivo. Los dos manuales y los dos README documentan la precedencia y los límites de fecha. 23 tests nuevos (234 en total).
Notas de la versión v0.7.1

v0.7.0

20 de agosto de 2026

La otra mitad de un archivo de Google Takeout

  • Los buzones de Google Groups se abren ya como cualquier otro. Un archivo de Takeout contiene dos tipos de mbox, no uno: además del export de Gmail, cada grupo del que la cuenta es propietaria sale como Grupos/googlegroups.com/<grupo>@googlegroups.com/temas.mbox, con los nombres de carpeta y archivo traducidos al idioma de la cuenta. En el archivo con el que se desarrolló, ese era el fichero más grande de todo el export: 636 MB y 6.787 mensajes, frente a los 292 MB del mbox de Gmail.
  • La fecha del sobre From de un mensaje de Grupos ya no se resuelve como una fecha inventada. Google Groups escribe el desplazamiento horario antes del año (Thu Apr 16 09:53:04 +0000 2015), algo que asctime no admite, así que un mensaje sin cabecera Date: legible caía en un análisis de último recurso que devolvía un 2000-09-16 verosímil pero falso: ningún error, solo el orden y los filtros por fecha corrompidos.
  • El grupo aparece como etiqueta virtual en la barra lateral, así que el panel de etiquetas sirve para todo el archivo de Takeout y no solo para su mitad de Gmail. Además, el buzón ya no se muestra como «temas»: se nombra por el grupo (<grupo>@googlegroups.com), que es lo que de verdad lo identifica.
  • Las conversaciones se agrupan por el identificador real de conversación de Google (X-GM-THRID) cuando existe, en vez de por asunto. En el buzón de referencia eso pasó de 1.927 a 1.958 hilos, y el hilo más grande soltó 7 mensajes que no le correspondían.
  • Se arreglan dos fallos antiguos: un mensaje con Message-ID repetido ya no desaparece de la vista de hilos, y la opción corta -f, que reclamaban a la vez --force y el --format de export, ya no está en disputa. Conviene saberlo antes de actualizar: el formato del índice cambia, así que los .mboxshell.idx existentes se reconstruyen solos la primera vez que abres el buzón.
Notas de la versión v0.7.0

v0.6.2

7 de agosto de 2026

Fusiones trazables y una documentación que coincide con la herramienta

  • merge --source-header ahora graba el nombre de buzón que conoces. Apple Mail exporta un buzón como una carpeta «Inbox.mbox» con un archivo dentro llamado literalmente «mbox», así que todos los mensajes acababan con X-Mbox-Source: mbox, inservible para lo único que existe la cabecera. Los buzones que compartirían nombre se distinguen por su carpeta.
  • La documentación describía un merge --dedup que no existe: la deduplicación está activada por defecto y el flag real es --no-dedup. Corregido en los dos README y los dos manuales, y --source-header —que llegó sin documentar en la 0.6.1— ya está explicado.
  • La línea del resumen de la fusión «Etiquetados con origen» estaba fija en inglés mientras el resto sí se traducía: ahora pasa por el catálogo de idiomas. 7 tests nuevos (202 en total).
Notas de la versión v0.6.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 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