Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Google Photo to VCard

A set of scripts to download profile images from Google and write them to vcards. Useful for completing the migration from Google to Nextcloud or ownCloud.

As a fallback, if a user doesn't have a Google profile photo, the script will check Gravatar.


To run, you first need to set up a few config files

Google Credentials

To get people info from your Google account, you first need to create an application from the Google Cloud Console and then download your credentials.

  1. Go to and create a new project
  2. Add access to the Google People API (Library > Search for People > Enable)
  3. Create a new set of credentials (Credentials > Create credentials > OAuth client ID > other (Give it a name) > Create)
  4. Click the download icon next to the new credentials and save to this project directory as client_secret.json

Vdirsyncer Config

This is the config that will allow you to sync to and from your remote VCard directory. The following instructions are for Nextcloud, but you can refer to the official documentation for more instructions.

Edit ./vdirsyncer.conf.example adding your server url, username, and password in the [storage my_contacts_remote] section.


Once your configuration is set up, you should be able to download and add photos to all your contacts by executing:

make add-photos

It's then worth taking a look and making sure that the results are as you expected. When you're happy with them, you can push the contacts back up to your remote server by running:

make sync-contacts