mboxShell

Быстрый терминальный просмотрщик для MBOX-файлов любого размера. Открывайте, ищите и экспортируйте письма из резервных копий Gmail Takeout (50 ГБ+) без загрузки их в память.

Leer en Espanol / Spanish

---

Зачем существует этот проект

Когда вы экспортируете свою почту из Gmail с помощью Google Takeout, вы получаете один или несколько файлов .mbox, которые могут весить десятки гигабайт — плюс ещё один почтовый ящик для каждой группы Google, которой вы владеете, что легко упустить, и он может быть больше самого экспорта Gmail. Не существует кроссплатформенного терминального инструмента, позволяющего эффективно открывать, искать и просматривать эти файлы без полной загрузки их в память.

mboxShell был создан для решения этой проблемы: открыть MBOX размером 50 ГБ за секунды, плавно перемещаться по сотням тысяч сообщений, искать по отправителю, дате или содержимому и экспортировать всё, что нужно. Всё из терминала, без GUI, без сервера, без внешних зависимостей.

Сценарии использования

• Просмотр резервных копий Gmail (Google Takeout) с их оригинальными метками
• Чтение групп, которыми вы владеете, экспортированных Takeout как отдельные почтовые ящики — часто это самые большие файлы в архиве
• Анализ почтовых архивов на серверах, при миграциях или аудитах
• Поиск сообщений в MBOX-файлах из любого источника (Thunderbird, Unix-серверы и т. д.)
• Экспорт сообщений в EML, CSV или обычный текст для дальнейшей обработки
• Извлечение вложений по отдельности или массово
• Объединение нескольких MBOX-файлов в один с удалением дубликатов

Также на Mac: mboxViewer

Если вы предпочитаете нативный графический интерфейс на macOS, обратите внимание на mboxViewer — нативное приложение для Mac, созданное той же командой. Оно предоставляет привычный интерфейс в стиле почтового клиента для открытия, просмотра и поиска MBOX-файлов без необходимости импортировать их в почтовый клиент. Перетащите ваш файл .mbox, и вы получите мгновенный доступ ко всем вашим сообщениям, вложениям и меткам в чистом нативном окне macOS. Идеально для пользователей, которым нужна мощь движка парсинга mboxShell с удобством настольного GUI.

Также в вашем браузере: Online Mbox Viewer

Нужно заглянуть в MBOX-файл без установки чего-либо? Попробуйте Online Mbox Viewer — бесплатное веб-приложение с лицензией MIT от того же автора. Оно открывает и отображает файлы .mbox полностью в вашем браузере: ничего не загружается на какой-либо сервер, поэтому ваша почта остаётся на вашей машине. Идеально для быстрого просмотра с любого устройства. Исходный код на github.com/dcarrero/online-mbox-viewer.

Возможности

• Никогда не загружает файл в память. Использует потоковый ввод-вывод с буфером 1 МБ. MBOX размером 100 ГБ использует примерно те же ~500 МБ оперативной памяти, что и файл размером 1 ГБ (в памяти хранится только индекс метаданных).
• Постоянное индексирование. При первом открытии создаётся бинарный индекс (.mboxshell.idx), поэтому последующие открытия занимают менее секунды.
• Полная поддержка Gmail. Обнаруживает и отображает X-Gmail-Labels как виртуальные папки на боковой панели, позволяя фильтровать по «Входящие», «Отправленные», «Помеченные», пользовательским меткам и т. д.
• Почтовые ящики Google Groups. Читает файлы topics.mbox, которые архив Takeout поставляет для каждой группы, которой вы владеете, называет их по имени группы вместо бессмысленного имени файла, показывает группу как виртуальную метку и группирует беседы по точному идентификатору X-GM-THRID.
• Корректные кодировки. Декодирует encoded-words RFC 2047, поддерживает UTF-8, ISO-8859-1, Windows-1252, KOI8-R и любую кодировку, распознаваемую encoding_rs.
• Группировка бесед. Объединяет сообщения в цепочки с помощью алгоритма JWZ (того же, что используется в Netscape/Mozilla), либо по собственному идентификатору беседы почтового ящика, если он есть.
• Расширенный поиск. Фильтрация по конкретным полям (from:, subject:, date:, body:, has:attachment, label: и т. д.), диапазоны дат, фильтры по размеру, операторы AND/OR и отрицание.
• Гибкий экспорт. Индивидуальный или массовый экспорт в EML, CSV (совместимый с Excel), обычный текст. Извлечение декодированных вложений.
• Единый бинарный файл. Без среды выполнения, без зависимостей. Исполняемый файл размером ~5 МБ, работающий на Linux, macOS и Windows.
• Полноценный терминальный интерфейс. Навигация с клавиатуры (в стиле vi), три режима компоновки, интерактивная строка поиска, настраиваемые сочетания клавиш.
• Двуязычность. Интерфейс доступен на английском и испанском языках, автоматически определяется по системной локали.

Установка

Готовые бинарные файлы (рекомендуется)

Скачайте последний релиз для вашей платформы со страницы Releases:

Платформа	Бинарный файл
Linux x86_64	mboxshell-linux-x86_64
Linux ARM64	mboxshell-linux-aarch64
Linux RISC-V 64	mboxshell-linux-riscv64
FreeBSD x86_64	mboxshell-freebsd-x86_64
macOS Intel	mboxshell-macos-x86_64
macOS Apple Silicon	mboxshell-macos-aarch64
Windows x86_64	mboxshell-windows-x86_64.exe
Windows ARM64	mboxshell-windows-arm64.exe

После загрузки сделайте его исполняемым и переместите в ваш PATH:

# Linux / macOS
chmod +x mboxshell-*
sudo mv mboxshell-* /usr/local/bin/mboxshell

# Or place it in a user-local directory
mv mboxshell-* ~/.local/bin/mboxshell

В Windows переместите mboxshell-windows-x86_64.exe в папку из вашего PATH или запустите его напрямую.

Сборка из исходного кода

Требования: Rust 1.85 или новее.

# Clone and build
git clone https://github.com/dcarrero/mboxshell.git
cd mboxshell
cargo build --release

# The binary is at target/release/mboxshell
# Install it system-wide:
sudo cp target/release/mboxshell /usr/local/bin/

# Or for the current user only:
cp target/release/mboxshell ~/.local/bin/

Кросс-компиляция для других платформ

# Add the target you need
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

# Build for a specific target
cargo build --release --target aarch64-apple-darwin

Установка через Cargo

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

Быстрый старт

# Open an MBOX file in the terminal UI
mboxshell mail.mbox

# Index and show statistics
mboxshell index mail.mbox
mboxshell stats mail.mbox

# Search from the command line
mboxshell search mail.mbox "from:[email protected] date:2024"
mboxshell search mail.mbox "has:attachment subject:invoice" --json

# Export messages
mboxshell export mail.mbox --format eml --output ./emails/
mboxshell export mail.mbox --format csv --output summary.csv

# Hand over only part of an archive: a new mailbox with just the matches
mboxshell export mail.mbox --format mbox --query "from:[email protected]" -o handover.mbox

# Extract attachments
mboxshell attachments mail.mbox --output ./attachments/

# Merge multiple MBOX files (duplicates are removed by default)
mboxshell merge file1.mbox file2.mbox -o merged.mbox

# Merge tagging every message with the mailbox it came from
mboxshell merge Inbox.mbox Sent.mbox -o merged.mbox --source-header