This is a ~90% PR, but I'm not going to have time to work on this for the rest of the week, so figured I'd get it in front of you to consider / comment on.

This adds support for loading settings from a config file using the module https://github.com/phha/click_config_file - it's a pretty decent module - it just loads each command line argument from the specified config file and falls back to normal behavior if no config file or the option is not specified in the config.

I also added support for reading (but not writing) the resume token and using that instead of the password. I couldn't find a good way in Click to make two options mutually exclusive - I wanted token to negate the need for password, but if neither was specified, then prompt for password.

The closest I found to an out-of-the-box solution was this module https://pypi.org/project/click-option-group/ - and some discussions from the project maintainer about how this type of thing was out of scope of the project, which doesn't make much sense to me. Honestly, I got frustrated with trying to implement it and rolled my own that's good enough.

If you have better ideas, please let me know.

Re resume token - I'm not sure:

• how long the resume token lasts for - I've been using the same one for two days now
• if it's any more secure than just storing an app password - the API implies it's still a full account access

I'm just thinking Google is less likely to lock an account that polls frequently as suspicious if it uses the token.

I think the program should probably save an updated token after every run, and I don't consider this really complete until that's done.

As mentioned in #3 and #4 , this:

• uses a markdown library (mdutils) to generate the markdown
• converts the unicode checkbox symbols to markdown syntax
• adds the link annotations to the end of the note

Also:

• strips titles to not have trailing/leading spaces
• adds an "untitled" default for notes with blank titles

I think it's probably even better to use note.children and note.checked to build the check list manually if that's the type of note - so the formatting can be even more safely converted to markdown, but I didn't look to heavily into that.

Hope this helps - but if you don't want to merge this in, that's fine, I'll likely keep my variation on my github for my own use.

I've tried to follow the instructions as best as I can, but can't figure out how to get this working.

First of all, the instructions mentions this file "keep_export", but it's not found in any of the folders.

I've got poetry installed and ran poetry build to build the wheel and everything during the install process went OK. I can't just figure out how to run. I tried running the export.py file and initially I got a click-config-file module missing error. I fixed that by doing pip3 install click-config-file and then I tried again and I got no more errors, but nothing happens when I ran the export.py file.

I've got nothing like what is mentioned in the help file.

Is it possible to remove the extra meta data from the top of exported notes?

color: White deleted: false id: xxxxxxxxxxxxxxxxxx parent_id: root pinned: false sort: '0' timestamps: created: 1414924214.261 edited: 1414929007.851 trashed: -3600.0 updated: 1526783775.947 title: xxxx trashed: false type: List url: https://keep.google.com/u/0/#LIST/xxxxxxxxxxxxxxxxxxxxxxxxx

Other than this, it worked perfectly! Many thanks

Google Keep has a feature called Labels, basically it acts like tags or categories. It would be amazing if they could be converted as tags in the YAML frontmatter. When exporting Google Keep with Takeout it gives a .json file with the metadata and Labels looks as below.

...
    "labels": [
        {
            "name": "tag1"
        },
        {
            "name": "tag2"
        }
    ]
...

Convert from the metadata above to YAML:

tags: tag1, tag2

Details in: https://github.com/ndbeals/keep-exporter/discussions/9#discussioncomment-304904

Differs from your proposed approach, but works well in my testing and gives nice filenames.

See this commit for a first rough pass at this: https://github.com/mbafford/keep-exporter/commit/43447684fd7265866bfe5bd6cd5e386594cccd3d

The images API is undocumented, but I was able to piece together how to get the image URL from looking at the image URL in Google Keep and the gkeepapi code. This commit works for all of my notes as far as I can tell, but I'm sure it fails on some other edge case.

The URL generated by the API is simply:

https://keep.google.com/u/0/media/v2/{note.server_id}/{image.server_id}

when Google Keep references the image, it also adds these parameters:

?accept=image/gif,image/jpeg,image/jpg,image/png,image/webp,audio/aac&sz=4032

There's interesting metadata available in:

note.images[0].blob, e.g.:

'kind':'notes#blob'
'type':'IMAGE'
'mimetype':'image/jpeg'
'width':3024
'height':4032
'byte_size':3162748
'extracted_text':'味全\nwei-chuart\nが\n薺菜態 蝦 .\nChinese Spinach[...]'
'extraction_status':'VSS_SUCCEEDED'

No original image filename that I can find.

TODO

• check mimetype and write files with correct filenames
• write the extracted OCR text to the markdown file or a sidecar JSON file?
• not sure if the download has to happen through the keepAPI requests session
• other types of images (drawings?) may be very different

When you add a link to a keep note, Google adds the link as an annotation. These persist even if the link text is removed from the note.

These can be added with something like this:

    if note.annotations.links:
        text = text + "\n## Links \n\n"

        for a in note.annotations.links:
            text += "- [%s](%s)\n" % ( a.title, a.url )

Probably better to use a Markdown formatter to ensure the link title/URL won't cause problems.

Just leaving this here for anyone encountering the same issue. From: https://github.com/kiwiz/gkeepapi/issues/81#issuecomment-762884244

If you install using pipx you might have issues with authentication failing. This isn't an issue with the username/password, but an issue with one of the Python libraries. If you use 2.23.0 of requests, it works perfectly:

pipx install keep-exporter 
pipx inject keep-exporter requests===2.23.0

I was then able to set up keep-exporter and sync my notes, using a Google app password.

Thank you for publishing this project.

Discussed in https://github.com/ndbeals/keep-exporter/discussions/10

Discussed in https://github.com/ndbeals/keep-exporter/discussions/11 by @mbafford

This has been broken for a couple of months, fails with this error:

Error: Invalid value: Password login failed: ('NeedsBrowser', 'To access your account, you must sign in on the web. Touch Next to start browser sign-in.')

In almost all of my files every few lines, seemingly at random, the content of checkboxes have been split into several lines like this:

- [ ] Lorem ipsum 
dolor sit amet
- [ ] Lorem ipsum dolor sit amet
- [ ] Lorem ipsum dolor sit amet
- [ ] Lorem 
ipsum 

Some even have been split like so, breaking the checkbox:

- [
 ] Lorem ipsum dolor sit amet
- 
[ ] Lorem ipsum dolor sit amet