Skip to content
Mbox Viewer Pro

mboxShell

A ferramenta de terminal gratuita por trás do Mbox Viewer. Abra, pesquise e exporte arquivos MBOX de qualquer tamanho — direto do seu shell, no Linux, macOS, FreeBSD e Windows.

Última v0.7.3 Livre e de código aberto Escrito em Rust MIT
mboxshell
mboxShell rodando em um terminal, mostrando um arquivo MBOX com lista de mensagens, pastas e painel de leitura.

Um kit MBOX completo no seu terminal

Tudo o que você precisa para trabalhar com enormes arquivos de e-mail — ler, pesquisar, encadear e exportar — sem interface gráfica e sem nuvem.

Qualquer tamanho

Um parser de streaming com buffer de 1 MB abre backups do Gmail Takeout com mais de 50 GB mantendo a RAM em torno de 500 MB.

Reabertura instantânea

Um índice binário persistente — verificado com SHA-256 — reabre até o maior arquivo em menos de um segundo.

Busca por campos

Filtre com from:, subject:, date:, body:, has:attachment e label:, além de frases exatas e um OR que agrupa alternativas: a OR b c se lê como (a OR b) AND c — na TUI ou pela linha de comando.

Etiquetas do Gmail e Google Groups

Detecta X-Gmail-Labels e as transforma em pastas virtuais para navegar e filtrar. Em um arquivo do Google Takeout, cada caixa do Groups aparece com o nome do seu grupo.

Encadeamento de conversas

Agrupa mensagens relacionadas em conversas com o clássico algoritmo de encadeamento JWZ, usando o identificador de conversa do Google (X-GM-THRID) quando a caixa o traz.

Exporte para qualquer lugar

Salve mensagens como MBOX, EML, CSV, TXT ou HTML e extraia anexos individualmente ou em lote.

Mesclar e desduplicar

Combine vários arquivos MBOX em um, com desduplicação opcional para não importar nada duas vezes.

Interface de terminal completa

Uma TUI baseada em ratatui com três modos de layout, navegação estilo vi e autocompletar para bash, zsh, fish, PowerShell e elvish.

Multiplataforma e bilíngue

Um único binário de ~5 MB sem dependências de execução. Funciona no Linux, macOS, FreeBSD e Windows, com interface em inglês e espanhol.

Novidades

As três versões mais recentes. A última, v0.7.3, saiu em 4 de setembro de 2026.

v0.7.3

4 de setembro de 2026

O app de Mac mudou de domínio

  • Só documentação: os dois READMEs e os dois manuais ainda apontavam para mboxviewer.net, o domínio anterior do app de macOS. Agora citam mboxviewerpro.com, assim como o link de projeto do próprio repositório.
Notas da versão v0.7.3

v0.7.2

22 de agosto de 2026

Exportar uma seleção como uma caixa nova

  • export --format mbox escreve as mensagens selecionadas em uma única caixa MBOX nova. Até agora uma seleção podia sair como .eml, CSV, texto ou HTML — uma pasta de arquivos —, mas nunca de volta como caixa, então não havia como entregar parte de um arquivo no formato em que ele chegou. Junto com --query, esse é o fluxo de entrega inteiro: filtrar um despejo grande (uma exportação do Google Vault, um arquivo do Takeout) até as mensagens que realmente fazem parte da entrega e produzir uma caixa que contenha só essas.
  • Uma mensagem lida de um MBOX é copiada byte a byte, com a própria linha de envelope From e o escape que veio da origem: reescrever o envelope só poderia corromper um arquivo que já era válido. A que não tem essa linha — porque veio de um EML — recebe uma sintetizada, mais o escape com > das linhas do corpo que começam por From, sem o qual o resultado não seria uma caixa legível. A saída é gravada em um temporário e renomeada no fim, como na fusão, então uma falha no meio nunca deixa uma caixa pela metade com o nome que você pediu, e o arquivo de origem nunca é tocado. 7 testes novos (241 no total).
Notas da versão v0.7.2

v0.7.1

20 de agosto de 2026

Buscas que significam o que você escreveu

  • OR agora tem precedência. Era uma marca da consulta inteira, então um único OR em qualquer ponto transformava todos os termos em alternativas: from:ana OR from:luis subject:fatura não significava «de um ou de outro, sobre faturas» — devolvia tudo de ana, tudo de luis e tudo que tivesse «fatura» no assunto, viesse de quem viesse. Numa caixa de 6.787 mensagens, isso é a diferença entre 49 resultados e 2.102. Uma consulta agora é uma lista de grupos unidos por AND, cada grupo uma lista de termos unidos por OR, e OR é o que coloca dois termos no mesmo grupo: a OR b c se lê como (a OR b) AND c. Parênteses continuam sem existir.
  • after:X before:Y era impossível de expressar. A consulta guardava um único filtro de data, então o segundo substituía o primeiro sem avisar e só o before: sobrevivia — metade do que você digitava era descartada em silêncio. Os filtros de data e de tamanho agora se acumulam, o que também transforma size:>1mb size:<5mb numa faixa de verdade.
  • after: já inclui o próprio dia e before: continua excluindo o seu, então after:2024-01-01 before:2025-01-01 é exatamente o ano de 2024 — a leitura semiaberta que os operadores do Gmail usam, coerente com date:A..B, que já era inclusivo. Os dois manuais e os dois READMEs documentam a precedência e os limites de data. 23 testes novos (234 no total).
Notas da versão v0.7.1
Ver o changelog completo

A um comando de distância

mboxshell
$ mboxshell archive.mbox
# Abre a interface de terminal interativa
$ mboxshell search archive.mbox "from:jane has:attachment"
# Pesquisa direto da linha de comando
$ mboxshell export archive.mbox -f eml -o out/
# Exporta mensagens para MBOX, EML, CSV, TXT ou HTML
$ mboxshell merge a.mbox b.mbox -o all.mbox --source-header
# Mescla arquivos — duplicados removidos por padrão (--no-dedup para mantê-los) — anotando de qual caixa veio cada mensagem
$ mboxshell attachments archive.mbox -o files/
# Extrai todos os anexos de uma vez

Instale

Baixe um binário pré-compilado para Linux, macOS, FreeBSD ou Windows na página de versões, ou compile você mesmo com Cargo:

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

O motor de código aberto por trás do Mbox Viewer

O Mbox Viewer para Mac e Windows nasceu do mboxShell. O app leva a mesma ideia — ler arquivos MBOX de qualquer tamanho, totalmente offline — a uma interface nativa caprichada, com busca, etiquetas, encadeamento e suporte a EML. Prefere o terminal? O mboxShell é livre e licenciado sob MIT.

github.com/dcarrero/mboxshell