Skip to content

Latest commit

 

History

History
60 lines (41 loc) · 2.06 KB

readme-tw-gkeep.md

File metadata and controls

60 lines (41 loc) · 2.06 KB

Description

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

Usage example

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.

Demo

tw-gkeep-demo

Installation

Package Installation

Install the syncall package from PyPI, enabling the gkeep and tw extras:

pip3 install syncall[gkeep,tw]

Credentials

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.