Getting Started

New release available
Changes made in this release: [GoogleSyncPlugin-2.0.0]

Upgrade from v1.x

This version of plugin is compatible for KeePass Password Safe >= v2.09. It allows to synchronize
the currently open database with a Google Drive Account.

Version 2.0 of this Plugin is not compatible with the configuration of previous versions.

Discussion: [81f69f55]

When upgrading from version 1.x you should first remove all old configuration
settings and revoke the API access.

1. Exit and Close KeePass. Make sure it is not running at all (in case it is minimized to tray instead of taskbar).
2. Locate your keepass.config.xml.
   • e.g. C:\Users[User]\AppData\Roaming\KeePass
   • For portable versions, look in the same directory as KeePass.exe executable
3. Edit your keepass.config.xml file and remove all <item> entries in the
   <custom> group for the old Plugin. Those are items with <key>
   "EnableAutoSync", "GoogleSyncKeePassUID", "GoogleSyncClientID"
   and "GoogleSyncClientSecret". Delete from <item> to </item> (including).</key></custom></item>
4. Save your changes to keepass.config.xml and close the file
5. Go to https://security.google.com/settings/security/permissions
6. Select your KeePass Google Sync Plugin from the list of Account Permissions.
   It may be called "KeePassPlugin" or whatever you named it initially.
7. Click on "Revoke access".

Requirements

The Plugin requires the .NET Framework 4.0 on the system.

The Plugin requires creating a Project with the Google Developers Console to
obtain OAuth 2.0 credentials to access the Google Drive:

1. Go to the Google Developers Console in your Google Account:
   https://console.developers.google.com/project
2. Create a new project called: "KeePass Google Sync Plugin"
3. Enable the Google Drive API at "APIs & auth" > "APIs".
4. Choose an e-mail address at "APIs & auth" > "Consent screen".
5. Set the product name for the consent screen to "KeePass Google Sync Plugin".
6. Create OAuth 2.0 credentials for an "Installed application" with application type "Other". ("APIs & auth" > "Credentials")

You should now have a "CLIENT ID" and "CLIENT SECRET".

Installation

1. Place the "GoogleSyncPlugin.plgx" file into the "plugins" directory of your
   KeePass installation. For portable version, place the "GoogleSyncPlugin.plgx" directly into the KeePass directory
2. Open a KeePass database.
3. Make sure you have a password entry for your Google Account. If that entry
   has the URL "accounts.google.com" associated, you can skip the next step.
4. Go to the "Properties" tab of that entry and copy the UUID at the bottom.
5. Go to "Tools" > "Google Sync Plugin" > "Configuration".
6. Either select your Google Account from the drop-down list or paste the UUID
   into the "KeePass UUID" field.
7. Provide the OAuth 2.0 "CLIENT ID" and "CLIENT SECRET" you created earlier.

The Plugin is now ready to work. On first use Google will ask for your
consent to access your Google Drive.

The complete credit for the above instructions as well as v2.0 changes goes to uran235

The old instructions for v1.x can be found here [1.x Installation Instructions]

Previous release logs

• [GoogleSyncPlugin-1.6.0]
• [GoogleSyncPlugin-1.5.1]
• [GoogleSyncPlugin-1.5.x]
• [GoogleSyncPlugin-1.1.x]