Plugin icon

Note encryption


A joplin plugin, encrypt selected notes on the joplin desktop client. This plugin will modify the notes according to your instructions, please read the precautions before use.

Additional Information

Maintainers: ztbxxt
Minimum app version:1.6
Downloads: This version:1016
Last updated:2023-04-30T09:39:14Z


This is a fork branch from

Joplin Encryption Plugin

This is a joplin notebook plugin. Compatible with Joplin 2.9.17


  • click the top-right lock icon to encrypt.

  • Every time when you re-enter the encrypted note, the unlock dialog pop-up.(can be toggle off in setting)

  • The plugin prohibits modification of encrypted files, but it can be modified without installation of the plugin, including mobile APP;The modified encrypted file cannot be decrypted properly. If you want to edit the encrypted note, enable modification in advance setting.

  • Use a specified prefix string to determine if it is an encrypted document, so Do not write the same string at the beginning of your normal document, for the same reason that if you change this string in an encrypted file, then the disabling function will be disabled.

Key strings change with updating.

version prefix string encode version string data spliter initialization vector
1.0.0 [[crypted]] <br/>


  • It has been tested under Windows 7/10, Linux Mint, Manjaro. It should work properly with joplin desktop version under Windows, MacOS and Linux; IOS(?) and Android platform versions don't support plugins yet;

  • The plugin uses CryptoJS to encrypt text and does not encrypt attachments. Data security depends on the CryptoJS library;

  • NO password retrieval function, not anywhere to save the password, password lost without any means to recover;

  • The note-history may leak sensitive information. It can be avoid by disabling note history;

    Suggestion: Use a different profile to take private note, and toggle the history-note off in this profile. Profile settings on menu bar file -> Switch profile ->.

    Another way: Toggle the histroy-note off before decrypt a note, and toggle history-note on after encrypt.(Toggling history-note off won't delete note history in database.)

    More about note-history

    Note history now in Joplin

    Note-history user document

    Note-history specification

  • This is a disposable encryption-decryption, every time you decrypt a note, you have to manually re-encrypt it;

  • The Plugin is NOT COMPATIBLE with rich text editor, don't use it to encrypt notes in this edit mode.(Editor mode switch button on top-right second line.)


Copy the publish/File_encryption.jpl file to your computer and import the plugin with Joplin

Encryption detail

  • algorithm:AES;
  • encryption encode:BASE64;
  • encryption mode:CBC;
  • key:
    character:16 UTF8 8-bit character (digit, latin-letter, ascii symbol);
    suppose the key is 12345abc+, it will be filled with 0 like 12345abc+0000000;
  • initialization vector(iv): (128-bit) randomly generated, at the end of the note(update 1.0.5)
    iv encode: BASE64;
  • padding:Pkcs7;

How to Build

Generator Doc

This is a template to create a new Joplin plugin.

The main two files you will want to look at are:

  • /src/index.ts, which contains the entry point for the plugin source code.
  • /src/manifest.json, which is the plugin manifest. It contains information such as the plugin a name, version, etc.

Building the plugin

The plugin is built using Webpack, which creates the compiled code in /dist. A JPL archive will also be created at the root, which can use to distribute the plugin.

To build the plugin, simply run npm run dist.

The project is setup to use TypeScript, although you can change the configuration to use plain JavaScript.

Updating the plugin framework

To update the plugin framework, run npm run update.

In general this command tries to do the right thing - in particular it's going to merge the changes in package.json and .gitignore instead of overwriting. It will also leave "/src" as well as untouched.

The file that may cause problem is "webpack.config.js" because it's going to be overwritten. For that reason, if you want to change it, consider creating a separate JavaScript file and include it in webpack.config.js. That way, when you update, you only have to restore the line that include your file.


1.1.1 fix the bug, in rich text editor the title can not be edit properly.


Bug report and advice

Leave a issue here or send email to, if you encounter problems or want to give advice.