CLI-Parameter

Aufruf

Ohne Parameter startet die GUI. Für sichtbare Konsolenausgabe verwenden Sie MailAdressdatenCLI.exe.

MailAdressdatenCLI.exe --update-scan
MailAdressdatenCLI.exe --search "Muster" --result-format tsv
MailAdressdatenCLI.exe --help

Parameter

-h, --help

Zeigt die vollständige Hilfe. Verändert keine Dateien.

--version

Gibt die installierte Programmversion aus.

--gui

Startet ausdrücklich die grafische Oberfläche; ohne Parameter ist dies bereits der Standard.

--update-scan, --scan

Startet den inkrementellen lokalen Scan. Schreibt Ausgabe, JSON-Zustand und Kontaktdatenbank, verändert Thunderbird aber nicht.

--full-scan

Liest alle aktivierten Quellen vollständig. Ein passender Zwischenstand eines unterbrochenen Gesamtscans wird standardmäßig fortgesetzt; der bisherige Datenbestand wird erst nach erfolgreichem Abschluss ersetzt.

--restart-full-scan

Nur zusammen mit --full-scan: ignoriert einen vorhandenen Zwischenstand bewusst und beginnt den Gesamtscan neu.

--list-profiles

Gibt erkannte Thunderbird-Profile als JSON aus.

--profiles-ini PFAD

Verwendet eine abweichende profiles.ini. Standard ist der von Thunderbird übliche Benutzerpfad.

--profile PFAD

Verwendet einen bestimmten Profilordner statt profiles.ini. Mehrfach möglich.

--vcard PFAD

Ergänzt eine VCF-Datei oder einen Ordner. Mehrfach möglich.

--mail-index, --no-mail-index

Schaltet die inkrementelle Suche nach lokalen Mailkandidaten ein oder aus. Standard: ein; Treffer sind ungeprüfte Hinweise.

--original-mail, --no-original-mail

Schaltet die read-only-Auswertung vollständiger lokaler RFC/MIME-Originalnachrichten ein oder aus. Standard: ein. Mailtexte werden nicht gespeichert.

--mail-backup-root PFAD

Optionaler TB-Data-Sicherungsstamm, zum Beispiel P:\TB-Data. Ohne Angabe sucht die App passende Sicherungen automatisch. Eine Sicherung wird nur als Basis benutzt, wenn ihr Mailboxinhalt byte-identischer Anfang der Live-Datei ist.

--mail-vcards, --no-mail-vcards

Schaltet die Suche nach vCard-Anhängen ein oder aus. Standard: ein.

--initial-message-limit ZAHL

Begrenzt beim ersten Indexlauf alte Nachrichten je Profil. Standard: 10000; muss größer als 0 sein. Danach werden nur neue Dokument-IDs inkrementell ergänzt.

--scan-speed gentle|normal|fast

Wählt die Scan-Geschwindigkeit. gentle schont Thunderbird maximal, normal arbeitet mit kurzen Pausen und ist Standard, fast verzichtet auf Zusatzpausen und kann das System stärker belasten.

--gentle-scan, --no-gentle-scan

Kompatibilitätsschalter: --gentle-scan entspricht --scan-speed gentle, --no-gentle-scan entspricht --scan-speed fast. Für neue Aufrufe ist --scan-speed vorzuziehen.

--scheduled-task

Kennzeichnet einen Aufruf als unbeaufsichtigte tägliche Aufgabe. Bei einem aktiven oder zur Fortsetzung wartenden manuellen Gesamtscan wird der Lauf ohne Fehler übersprungen. Der Installer verwendet diesen internen Schalter automatisch.

--output-dir PFAD

Setzt den lokalen Ausgabeordner für SQLite-Verweise, JSONL, CSV, Manifest, Kompatibilitätsformate und Scanbericht.

--state-file PFAD

Setzt die JSON-Zustandsdatei. Standard: cache\state.json.

--database PFAD

Setzt die lokale durchsuchbare SQLite-Datenbank. Standard: data\contacts.sqlite3; Journalmodus bleibt DELETE.

--reset-state

Wirkt wie --full-scan; bisherige Daten bleiben bis zum erfolgreichen Ersatz erhalten.

--search TEXT

Durchsucht die Kontaktdatenbank. Ergänzend: --confidence strukturiert|abgeleitet|hinweis, --conflicts, --limit (Standard 200) und --result-format json|tsv.

--export-format FORMAT

Exportiert die gesamte Datenbank als json, jsonl, csv, txt, xml, ods, xls, xlsx oder vcf. Benötigt --export-path PFAD.

--install-daily-task HH:MM

Legt nach ausdrücklichem Aufruf eine fensterlose leichte tägliche Windows-Aufgabe an: Mailindex und vCard-Anhänge, ohne vollständige Originalmail-Auswertung, im Profil gentle und mit höchstens zwei Stunden Laufzeit. Der vCard-Fortschritt wird je Mailbox gesichert und beim nächsten Lauf fortgesetzt.

--task-status, --remove-daily-task

Zeigt die Aufgabe an beziehungsweise entfernt nur diese MailAdressdaten-Aufgabe.

--bulk-geocode

Löst alle noch nicht lokal gecachten Anschriften über den mit --geocoder-url angegebenen lokalen oder selbst betriebenen Nominatim-kompatiblen Dienst auf.

--geocoder-url URL

Such-Endpunkt für --bulk-geocode, zum Beispiel http://127.0.0.1:8080/search. Ohne gültigen lokalen oder selbst betriebenen Endpunkt startet der Serienlauf nicht.

--geocode-delay SEKUNDEN

Mindestpause zwischen Geokodierungsanfragen. Standard: 0,05 Sekunden.

--diagnostics

Gibt Diagnosepfade und Datenbankstatus als JSON aus.

--check-update

Erzwingt eine HTTPS-Abfrage der öffentlichen Versionsdatei und gibt das Ergebnis als JSON aus.

--self-test

Prüft Profile, Datenbank, Nicht-WAL-Regel und die Trennung vom PyInstaller-Tempordner.

--gui-smoke-test

Baut die GUI verborgen auf und schließt sie sofort; vorgesehen für technische Release-Prüfungen.

--native-messaging

Startet den binären Native-Messaging-Modus der Thunderbird-Erweiterung. Nicht für einen direkten interaktiven Aufruf vorgesehen.