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 für jede Google Group, die Sie besitzen, was leicht zu übersehen ist und größer als der Gmail-Export selbst sein kann. 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 große 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, bei Migrationen oder Audits
Nachrichten durchsuchen in MBOX-Dateien aus beliebigen Quellen (Thunderbird, Unix-Server usw.)
Nachrichten exportieren nach EML, CSV oder reinem Text 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 Durchblättern von MBOX-Dateien, ohne sie jemals in einen Mail-Client zu importieren. Ziehen Sie Ihre .mbox-Datei per Drag & Drop hinein, 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 aus — 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 nie in den Speicher. Verwendet Streaming-I/O mit einem 1-MB-Puffer. Eine 100-GB-MBOX verbraucht ungefähr denselben ~500 MB RAM wie eine 1-GB-Datei (nur der Metadaten-Index liegt im Speicher).
Persistente Indizierung. Beim ersten Öffnen wird ein binärer Index (.mboxshell.idx) erstellt, sodass nachfolgende Öffnungen weniger als eine Sekunde dauern.
Vollständige Gmail-Unterstützung. Erkennt und zeigt X-Gmail-Labels als virtuelle Ordner in einem Seitenleisten-Panel an, sodass du nach Posteingang, Gesendet, Markiert, benutzerdefinierten Labels usw. filtern kannst.
Google-Groups-Postfächer. Liest die topics.mbox-Dateien, die ein Takeout-Archiv für jede Gruppe enthält, die dir gehört, benennt sie nach der Gruppe statt nach dem nichtssagenden Dateinamen, zeigt die Gruppe als virtuelles Label an und gruppiert Konversationen anhand der exakten X-GM-THRID-ID.
Korrekte Kodierungen. Dekodiert RFC-2047-kodierte Wörter, unterstützt UTF-8, ISO-8859-1, Windows-1252, KOI8-R und jeden von encoding_rs erkannten Zeichensatz.
Konversations-Threading. Gruppiert Nachrichten mithilfe des JWZ-Algorithmus (derselbe, der von Netscape/Mozilla verwendet wird) in Threads oder anhand der eigenen Konversations-ID des Postfachs, sofern es eine hat.
Erweiterte Suche. Feldbezogene Filterung (from:, subject:, date:, body:, has:attachment, label: usw.), Datumsbereiche, Größenfilter, AND/OR-Operatoren und Negation.
Flexibler Export. Einzel- oder Massenexport nach EML, CSV (Excel-kompatibel), Klartext, HTML, eine neue MBOX oder ein Maildir. Dekodierte Extraktion von Anhängen.
Einzelne Binärdatei. Keine Laufzeitumgebung, keine Abhängigkeiten. Eine ~5 MB große ausführbare Datei, die unter Linux, macOS und Windows läuft.
Vollständige Terminal-UI. Tastaturnavigation (im vi-Stil), drei Layout-Modi, interaktive Suchleiste, konfigurierbare Tastenkürzel.
Zweisprachig. Oberfläche verfügbar in Englisch und Spanisch, automatisch anhand der System-Locale erkannt.

Installation

Vorgefertigte Binärdateien (empfohlen)

Lade die neueste Version für deine 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 machst du sie ausführbar und verschiebst sie in deinen 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 es 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

# Convert to Maildir (read/replied/flagged state kept as Maildir flags)
mboxshell export mail.mbox --format maildir -o ~/Maildir/Archive

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

mboxshell v0.7.1