Hilfe

1. Installieren

Laden Sie MailAdressdaten-Setup.exe herunter und folgen Sie dem Assistenten. Das Setup installiert GUI und CLI pro Windows-Benutzer unter %LOCALAPPDATA%\Programs\AmrumSoftware\MailAdressdaten. Persönliche Daten liegen getrennt in dem beim Setup gewählten Datenordner; vorgeschlagen wird Dokumente\AmrumSoftware\MailAdressdaten.

2. Lokale Quellen auswählen

Starten Sie die App über das Startmenü. Beim App-Start wird kein Datenscan angeboten oder ausgeführt. Sie starten Update-Scan oder Gesamtscan selbst mit der jeweiligen Schaltfläche. Beim ersten bewusst gestarteten Scan zeigt die App vorab alle ausgewählten Thunderbird-Profile und aktivierten Quellen.

In der Profilliste sind zunächst alle erkannten Profile ausgewählt. Mit Strg+Klick können einzelne Profile ein- oder ausgeschlossen werden. „Mailindex und Mailhinweise“ ergänzt mögliche Zuordnungen aus Thunderbirds Suchindex. „RFC/MIME-Originalmails read-only auswerten“ liest zusätzlich Reply-To, From, Sender, To, Cc, Bcc und Signaturen. „vCard-Anhänge in Mailboxen“ sucht vCards in lokalen Mailordnern.

Für Originalmails wird zuerst eine passende byte-identische TB-Data-Sicherungsbasis verwendet und anschließend nur der aktuelle Live-Zuwachs gelesen. Alter und Nutzbarkeit der Sicherung werden angezeigt. Mailtexte verbleiben nur im Arbeitsspeicher.

Während des Scans blinkt ein roter Hinweis mit dem aktuellen Arbeitsschritt. Die vorhandene Tabelle bleibt für Suche, Sortierung und Details benutzbar. Neue oder aktualisierte Werte erscheinen erst nach Abschluss. Der standardmäßig aktive schonende Hintergrundscan pausiert Mailindex, Originalmail- und vCard-Mailboxauswertung deutlich häufiger. App, Datenträger und Thunderbird werden dadurch weniger zusammenhängend belastet; der Scan dauert aber länger.

3. Suchen und prüfen

„Update-Scan“ liest nur neue oder geänderte Quellen. „Gesamtscan“ baut den Zustand vollständig neu auf. Während eines Gesamtscans speichert die App regelmäßig atomare Zwischenstände ohne Mailtexte. Nach Abbruch, Absturz oder Rechnerneustart startet nichts automatisch: „Gesamtscan / Fortsetzen“ bietet die geprüfte Fortsetzung oder einen bewussten Neustart an. Der bisherige Datenbestand bleibt bis zum vollständigen Abschluss verfügbar.

Adressbuch- und vCard-Daten gelten als stärkere Quellen. Treffer aus Mailtexten sind ausdrücklich ungeprüfte Hinweise und sollten kontrolliert werden.

Beschriftete Signaturzeilen können Organisation, Telefon und Fax liefern. Bekannte Social-Media- und Messenger-Werte werden mit dem Dienstnamen wie Google Talk, AIM, LinkedIn oder X/Twitter angezeigt. Die Quellenspalte nennt Anzahl und verständliche Art. Anführungs- und Klammerzeichen werden aus Namen entfernt, der eingeschlossene Text bleibt erhalten.

Datenqualität und Ausschlüsse

Die mittlere Kontaktliste besitzt einen waagerechten und senkrechten Slider. Nach der Zusammenführung werden Kontakte mit Ziffern im Namen, Einwortnamen, mehrsprachig erkannten Firmen-, Abteilungs- oder Funktionsbezeichnungen im Namen sowie ausschließlich ungültigen vorhandenen E-Mail- oder Telefonnummern ausgeschlossen. Bei mehreren Angaben genügt jeweils eine gültige Angabe, damit der Kontakt erhalten bleibt.

Das Menü „Datenqualität“ zeigt die Anzahl und jeden Ausschlussgrund. Der lokale Bericht enthält nur Summen und keine Namen oder Kontaktdaten. Thunderbird und Original-vCards bleiben unverändert.

Fremde Schriftsysteme

Russische, chinesische, japanische und weitere nichtlateinische Texte werden ohne Upload vollständig lokal lesbar dargestellt. Personennamen werden nicht inhaltlich übersetzt, sondern lateinisch umgeschrieben. Bei Organisationen, Rollen und Adressen werden bekannte Sachbegriffe deutsch übersetzt und übrige Zeichen umgeschrieben. Das Original bleibt unverändert im Tab Original erhalten.

Maschinenlesbare Liste, Namensgruppen und Karten

Unter Datei erzeugt die App eine dokumentierte UTF-8-JSON-Adressliste mit Namen, Organisationen, E-Mail-Adressen, Rufnummern, strukturierten Anschriften, Webseiten, sozialen Profilen und lokalen Quellenbelegen. Kontakte mit demselben bereinigten Namen erhalten denselben nicht-destruktiven Gruppenschlüssel, ohne ihre Werte zu vermischen. Automatisch verbunden wird nur über strukturierte UID oder exakte E-Mail.

