Google Keep to Weavernote Converter 📝➡️🐦‍🔥

This script converts your Google Keep archive into Weavernote-compatible Markdown files - with support for:

• 🖼 Embedded images (saved in a folder named after your image URL path)
• ☑️ Checklists (as markdown task lists)
• 🏷 Labels (all labels, including 'pinned', in the yaml frontmatter)
• 📅 Created/modified timestamps
• 🧾 UTF-8/emoji compatibility

Tested with:

• 5,000+ notes

• 500MB of HTML, JSON, and images from Google Takeout

📤 How to Export Your Google Keep Data

1. Go to Google Takeout
2. Deselect everything, then enable only Keep
3. Export and download the .zip file
4. Unzip it - inside Takeout/Keep/ you'll find:
   • .html files (one per note)
   • .json files (metadata)
   • any attached images (.jpg, .png, .gif, etc.)

👉 Copy all of those files (flat) into the keep_source/ folder in this repo.

Requires beautifulsoup4.
See Troubleshooting if you hit an import error.

🚀 Quick Start

1. Put your extracted Keep files (HTML, JSON, and images) into keep_source/

2. Run the converter:

python google-keep-to-weavernote.py

• The script will prompt you for a public image URL prefix (e.g. https://www.example.com/images).
• It will create a folder in weavernote_output/ named after the last segment of your URL (e.g. images for the above).
• All images will be saved in that folder, and a readme.txt will be included with upload instructions and the URL you provided.
• Markdown notes will reference images using the provided URL.
• All Markdown notes will be saved directly in weavernote_output/ (no subfolders for tags/labels).
• The YAML frontmatter in each note will include:
  • labels: - all labels from Google Keep, including pinned if the note is pinned (comma-separated)
  • tags: - always blank
• After running the script, upload the entire images folder to your server at the provided path.
• Import the Markdown notes into Weavernote.

📁 Folder Structure

.
├── google-keep-to-weavernote.py         # ← the script
├── keep_source/            # ← your Keep HTML/JSON/image files go here
├── weavernote_output/       # ← final Markdown files + images + log
    ├── <images-folder>/    # ← all embedded images (named after your URL path)
    │   └── readme.txt      # ← upload instructions and URL
    ├── Sample Note 01.md   # ← notes (all in this folder)
    ├── ...

✅ Features

🛠️ Troubleshooting

ModuleNotFoundError: No module named 'bs4'

This means the script is missing the BeautifulSoup library.

Fix it by running:

pip install beautifulsoup4

Then run the script again:

python google-keep-to-weavernote.py

If you're using a virtual environment, make sure it's activated before installing.

📄 License

This project is licensed under the MIT License.

Contributions are welcome - feel free to fork, open issues, or submit pull requests to make this better for others migrating their notes.