This is a simple script to sync your Google Keep notes with Bring shopping lists and vice versa. IMPORTANT: Read the whole readme, there are some special things to get it working.
This script is not affiliated with Google or Bring. It is not guaranteed to work and may break at any time. Use at your own risk.
A sample Dockerfile is provided. You can also run it directly with Python (Only tested with 3.10 but should also work with 3.8+).
You need to provide the following environment variables:
- See https://gkeepapi.readthedocs.io/en/latest/#obtaining-a-master-token
- And for oauth value: https://github.com/simon-weber/gpsoauth#alternative-flow
Save the token in a file called token.txt in the same directory as the script or provide it as an environment variable GOOGLE_TOKEN
| Variable | Description | Default | Required |
|---|---|---|---|
GOOGLE_EMAIL |
Your Google account email address | Yes | |
KEEP_LIST_ID |
Your Google Note ID (visible in the URL when selecting a Note in the webapp) | Yes | |
BRING_EMAIL |
Your Bring account email address | Yes | |
BRING_PASSWORD |
Your Bring account password | Yes | |
SYNC_MODE |
0 = bidirectional, 1 = bring master, 2 = google master | 0 | No |
TIMEOUT |
Timeout between syncs in minutes | 0 = only run once (with the provided docker-compose it will restart infinitely) | 60 | No |
BRING_LIST_NAME |
Name of your Bring List | Using first list in Response | No |
GOOGLE_TOKEN |
Master Token (See ### Acquire Master token) | No |
| Mode | Description |
|---|---|
| 0 | Bidirectional sync. Changes in Google Keep will be reflected in Bring and vice versa. |
| 1 | Bring master. Changes in Bring will be reflected in Google Keep. Google Keep changes will be ignored. |
| 2 | Google master. Changes in Google Keep will be reflected in Bring. Bring changes will be ignored. |
- The token.txt file is used to store the Google Auth token. Keep it safe as it can be used to gain full access to your Google account.
- At the first run the script will take the keep and bring lists and merge them (Only with SYNC_MODE 0). After that it will only sync changes.
- For me only host network works with the docker container.
RealPotatoe - Proofreading and general improvements