Synchronize all the items of a Google Keep list with a filter in Taskwarrior. The taskwarrior filter may be a tag, a project or a combination of a project and arbitrary tags.
Upon execution, tw_gkeep_sync
will synchronize, and on subsequent runs of the
program keep synchronized, the following attributes:
- Text of Google Keep list item <-> TW task title
- Whether a Google Keep list item is checked ✅ or unchecked <-> TW task completion status
- Google Keep list item item block is deleted <-> TW task deletion
To synchronize all the items of a Google Keep list called "Test Note" with a tag called "test_tag" you can use something like:
tw_gkeep_sync -t test_tag -k "Test Note"
See the Credentials section on how to authenticate with Google.
Install the syncall
package from PyPI, enabling the gkeep
and tw
extras:
pip3 install syncall[gkeep,tw]
We're using the unofficial gkeepapi tool to authenticate and interact with Google Keep. It requires your Google account username and password to do so. If you're using 2FA, you should create a direct password and use that instead.
Read more about this here.
To provide the password, you can either use the GKEEP_USERNAME
and
GKEEP_PASSWD
before running tw_gkeep_sync
or (recommended), use the UNIX
Password Manager to store your username and
password to your Google account and provide the paths to them (use
--user-pass-path ... --passwd-pass-path ...
in this case).
If using the UNIX Password Manager, make sure that you also have the gpg-agent otherwise the tool will always prompt you for your GPG passphrase and will fail if that's not provided.