mboxShell

Schneller Terminal-Viewer für MBOX-Dateien jeder Größe. Öffnen, durchsuchen und exportieren Sie E-Mails aus Gmail-Takeout-Backups (50 GB+) ohne sie in den Speicher zu laden.

Leer en Espanol / Spanish

---

Warum dieses Projekt existiert

Wenn Sie Ihre E-Mails mit Google Takeout aus Gmail exportieren, erhalten Sie eine oder mehrere .mbox-Dateien, die mehrere zehn Gigabyte groß sein können — plus ein weiteres Postfach pro Google-Gruppe, die Sie besitzen, was leicht zu übersehen ist und größer sein kann als der Gmail-Export selbst. Es gibt kein plattformübergreifendes Terminal-Tool, mit dem Sie diese Dateien effizient öffnen, durchsuchen und durchblättern können, ohne sie vollständig in den Speicher zu laden.

mboxShell wurde entwickelt, um dieses Problem zu lösen: Öffnen Sie eine 50 GB MBOX in Sekunden, navigieren Sie reibungslos durch Hunderttausende von Nachrichten, suchen Sie nach Absender, Datum oder Inhalt und exportieren Sie, was Sie benötigen. Alles vom Terminal aus, ohne GUI, ohne Server, ohne externe Abhängigkeiten.

Anwendungsfälle

• Gmail-Backups durchsuchen (Google Takeout) mit ihren ursprünglichen Labels
• Die Gruppen lesen, die Sie besitzen, die von Takeout als eigene Postfächer exportiert werden — oft die größten Dateien im Archiv
• Mail-Archive analysieren auf Servern, während Migrationen oder Audits
• Nachrichten durchsuchen in MBOX-Dateien aus jeder Quelle (Thunderbird, Unix-Server, etc.)
• Nachrichten exportieren nach EML, CSV oder Klartext zur weiteren Verarbeitung
• Anhänge extrahieren einzeln oder in großen Mengen
• Mehrere MBOX-Dateien zusammenführen zu einer, wobei Duplikate entfernt werden

Auch auf dem Mac: mboxViewer

Wenn Sie eine native grafische Erfahrung auf macOS bevorzugen, schauen Sie sich mboxViewer an — eine native Mac-App, die vom selben Team entwickelt wurde. Sie bietet eine vertraute Postfach-Oberfläche zum Öffnen, Durchsuchen und Durchsuchen von MBOX-Dateien, ohne sie jemals in einen Mail-Client zu importieren. Ziehen Sie Ihre .mbox-Datei per Drag & Drop, und Sie erhalten sofortigen Zugriff auf alle Ihre Nachrichten, Anhänge und Labels in einem sauberen, macOS-nativen Fenster. Ideal für Benutzer, die die Leistungsfähigkeit der Parsing-Engine von mboxShell mit dem Komfort einer Desktop-GUI wünschen.

Auch in Ihrem Browser: Online Mbox Viewer

Müssen Sie einen Blick in eine MBOX-Datei werfen, ohne etwas zu installieren? Probieren Sie Online Mbox Viewer — eine kostenlose, MIT-lizenzierte Web-App vom selben Autor. Sie öffnet und rendert .mbox-Dateien vollständig in Ihrem Browser: Nichts wird auf einen Server hochgeladen, sodass Ihre E-Mails auf Ihrem Rechner bleiben. Perfekt für einen schnellen Blick von jedem Gerät aus. Quellcode unter github.com/dcarrero/online-mbox-viewer.

Funktionen

• Lädt die Datei niemals in den Speicher. Verwendet Streaming-I/O mit einem 1 MB-Puffer. Eine 100 GB MBOX verwendet ungefähr die gleichen ~500 MB RAM wie eine 1 GB große (nur der Metadaten-Index lebt im Speicher).
• Persistente Indizierung. Das erste Öffnen erstellt einen binären Index (.mboxshell.idx), sodass nachfolgende Öffnungen weniger als eine Sekunde dauern.
• Volle Gmail-Unterstützung. Erkennt und zeigt X-Gmail-Labels als virtuelle Ordner in einem Seitenleisten-Panel an, sodass Sie nach Inbox, Sent, Starred, benutzerdefinierten Labels usw. filtern können.
• Google Groups-Postfächer. Liest die topics.mbox-Dateien, die ein Takeout-Archiv für jede Gruppe liefert, die Sie besitzen, benennt sie nach der Gruppe statt nach dem bedeutungslosen Dateinamen, zeigt die Gruppe als virtuelles Label an und verknüpft Konversationen über die exakte X-GM-THRID-ID.
• Korrekte Kodierungen. Dekodiert RFC 2047 encoded-words, unterstützt UTF-8, ISO-8859-1, Windows-1252, KOI8-R und jeden von encoding_rs erkannten Zeichensatz.
• Konversations-Threading. Gruppiert Nachrichten in Threads mithilfe des JWZ-Algorithmus (derselbe, der von Netscape/Mozilla verwendet wird) oder der eigenen Konversations-ID des Postfachs, wenn es eine hat.
• Erweiterte Suche. Feldspezifische Filterung (from:, subject:, date:, body:, has:attachment, label:, etc.), Datumsbereiche, Größenfilter, AND/OR-Operatoren und Negation.
• Flexibler Export. Einzel- oder Massenexport nach EML, CSV (Excel-kompatibel), Klartext. Dekodierte Anhangsextraktion.
• Einzelne Binärdatei. Keine Laufzeitumgebung, keine Abhängigkeiten. Eine ~5 MB große ausführbare Datei, die auf Linux, macOS und Windows läuft.
• Vollständige Terminal-UI. Tastaturnavigation (vi-Stil), drei Layout-Modi, interaktive Suchleiste, konfigurierbare Tastenkürzel.
• Zweisprachig. Oberfläche verfügbar in Englisch und Spanisch, automatisch aus der System-Locale erkannt.

Installation

Vorgefertigte Binärdateien (empfohlen)

Laden Sie die neueste Version für Ihre Plattform von der Releases-Seite herunter:

Plattform	Binärdatei
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

Nach dem Herunterladen machen Sie sie ausführbar und verschieben sie in Ihren 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

Unter Windows verschieben Sie mboxshell-windows-x86_64.exe in einen Ordner in Ihrem PATH oder führen sie direkt aus.

Aus dem Quellcode erstellen

Voraussetzungen: Rust 1.85 oder neuer.

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

Cross-Kompilierung für andere Plattformen

# 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

Installation über Cargo

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

Schnellstart

# 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