https://github.com/ppfeufer/nextcloud-contacts-to-gequdio
Convert Nextcloud contacts to GEQUDIO XML
https://github.com/ppfeufer/nextcloud-contacts-to-gequdio
contacts gequdio nextcloud
Last synced: 19 days ago
JSON representation
Convert Nextcloud contacts to GEQUDIO XML
- Host: GitHub
- URL: https://github.com/ppfeufer/nextcloud-contacts-to-gequdio
- Owner: ppfeufer
- License: gpl-3.0
- Created: 2025-12-05T18:16:39.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2025-12-29T11:19:04.000Z (5 months ago)
- Last Synced: 2026-01-01T05:45:46.066Z (5 months ago)
- Topics: contacts, gequdio, nextcloud
- Language: Python
- Homepage:
- Size: 88.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# Convert Nextcloud Contacts to GEQUDIO XML
[](https://pypi.org/project/nextcloud-contacts-to-gequdio/)
[](https://github.com/ppfeufer/nextcloud-contacts-to-gequdio/blob/master/LICENSE)
[](https://results.pre-commit.ci/latest/github/ppfeufer/nextcloud-contacts-to-gequdio/master)
[](http://black.readthedocs.io/en/latest/)
[](https://github.com/ppfeufer/nextcloud-contacts-to-gequdio/actions/workflows/automated-checks.yml)
[](https://codecov.io/gh/ppfeufer/nextcloud-contacts-to-gequdio)
[](https://ko-fi.com/N4N8CL1BY)
This script converts contacts exported from Nextcloud in vCard format to GEQUDIO XML
format, which can be imported into GEQUDIO phones.
______________________________________________________________________
- [Installation and Usage](#installation-and-usage)
- [Importing Contacts to Your Gequdio Phone](#importing-contacts-to-your-gequdio-phone)
______________________________________________________________________
- Ensure you have Python 3.10 or higher installed on your system.
- Create a virtual environment and activate it:
```bash
python3 -m venv venv
source venv/bin/activate
```
- Install the package using pip:
```bash
pip install nextcloud-contacts-to-gequdio==2.0.2
```
- Copy the settings file and modify it with your details:
```bash
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:
```bash
/path/to/your/venv/bin/nextcloud-contacts-to-gequdio
```
- Create a cron job to run the script periodically if desired.
```bash
crontab -e
```
Add the following line to run the script every day at midnight (Change the cron
schedule as desired):
```cron
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!