plugin for notepad++
C++ C Assembly Other
Switch branches/tags
Nothing to show
Clone or download
Latest commit e608fe2 Jun 27, 2018


Build status

encryption-tool / plugin for notepad++ (

features: encryption/decryption with symmetric ciphers like aes. hash-functions like sha3. generation of random values (i.e. for passwords), various encoding options.


Although one might not notice it when using only the notepad++ plugin, but is quite a big change. the result (hopefully) is: cleaner code, easier compiling (FAQ) and finally the introduction of a cmdline version of nppcrypt (with linux support!). For more information on the latter see FAQ. A lot of changes mean potentially a lot of bugs. I would be thankful for everybody who has the time to test the new version and especially the commandline tool.

download: from github: (test/alpha)
  • npp plugin x86:: download (md5: AC7DC0F77189905F3BA875286A1269E8)
  • npp plugin x64:: download (md5: F5C907FAA558B1A02F433010252BBD51)
  • commandline tool x86:: download (md5: 097A5D5F7D60A90C0C030F3C8C2B0494)
  • commandline tool x64:: download (md5: 474BF0490ACB1580BC304F20938E4F81)
  • Linux version: see FAQ: compiling nppcrypt
  • x86:: download (md5: 038E4EF7D01858A3ED32F49ACAAADAC5)
  • x64:: download (md5: 0CE1EE405A930D083F74CB085667E73F)

kontakt (at) cerberus-design . de

this software uses:
  • [1] crypto++ version 3.6.5, part of this project under crypto++ ( base64.h and base64.cpp were modified to allow custom linebreaks )
  • [2] tinyxml2 version 2.1.0, part of this project under tinyxml2
  • [3] bcrypt version 1.3, part of this project under bcrypt
  • [4] scrypt version 1.2.1, part of this project under scrypt
  • [5] cli11 part of this project under cli11


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.


  • see About
  • added ChaCha cipher & BLAKE2 hashes (cryptopp >v.5.6.3 needed)
  • interface improvements
  • major bcrypt bug fixed.
  • several dialogs (random/covert/hash) are now non-modal and dockable
  • added copy to clipboard buttons


1. What is this strange xml-stuff above my encrypted data all about?

Well, first of all it would be quite hard to remember all the different options that were used for different encryptions. Secondly a lot of encryptions need additional data (IV, Salt, tag). Select this header together with your encrypted data and all this stuff will be read automaticly. Of course you can just delete the header and only select the encrypted data for decryption. But in this case you have to select all the right options yourself and provide the missing data (i.e. iv).

2. What is a nppcrypt-file?

In the preferences-dialog you can specify a nppcrypt-file-extension (like mp3 doc etc.). If you futhermore check the "enable" box nppcrypt will now monitor all files you open and save with notepad++. for example: you specified the nppcrypt-file-extension "nbak" and now you save a file as "secret.nbak": the encryption dialog will automaticly open and you can choose the encryption-method of your liking. the next time you open this file you will be automaticly asked for your password. #IMPORTANT#: nppcrypt does NOT monitor the auto-backup-feature of notepad++.

3. What are good options for strong encryption?

for example: aes/rijndael 256, gcm , 16-byte salt, scrypt (at least N=14, r=8, p=1, see google), random iv

4. This version fails to decrypt stuff i encrypted with an older version!

well, that should not happen, but... please downgrade to the older version (, decrypt and then reupdate. you might also send the exact problematic encryption-options to kontakt (at) cerberus-design . de

5. nppcrypt shows me most of what went into the encryption (header), but is there other stuff i might want to know?
  1. all user input (passwords...) is converted to utf8.
  2. bcrypt output is always 23 bytes long ( wikipedia ). therefore it is hashed by keccak-shake128 to get the needed key-length.
  3. some cipher modes provide authentication (gcm/ccm/eax). nppcrypt authenticates the IV and Salt data (as base64 strings) and the encrypted data.
  4. nppcrypt can add an additional hmac value to authenticate the data (see auth-tab in encryption-dialog). for this purpose everything beween and in the header and the encrypted data is hashed.
6. compiling nppcrypt
  • Windows:

Download repository, open nppcrypt.sln under projects/msvc2017 and compile the project "nppcrypt" or the project "cmdline" (Microsoft Visual Studio 2017 needed)

  • Linux:
git clone
cd nppcrypt
sudo make install
(OR: sudo make install target=global to copy nppcrypt to /usr/bin instead of /usr/local/bin)
7. the commandline tool

the two most basic options are: -a --action , where you can specify if you want to "hash", "encrypt" or "decrypt" and -o --output, where you specify an output file. Some options allow for additonal information to be passed via the seperator ":". i.e. "-k scrypt:16:9:2" means scrypt with (N=2^16,r=9,p=2) instead of the default values (N=14,r=8,p=1) you would get with "-k scrypt". see --help for more information. examples:

decrypt .nppcrypt file:

nppcrypt -a decrypt test.nppcrypt

encrypt file "test.txt" with default settings:

nppcrypt -a encrypt -o test.nppcrypt test.txt

get md5, sha1 and sha3 hash of file "" (and optionally check hex-string against it):


get blake2s hash of "teststring"

nppcrypt --hash blake2s teststring
8. text encodings

the notepad++ plugin will work with utf16/ucs-2 files, but if you want to use nppcrypt it is recommended that you only use utf8 files. the commandline tool writes only utf8 files and cannot read utf8-encoded nppcrypt-files.