Das Menü Karte öffnet die Anschrift wahlweise im internen Kartenfenster oder bei Google Maps. Vor Google Maps erklärt ein einmaliger Hinweis, dass nur die ausgewählte Postanschrift übertragen wird. Neueste Thunderbird-Mails werden bevorzugt über Ordner und Message-Key geöffnet; die Message-ID dient nur als Rückfall.

ETA und geschätzte Endzeit

Während eines Scans zeigt die App zwei getrennte Prognosen: Abschnitt gilt für den gerade laufenden Arbeitsschritt, Gesamt für alle noch ausstehenden Scanabschnitte. Beide Angaben enthalten eine ETA und die ungefähre lokale Endzeit.

Originalmail- und vCard-Auswertung berücksichtigen die insgesamt noch zu lesende Größe aller ausgewählten mbox-Dateien und den kumulierten Byte-Fortschritt. Größen erscheinen automatisch in B, KB, MB, GB oder TB mit höchstens fünf Ziffern. Die Schätzung verbindet das tatsächliche Arbeitsvolumen mit konservativen Byte-Raten, lokal gespeicherten Messwerten erfolgreicher Scans derselben Art und einer Sicherheitsreserve. Dadurch bleibt insbesondere die Gesamtprognose bei großen Mailbeständen vorsichtiger.

4. Ergebnisse verwenden

Die App führt eine lokale durchsuchbare Kontaktdatenbank im SQLite-Modus DELETE; WAL und SHM sind verboten. Über Feldsuche, additive Pflichtfeld-Schaltflächen, Änderungsansicht und „Neueste Mail öffnen“ können Quellen geprüft werden. Sichere typische Zeichensatzfehler bei Umlauten werden beim Einlesen sowie einmalig in einer bestehenden Datenbank automatisch repariert; Original-vCards bleiben unverändert.

Jeder erfolgreiche Scan schreibt vollständige streamingfähige JSONL- und CSV-Hauptausgaben. export-manifest.json nennt Datensatzanzahl, Größe und SHA-256-Prüfsumme jedes Dateiteils. Bei Grenzen entstehen automatisch nummerierte Dateien oder Arbeitsmappen; nichts wird abgeschnitten oder still weggelassen. Fehler in JSON, TXT, XML, ODS, XLS, XLSX oder VCF verwerfen SQLite, JSONL und CSV nicht.

Ein Doppelklick in die Adressspalte öffnet die Anschrift auf einer verschieb- und zoombaren OpenStreetMap-Karte. Bleibt die vollständige Suche erfolglos, wird automatisch nochmals ohne Hausnummer gesucht und die ungenauere Straßenposition deutlich gekennzeichnet. „Exportieren …“ bietet JSON, JSONL, CSV, TXT, XML, ODS, XLS, XLSX und VCF.

Mailquellen erneut prüfen

Bei jedem Update-Scan prüft die App gespeicherte Mailverknüpfungen gegen Thunderbirds aktuellen lokalen Index. Verschobene Nachrichten werden neu zugeordnet. Wurde eine Mail gelöscht, verknüpft die App ersatzweise die neueste noch vorhandene Mail des Kontakts oder kennzeichnet die Quelle eindeutig als nicht mehr vorhanden. Der Öffnen-Knopf bleibt dann deaktiviert. Rechts stehen für Kontakt und Quellen jeweils die Tabs Lesbar und Original bereit.

5. Optional automatisieren

Im Menü „Automatisierung“ kann eine tägliche Windows-Aufgabe verwaltet und ein lokaler oder selbst betriebener Geokodierungsdienst für automatische Serienläufe eingerichtet werden. Die Aufgabe startet ohne sichtbares Konsolenfenster. Ihr sanfter vCard-Leser arbeitet mit kleinen Leseimpulsen und speichert abgeschlossene sowie partielle Mailboxstände einzeln, damit die Zwei-Stunden-Grenze am Folgetag ohne unnötige Wiederholungen fortgesetzt wird. Die mitgelieferte Thunderbird-Erweiterung meldet neue Nachrichten sowie neue oder geänderte Kontakte an die lokale App.

Fehleranalyse

Unter logs\mailadressdaten.log führt die App ein rotierendes Diagnoseprotokoll. Unerwartete Fehler werden zusätzlich anonymisiert in logs\last-error.json beschrieben. Mailtexte und Kontaktdaten werden nicht protokolliert.

Updates

Beim Start wird höchstens einmal täglich geprüft. Erst wenn eine neuere veröffentlichte Version erfolgreich erkannt wird, beginnt eine Frist von 90 Tagen. Netz-, DNS- oder Serverfehler starten keine Frist. Nach Ablauf ist vor der weiteren Extraktion ein Update erforderlich.