Skip to content

marph91/jimmy

Repository files navigation

jimmy

Tool to import your notes to Joplin.

❗ Should only be used if the built-in import of Joplin isn't available for your note format.

For detailed information, take a look at the Documentation.

build lint tests

Quickstart

  1. Download jimmy here: Linux | Windows | MacOS 1
  2. This script requires that the webclipper in Joplin is running. It will connect to Joplin at the first execution.
  3. Examples for the Linux CLI app:
# import a single file supported by pandoc
jimmy-cli-linux libre_office_document.odt

# import all files in a folder
jimmy-cli-linux path/to/folder

# import a Google Keep export
jimmy-cli-linux takeout-20240401T160516Z-001.zip --format google_keep

After importing, the notes should be available in a new Joplin notebook named like YYYY-MM-DD HH:MM:SS - Import.

❗ Make sure your data is imported properly.

What is converted (in most cases)?

  • Note content
  • Metadata
  • Tags / Labels
  • Resources / Attachments
  • Images
  • External links and internal note links
  • Markdown Front Matter

If something is not working, please check the issues first. If you can't find anything, feel free to create a new issue. It might be just not implemented yet or a regression. On the other side, the exported data can be sparse. In that case it's not possible to transfer the data with jimmy.

Demo

jimmy_import_demo_yuv420.mp4

Similar Projects

Footnotes

  1. The MacOS app is untested.