A Proof-Of-Concept FUSE filesytem that gives access to your Joplin notes.
Currently the Joplin Filesystem is readonly, but that will eventually change if there is interest.
This is a simple system that takes advantage of the hierarchical layout of notebooks in Joplin. Essentially it's a translation layer between the filesystem primitives and the Joplin API. Put simply, this allows you to select a folder on your computer and access all of your Joplin notes/notebooks as if they were stored in that folder.
(Only tested on Ubuntu 20.04 with Python 3.7)
$ tree <mount_folder>
.
├── .links
| ├── <...>
├── .tags
| ├── <...>
└── <folders>
The .links directory is a helper folder to make linking easy. It contains a symlink (named by id) to every note and resource. This makes it easy to take a Joplin link [title](:/f9a1ba9631c346efa7ca1eb1d38dd64f) and turn it into [title](/path/to/mount/.links/f9a1ba9631c346efa7ca1eb1d38dd64f).
The .tags folder holds all the tags as subfolders. Each tag subfolder contains symlinks all notes with that tag.
The <folders> are just all the top level folders in Joplin. They represent the notebook/note structure of Joplin.
Ensure you have a valid python installation (tested on python 3.7, but should work up to 3.9).
Install dependencies, either:
poetry install
or
pip install -r requirements.txt
For testing, run with:
python src/filesystem.py --mount <mount folder> --token <joplin webclipper token>
There are also optional --host and --port options, but the defaults should work for most people.
All options can alternatively be specified with environment variables eg. JOPLINFS_MOUNT and JOPLINFS_TOKEN.
That's it! Now you'll have (read-only) access to all your Joplin notes from <mount folder>.
- Support writing to notes
- This only a thin wrapper around the Joplin API, so mass operations (like grep) will be very slow and are not recommended.
- This implementation uses the API for both reading and writing, a more performant implementation would be able to use the database for reading and only hit the API for a write.
- Metadata about notes and folders are stored in memory, this means the mount will start to consume large amounts of RAM if you have a lot of notes/folder (< 1,000,000 shouldn't be an issue for most computers)
- Resources are ignored and won't be viewable if the markdown is passed in to a renderer