Skip to content
plugin for notepad++
C++ C Assembly Makefile
Branch: cryptopp
Clone or download
Latest commit dae67b9 Oct 14, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Crypto++ 8.1 Mar 31, 2019
projects/msvc2017 Crypto++ 8.1 Mar 31, 2019
src Rename namespace from 'crypt' to 'nppcrypt' Oct 13, 2019
.gitignore fixed linux build (thx uperetz) Mar 25, 2019
GNUmakefile Unexport LDFLAGS Oct 13, 2019
README.md added md5 hashes for 1.0.1.6 Mar 31, 2019
appveyor.yml 1.0.1.6 final readme etc changes Mar 31, 2019

README.md

nppcrypt

Build status

encryption-tool / plugin for notepad++ (https://notepad-plus-plus.org).

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

download:

1.0.1.6:

old versions:
  • 1.0.1.5: x86 (md5: 2D5D894EBA15A653FADD1776B66417BB), x64 (md5: B2BD52509310A324E0A8090DFC8CCB70)
  • 1.0.1.4: x86 (md5: 038E4EF7D01858A3ED32F49ACAAADAC5), x64 (md5: 0CE1EE405A930D083F74CB085667E73F)
  • 1.0.1.3: x86 (md5: 0191B7DA5389CE95D637705F13154ED6), x64 (md5: B4F6C5BF060E9F5491EF5E7DF37D8D55)
  • 1.0.1.2: x86 (md5: 08255E55BB4F5FD4ACED2E5849F0FAFA)
  • 1.0.1.0: x86 (md5: B1260E531C39DD1E342D2CE5D85095C2)
email:

kontakt (at) cerberus-design . de

this software uses:

important:

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.

changelog

v1.0.1.6:
  • more ciphers & hashes (thanks to cryptopp 8.0)
  • easy mode (with default encryption), see faq
  • interface improvements (more information etc)
  • user may provide base16/32/64 encoded input
  • user may specify custom IV
  • base32/64 encoding alphabets can be modified, see faq
  • lots of internal improvements & fixes
v1.0.1.5:
  • cryptopp 6.0 & lots of new ciphers
  • interface overhault with more options
  • ...
v1.0.1.4:
  • added ChaCha cipher & BLAKE2 hashes (cryptopp >v.5.6.3 needed)
  • interface improvements
  • major bcrypt bug fixed.
v1.0.1.3:
  • several dialogs (random/covert/hash) are now non-modal and dockable
  • added copy to clipboard buttons

FAQ

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 parsed 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++. also: "save as" does not work for nppcrypt-files!

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, or better, see google), random iv

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

Sadly 1.0.1.6 is not backward compatible (mostly because of a changed header format). Obviously this is quite annoying and will be avoided in the future, but in this case it seemed worth it. Please download an older version (links above), replace nppcrypt.dll in Notepad++\plugins (< Notepad++ 7.6) or %PROGRAMDATA%\Notepad++\plugins\nppcrypt (>= Notepad++ 7.6.1), decrypt your data, then update to 1.0.1.6 and reencrypt. Sorry for the inconvenience...

5. nppcrypt shows me most of what went into the encryption (header), but is there other stuff i might want to know?
  1. bcrypt output is always 23 bytes long ( wikipedia ). therefore it is hashed by keccak-shake128 to get the needed key-length.
  2. some cipher modes provide authentication (gcm/ccm/eax). In advanced mode you will have the possibility to add IV and Salt as additional authenticated data. Just click the checkbox "auth. IV/Salt".
  3. 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 https://github.com/jeanpaulrichter/nppcrypt.git
cd nppcrypt
make
sudo make install
(OR: sudo make install target=global to copy nppcrypt to /usr/bin instead of /usr/local/bin)
make clean
7. the commandline tool

basic usage: nppcrypt [enc|dec|hash] input. see --help for information about options. 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". examples:

decrypt .nppcrypt file:

nppcrypt dec test.nppcrypt

encrypt file "test.txt" with default settings and save as test.nppcrypt:

nppcrypt enc test.txt -o test.nppcrypt 

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

nppcrypt download.zip

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 can cannot read utf16-encoded nppcrypt-files.

9. easy mode

1.0.1.6 introduces "easy mode" for new users that only asks for a password and hides all other options. In this mode a set of default options will be used for encryption. You can change the default encryption by editing the preferences file %APPDATA%/notepad++/plugins/config/nppcrypt.xml. look for <default_encryption>.

10. base32/base64 alphabets

For everything except the "convert" dialog nppcrypt uses RFC 4648 base64 and DUDE base32. The "convert"-dialog (Nppcrypt->Convert) by default uses RFC 4648 for both base64 and base32. You can change the alphabets used by the convert-dialog in the preferences file: %APPDATA%/notepad++/plugins/config/nppcrypt.xml.

You can’t perform that action at this time.