Convert Nextcloud Contacts to GEQUDIO XML

This script converts contacts exported from Nextcloud in vCard format to GEQUDIO XML format, which can be imported into GEQUDIO phones.

• Installation and Usage
• Importing Contacts to Your Gequdio Phone

Installation and Usage

• Ensure you have Python 3.10 or higher installed on your system.
• Create a virtual environment and activate it:

  python3 -m venv venv
  source venv/bin/activate
  

• Install the package using pip:

  pip install nextcloud-contacts-to-gequdio==3.0.0
  

• Copy the settings file and modify it with your details:

  wget https://raw.githubusercontent.com/ppfeufer/nextcloud-contacts-to-gequdio/refs/heads/master/nextcloud_contacts_to_gequdio/settings.ini.example
  mv settings.ini.example settings.ini
  

  You should now have the following structure:

  .
  ├── venv
  └── settings.ini
  

• Edit the settings.ini file and fill in the required information:
  • url: The URL of your Nextcloud instance.
  • username: Your Nextcloud username.
  • password: Your Nextcloud password.
  • addressbook: The name of the address book to export contacts from. (Default is "contacts")
• Run the script:

  /path/to/your/venv/bin/nextcloud-contacts-to-gequdio
  

• Create a cron job to run the script periodically if desired.

  crontab -e
  

  Add the following line to run the script every day at midnight (Change the cron schedule as desired):

  0 0 * * * /path/to/your/venv/bin/nextcloud-contacts-to-gequdio
  

The cron job will execute the script at the specified intervals, creating or updating the gequdio.xml (which can be found in the same directory as your venv folder and settings file) file with the latest contacts from Nextcloud. It is up to you to ensure that your GEQUDIO phone fetches the updated gequdio.xml file as needed. This may involve hosting the file on a web server or using another method to make it accessible to your phone.

Importing Contacts to Your Gequdio Phone

• Import the generated gequdio.xml file into your GEQUDIO phone as per its instructions.
• Enjoy your synchronized contacts!