CardDAV contacts import for AVM FRITZ!Box

This is a completely revised version of https://github.com/jens-maus/carddav2fb.

Features

download from any number of CardDAV servers
read from any local *.vcf files (optional)
selection (include/exclude) by categories or groups (e.g. iCloud)
upload of contact pictures to display them on the FRITZ!Fon (handling see below)
automatically preserves quickDial and vanity attributes of phone numbers set in FRITZ!Box Web GUI. Works without config.
automatically preserves internal numbers (e.g. if you use Gruppenruf)
if more than nine phone numbers are included, the contact will be divided into a corresponding number of phonebook entries (any existing email addresses are assigned to the first set [there is no quantity limit!])
phone numbers are sorted by type. The order of the conversion values ('phoneTypes') determines the order in the phone book entry
the contact's UID of the CardDAV server is added to the phonebook entry (not visible in the FRITZ! Box GUI)
automatically preserves QuickDial and Vanity attributes of phone numbers set in FRITZ!Box Web GUI. Works without config. These data are saved separately in the internal FRITZ!Box memory under ../FRITZ/mediabox/Atrributes.csv from loss.
generates an image with keypad and designated quickdial numbers (2-9), which can be uploaded to designated handhelds (see details below)

Requirements

PHP >7.3 or 8.0 (apt-get install php php-curl php-mbstring php-xml)
Composer (follow the installation guide at https://getcomposer.org/download/)

Installation

Install requirements

git clone https://github.com/andig/carddav2fb.git
cd carddav2fb
composer install --no-dev

edit config.example.php and save as config.php

Usage

List all commands:

./carddav2fb list

Complete processing:

./carddav2fb run

Get help for a command:

./carddav2fb run -h

Preconditions

memory (USB stick) is indexed [Heimnetz -> Speicher (NAS) -> Speicher an der FRITZ!Box]
ftp access is active [Heimnetz -> Speicher (NAS) -> Heimnetzfreigabe]
you use an standalone user (NOT! dslf-config) which has explicit permissions for FRITZ!Box settings, access to NAS content and read/write permission to all available memory [System -> FRITZ!Box-Benutzer -> [user] -> Berechtigungen]

Upload FRITZ!Fon background image

Using the background-image command it is possible to upload the quickdial numbers as background image to FRITZ!Fon (nothing else!)

./carddav2fb background-image

Uploading can also be included in uploading phonebook:

./carddav2fb run -i

Image upload preconditions

requires FRITZ!Fon C4 or C5 handhelds
settings in FRITZ!Fon: Einstellungen -> Anzeige -> Startbildschirme -> Klassisch -> Optionen -> Hintergrundbild
assignment is made via the internal number(s) of the handheld(s) in the 'fritzfons'-array in config.php
internal number have to be between '610' and '615', no '**'-prefix

Debugging

For debugging please set your config.php to

'http' => 'debug' => true

Docker image

The Docker image contains the tool and all its dependencies. A volume /data contains the configuration files. If the configuration is missing, the Docker entrypoint will abort with an error message and copy an example file to the volume.

There are two ways to use the image:

docker run --rm -v ./carddav2fb-config:/data andig/carddav2fb command...

will execute a single command (and remove the created container afterwards).

Without a command, the container entrypoint will enter an endless loop, repeatedly executing carddav2fb run in given intervals. This allows automatic, regular updates of your FRITZ!Box's phonebook.

License

This script is released under Public Domain, some parts under GNU AGPL or MIT license. Make sure you understand which parts are which.

andig / carddav2fb

readme