Contact-Conversion-Wizard

Programm, welches auf einfache Weise Kontaktlisten zwischen verschiedenen Programmen/Geräten konvertiert.

Dieses Programm sucht Mitwirkende. Auch gelegentliche Patches (Tests, CI, Weiterentwicklung) und Dokumentation sind willkommen.

Einsatzzweck

Ursprünglich entstand das Programm, da dem Autor die existierenden Methoden das Outlook Telefonbuch in die Fritz!Box zu übernehmen zu umständlich waren.

Aus dem dem hierfür geschriebenen Programm (ursprünglich ein reines Outlook-zu-Fritz!Box Konvertierprogramm) ist im Laufe der Zeit ein universelles Kontaktlisten-Umwandlungs-Tool geworden, das Kontakte aus einer ganzen Reihe von Quellen importieren kann und eine vielzahl Formate exportieren kann.

Quellcode

Das Programm ist in C# geschrieben (Lizenz GPLv3). Binaries (.exe) zum Herunterladen gibt es in den Releases. Wie bei C#/.NET Programmen üblich, ist es auch unter Linux lauffähig, sofern man eine aktuelle Mono Runtime installiert hat (natürlich ohne Outlook Support).

Projektstruktur und Bauen

Verzeichnis	Inhalt
src/ContactConversionWizard.Core	Bibliothek (.NET Standard 2.0) mit dem Kontaktmodell, Rufnummernbereinigung sowie allen Datei-Importen und -Exporten. Ohne Abhängigkeit zur Oberfläche und damit testbar.
src/ContactConversionWizard	Windows-Forms-Anwendung (.NET Framework 4.8) inkl. Outlook-Anbindung.
tests/ContactConversionWizard.Core.Tests	xUnit-Tests der Bibliothek.

Voraussetzung ist das .NET SDK 10.

dotnet test                                   # Tests ausführen (Windows, Linux, macOS)
msbuild src/ContactConversionWizard -restore -p:Configuration=Release   # Windows: einzelne .exe erzeugen

Release-Builds unter Windows fassen alle Bibliotheken mit ILRepack zu einer einzigen .exe zusammen. Jeder Pull Request wird per GitHub Actions gebaut und getestet. Ein Release entsteht durch Pushen eines Tags wie 3.6.0.0 oder 3.6.0.0-alpha.1 oder durch manuelles Starten des Release-Workflows mit dem Tag-Namen: die .exe wird gebaut und mit Prüfsumme an das Release angehängt, Tags mit Suffix werden als experimentelle Vorabversion (Pre-release) veröffentlicht. Der Release-Text kommt aus .github/release-notes/<tag>.md.

Screenshot

Windows 8.1 Screenshot, das den Contact Conversion Wizard v3.5.0.2 zeigt: Ein GUI Fenster mit 3 Bereichen: Links: Daten laden; Mitte: Daten ansehen; Rechts: Daten abspeichern

Abhängigkeiten

Windows: .NET Framework 4.8 (in Windows 10 und 11 enthalten) Andere: Siehe Linux

Autor, Contributing, Mitmachen

Gerald Hopf entwickelte und stellte das Tool bis Mitte 2016 auf seiner Website zur Verfügung. Im ip-phone-forum wurde über einen Fork nachgedacht. Here it is.

Weitere Tools

Tool	Programmiersprache / Plattform	Web-Version	Import	Export	Lizenz
Contact-Conversion-Wizard	C# bevorzugt Windows; MacOS und Linux ggf. möglich	-	Outlook, Fritz!Box XML, vCard, Fritz!Adr, CSV	Outlook, Fritz!Box XML, vCard, Fritz!Adr, Snom v7, Snom v8, Gigaset Talk&Surf CSV, Aastra, Grandstream, Auerswald, Panasonic	GPLv3
fritzXML2vcard	JavaScript - Node.js Nahezu alle Betriebssysteme	verfügbar	Fritz!Box XML	vCard(s)	MIT
vcard2fritzXML	Java - Nahezu alle Betriebssysteme	-	vCard	Fritz!Box XML	GPLv2