kiwiz / keep-cli

Terminal-based Google Keep
37 stars 7 forks source link

keep-cli

Google Keep frontend for terminals.

keep-cli is not supported nor endorsed by Google.

This is alpha quality code - take care if using in production! Feel free to open an issue if you have questions, see any bugs or have a feature request. PRs are welcome too!

Installation

pip install google-keep-cli

Screen cast (WIP)

asciicast

Features

Config

Configuration is stored in the ~/.keep. A config file is automatically created if one doesn't already exist, but you can inspect config.example.yml for an example.

Usage

To get a list of commands:

$ keep -h

TUI mode

If you want to manage and view notes via the TUI interface:

$ keep tui

Press ? to see a list of keyboard shortcuts in this mode

Commands

find: Get the IDs of all notes that match the specified criteria

get: View data from a note

set: Update data from a note

sync: Manually trigger a sync (this is typically unnecessary)

import: Import markdown files into Keep

export: Export notes to markdown files

Note about performance

A sync is performed automatically prior to every command. This is useful for simple usage, as it ensures that the data is up to date, but can be slow if performing a large number of actions. To work around this, pass the --offline flag to operate on the local cache and then flush all changes with a manual sync.

Example:

$ keep sync
$ keep --offline set --note id1 --text One
$ keep --offline set --note id2 --text Two
$ keep --offline set --note id3 --text Three
$ keep sync

Todo

There are still many missing/incomplete features: