Handy tools to use with the Joplin note application
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Joplin Tools

This is a collection tools that perform some handy operations on Joplin notes.

See Joplin Home for more information on Joplin.

NOTE This is WIP/WFM (Work In Progress, Works For Me). YMMV.


This is a simple script that can be used to add notes to Joplin. It uses the Joplin Web Clipper API.

Supported are text documents and images (jpg, gif, png).


perl addnote.pl [ options ] document

Relevant options:

--parent=XXX    note parent (defaults to "Imported Notes")

--title=XXX     title (optional)

The document will be added to the notes collection into the parent folder.


This tool is similar to addnote.pl, but it doesn't use the Web Clipper API and hence does not require a running Joplin instance. Instead, it uses the cloud storage.

In my setup, all Joplin clients synchronize to an ownCloud server. The relevant parts of the ownCloud storage are mirrored, using the native ownCloud client, to a desktop PC. So on the PC I have full access to the folder with Joplin notes.

When addnote_cloud.pl adds a new note, it inspects the folder with existing notes, tries to find the parent folder, and creates a new note file that contains the data and Joplin metadata. This file will be synchronized to the cloud server and eventually all clients will receive the new note from the server.


perl addnote_cloud.pl [ options ] document

Relevant options: same as addnote.pl, plus:

--dir=XXX       the location of the Joplin notes on disk

--folder        create a new notebook