************************
**                    **
** Cryptermite v3.0a  **
**                    **
** Instruction Manual **
**                    **
************************

====================================================================
********************************************************************
====================================================================

Overview:
---------

Cryptermite allows you to encrypt and decrypt files and messages very easily.
Have a secure chat with support for file transfer.
You can hide files inside images using steganography.
Have a private forums for non-live conversations.
Also allows you to generate Bitcoin addresses safely.
All with the most advanced and secure encryption algorithms.

====================================================================
********************************************************************
====================================================================

Cryptermite License (Freeware):
-------------------------------

You are free to use Cryptermite for non-commercial and commercial uses.
You can't modify .EXE file of Cryptermite.
You can't sell Cryptermite.

====================================================================
********************************************************************
====================================================================

DISCLAIMER:
-----------

This software uses strong cryptography provided by Crypto++ ( https://www.cryptopp.com/ ), so even if it is created, maintained and distributed from liberal countries in Europe (where it is legal to do this), it falls under certain export/import and/or use restrictions in some other parts of the world. For this reason, please read the legal notices below.

PLEASE REMEMBER THAT EXPORT/IMPORT AND/OR USE OF STRONG CRYPTOGRAPHY SOFTWARE, PROVIDING CRYPTOGRAPHY HOOKS OR EVEN JUST COMMUNICATING TECHNICAL DETAILS ABOUT CRYPTOGRAPHY SOFTWARE IS ILLEGAL IN SOME PARTS OF THE WORLD. SO, WHEN YOU IMPORT THIS SOFTWARE TO YOUR COUNTRY, RE- DISTRIBUTE IT FROM THERE OR EVEN JUST EMAIL TECHNICAL SUGGESTIONS TO THE AUTHOR OR OTHER PEOPLE YOU ARE STRONGLY ADVISED TO PAY CLOSE ATTENTION TO ANY EXPORT/IMPORT AND/OR USE LAWS WHICH APPLY TO YOU.
THE AUTHORS OF Crypto++ ARE NOT LIABLE FOR ANY VIOLATIONS YOU MAKE HERE. SO BE CAREFUL, IT IS YOUR RESPONSIBILITY.

THE AUTHOR OF THIS SOFTWARE WILL NOT BE HELD LIABLE FOR THE VIOLATION OF ANY LAW THAT GOVERNS THE IMPORT/EXPORT OF STRONG CRYPTOGRAPHY SOFTWARE.
IT IS YOUR RESPONSIBILITY TO DETERMINE WHICH OF THESE LAWS MAY APPLY TO YOU BEFORE OBTAINING ANY CRYPTOGRAPHIC SOFTWARE.

It is illegal to use cryptography for criminal or terrorist purposes.

====================================================================
********************************************************************
====================================================================

Main features:
--------------

    - Files and messages encryption.
    - Encrypted messages are always different even if the same message is encrypted with the same password.
    - Six encryption algorithms (AES, Serpent, TwoFish, BlowFish, Triple DES and RSA).
    - Symmetric and asymmetric encryption algorithms.
    - Digital files signatures.
    - Maximum level of encryption: AES-256 bits and RSA-8192 bits.
    - Hide any type of file inside images using steganography. Up to only one bit modification per pixel with pseudo random scattering.
    - Bitcoin address generator for Bitcoin wallets. Random and deterministic generator.
    - Hash codes generator for messages and files. Support SHA256, SHA512, SHA1, RIPEMD160, MD5, MD4 and CRC32.
    - Generate a self-extracting .EXE of encrypted file.
    - Secure Chat and File Transfer (true point-to-point) with AES-256 encryption.
    - Private Forums for non-live conversations with AES-256 encryption.
    - Passwords Manager.
    - Portable application.

====================================================================
********************************************************************
====================================================================

Compatibility and system requirements:
--------------------------------------

    Cryptermite is compatible with Microsoft Windows XP / Vista / 7 / 8.1 and 10

    Minimum system requirements:

    Operating System: Microsoft Windows XP
    CPU: Pentium IV (Prescott) @ 2 Ghz
    RAM: 1 GB
    HDD space: 70 MB
 
    System requirements:

    Operating System: Microsoft 7
    CPU: Core 2 Duo @ 2 Ghz
    RAM: 1 GB
    HDD space: 90 MB

    Recommended system requirements:

    Operating System: Microsoft Windows 10
    CPU: Core i5 @ 2 Ghz
    RAM: 2 GB
    HDD space: 100 MB
 
====================================================================
********************************************************************
====================================================================

How to encrypt a file with symmetric key encryption.
The same password is used to encrypt and decrypt.
----------------------------------------------------

Required:
	- File to encrypt.
	- New password to encrypt file.

Procedure:
	1. Select Encrypt Process.
	2. Select the encryption algorithm to use. There are five available. AES is the best.
	3. Select file to encrypt in 'File to encrypt' field.
	4. Enter a password in 'Password' field and repeat in 'Verify' field.
	5. Press 'Encrypt file' button.

Output:
	- The encrypted file is generated with '.cry' extension.

====================================================================
********************************************************************
====================================================================

How to decrypt a file with symmetric key encryption.
The same password is used to encrypt and decrypt.
----------------------------------------------------

Required:
	- File to decrypt ('.cry' extension).
	- Password to decrypt file.

Procedure:
	1. Select Decrypt Process.
	2. Select the decryption algorithm to use. The same used in the encryption process.
	3. Select file to decrypt in 'Encrypted file' field.
	4. Enter password in 'Password' field. The same used in the encryption process.
	5. Press 'Decrypt file' button.

Output:
	- The decrypted file is generated.

====================================================================
********************************************************************
====================================================================

How to encrypt a message:
-------------------------

Required:
	- Text message to encrypt.
	- New password to encrypt message.

Procedure:
	1. Select Encrypt Process.
	2. Select the encryption algorithm to use. There are five available. AES is the best.
	3. Enter or paste text message in 'Message Input' box.
	4. Enter a password in 'Password' field and repeat in 'Verify' field.
	5. Press 'Encrypt message' button.

Output:
	- The encrypted message will be displayed in 'Message Output' box.

====================================================================
********************************************************************
====================================================================

How to decrypt a message:
-------------------------

Required:
	- Encrypted message.
	- Password to decrypt message.

Procedure:
	1. Select Decrypt Process.
	2. Select the decryption algorithm to use. The same used in the encryption process.
	3. Paste encrypted message in 'Message Input' box.
	4. Enter password in 'Password' field. The same used in the encryption process.
	5. Press 'Decrypt message' button.

Output:
	- The decrypted message will be displayed in 'Message Output' box.

====================================================================
********************************************************************
====================================================================

How to encrypt a file with asymmetric key encryption.
Public Key to encrypt and Private Key to decrypt.
-----------------------------------------------------

Required:
	- File to encrypt.
	- Public Key of the person or company that will decrypt the file.

Procedure:
	1. Select Encrypt Process.
	2. Select the encryption algorithm to use. There are five available. AES is the best.
	3. Check RSA key.
	4. Select file to encrypt in 'File to encrypt' field.
	5. Select Public Key file in 'Public key' field.
	6. Press 'Encrypt file' button.

Output:
	- The encrypted file is generated with '.cry' extension.

Note:	
	The file is encrypted using a hybrid system: selected encryption algorithm and RSA algorithm.

====================================================================
********************************************************************
====================================================================

How to decrypt a file with asymmetric key encryption.
Public Key to encrypt and Private Key to decrypt.
-----------------------------------------------------

Required:
	- File to decrypt.
	- Your Private Key that is the pair of the Public Key that was used to encrypt the file.
	- Password of the Private Key.

Procedure:
	1. Select Decrypt Process.
	2. Select the decryption algorithm to use. The same used in the encryption process.
	3. Check RSA key.
	4. Select file to decrypt in 'Encrypted file' field.
	5. Select your Private Key file in 'Private key' field.
	6. Enter password in 'Password' field. The same used when generating the pair of RSA keys.
	7. Press 'Decrypt file' button.

Output:
	- The decrypted file is generated.

====================================================================
********************************************************************
====================================================================

How to generate a pair of RSA keys (Public key and Private key):
----------------------------------------------------------------

Required:
	- Name of the owner of the pair of RSA keys (person or company).
	- New password associated to the Private key.

Procedure:
	1. Enter the name of the owner in 'Message Input' box (without spaces). Example: John_Smith
	2. Enter a password in 'Password' field and repeat in 'Verify' field.
	3. In top menu bar, select 'Generate RSA keys'.
	4. Select the size of the keys. 8192 bits is the best, but 2048 bits is normally used.

Output:
	- The pair of keys will be generated in the 'RSA_keys' folder.
	'.kpub' extension for the Public Key.
	'.kpriv' extension for the Private Key.

Note:
	Never share your Private Keys.
	If your Private Keys are stolen, thieves will not use them without the associated passwords.
	Private Keys are stored encrypted on the disk using AES-256 algorithm.
	Your Public Keys should be shared with people who encrypt files for you using RSA keys.
	It's recommended back up the 'RSA_keys' folder.

====================================================================
********************************************************************
====================================================================

How to sign a file using your RSA Private key.
Anyone, using your Public Key, can verify two things:
Authenticity: You are the person who signed the file.
Integrity: The file has not been modified after signing.
----------------------------------------------------------------

Required:
	- File to sign.
	- Private Key of the person who wants to sign the file.
	- Password of the Private Key.

Procedure:
	1. Select file to sign in 'File sign' field.
	2. Select Private Key file in 'Private key' field.
	3. Enter password in 'Password' field. The same used when generating the pair of RSA keys.
	4. Press 'Sign file' button.

Output:
	- The digital signature of the file will be generated in the 'RSA_signatures' folder ('.sig' extension).

Note:
	The file to be signed doesn't really change. It remains intact.
	The person who wants to verify the signed file needs: the file, the digital signature ('.sig') and the Public Key of the signer.

====================================================================
********************************************************************
====================================================================

How to verify a signed file using RSA Public Key of the signer:
---------------------------------------------------------------

Required:
	- Signed file.
	- Digital signature of the file in the 'RSA_signatures' folder.
	- Public Key of the signer. The file must exist in the 'RSA_keys' folder.

Procedure:
	1. Select file to verify in 'File verify' field.
	2. Select digital signature in 'Signature file' field ('.sig' extension).
	3. Press 'Verify file signature' button.

Output:
	A message will be displayed in the 'Message Output' box verifying or not the signing. Also show the name of the signer.

Note:
	In this case it's not necessary to select the Public Key of the signer, the application will find it automatically if it exists in the 'RSA_keys' folder.

====================================================================
********************************************************************
====================================================================

How to generate a self-extracting .EXE of encrypted file:
---------------------------------------------------------

Required:
	- File to encrypt.
	- New password to encrypt file.

Procedure:
	1. Select Encrypt Process.
	2. Select file to encrypt in 'File to encrypt' field.
	3. Enter a password in 'Password' field and repeat in 'Verify' field.
	4. Check 'Create encrypted .EXE'.
	5. Press 'Encrypt file' button.

Output:
	- The encrypted file is generated with '.exe' extension.

Note:
	- The file is always encrypted using the AES-256 algorithm.

====================================================================
********************************************************************
====================================================================

What is 'Double size' option ?:
-------------------------------

In 'Encrypt Process'
Use this option for duplicate the key length of the algorithms AES, Serpent, TwoFish and BlowFish to increase the encryption security.

In 'Decrypt Process'

====================================================================
********************************************************************
====================================================================

How to generate a random Bitcoin address (Private Key and Bitcoin address):
---------------------------------------------------------------------------

Required:
	- Nothing.

Procedure:
	1. Don't enter anything in the 'Message Input' box.
	2. Press 'BTC Brainwallet' button.

Output:
	- The Private Key and associated Bitcoin address will be displayed in 'Message Output' box.

====================================================================
********************************************************************
====================================================================

How to generate a deterministic Bitcoin address (Private Key and Bitcoin address):
----------------------------------------------------------------------------------

Required:
	- Text, name, password or passphrase.

Procedure:
	1. Enter the text in the 'Message Input' box.
	2. Press 'BTC Brainwallet' button.

Output:
	- The Private Key and associated Bitcoin address will be displayed in 'Message Output' box.

Note:
	Using the same text you can always generate the same Bitcoin address.
	This Bitcoin address generator use the standard deterministic system also used on the internet in services such as: https://brainwalletx.github.io/
	Check 'BTC Cryptermite Brainwallet' option if you want more security. This option doesn't use the standard deterministic system, it's exclusive to Cryptermite.

====================================================================
********************************************************************
====================================================================

What is a Private Key of Bitcoin ?:
-----------------------------------

You can use this the Private Key in some Bitcoin wallets like 'MultiBit Classic' to import your own bitcoin address for sending and receiving Bitcoins.

====================================================================
********************************************************************
====================================================================

How to generate hash codes for a message:
-----------------------------------------

Required:
	- Text message.

Procedure:
	1. Enter the text in the 'Message Input' box.
	2. Press 'Hash' button near 'BTC Brainwallet' button.

Output:
	- The hash codes appear in the 'Message Output' box.

====================================================================
********************************************************************
====================================================================

How to generate hash codes for a file:
--------------------------------------

Required:
	- File.

Procedure:
	1. Select file in 'File to encrypt' field.
	2. Press 'Hash' button near 'Wipe' button.

Output:
	- The hash codes appear in the 'Message Output' box.

====================================================================
********************************************************************
====================================================================

How to hide a file inside an image:
-----------------------------------

Required:
	- Image file.
	- File to hide.
	- New password to encrypt the file inside the image.

Procedure:
	1. In top menu bar, select 'Tools/Hide a file inside an image'.
	2. In 'Image file' group select image file in 'File' field.
	3. In 'File to hide' group select file in 'File' field.
	4. In 'Obfuscation level' group select amount of bits used in the image. Less is better but reduces the capacity of storage of the image.
	5. Enter a password in 'Password' field and repeat in 'Verify' field.
	6. Press 'Generate steganography image' button.

Output:
	- The steganography image file is generated with '_steg' termination in PNG image format.

Note:
	The file will be hidden using AES-256 encryption algorithm with the specified password.
	If you wish you can rename this new image file, but don't change the extension (PNG or BMP).
	Don't convert this file to JPG image format, the hidden file will be lost.

Tips:
	For the required image file:
	- Try to avoid using images with large areas with the same colour (skies, white walls, etc ...)
	- Always use your own unpublished images, never from internet.

	The 4-bits obfuscation level only exists so you can see the difference between 4-bits, 2-bits and 1-bit.
	The 4-bit option greatly damages the image and you can clearly see that there is something hidden in it.
	The 1-bit option makes the hidden file invisible.

	Use 'Hidden area' button to see the area used to hide the file. Click on the image to change this area.
	Try to select areas with great colour variability. Not skies.

====================================================================
********************************************************************
====================================================================

How to extract hidden file inside an image:
-------------------------------------------

Required:
	- Steganography image file generated with Cryptermite.
 	- Password to extract and decrypt the hidden file inside the image.
	
Procedure:
	1. In top menu bar, select 'Tools/Extract hidden file from an image'.
	2. In 'Image file' group select image file in 'File' field.
	3. Enter the password in 'Password' field. The same used in the hiding process.
	4. Press 'Search hidden file' button.
	5. Press 'Extract hidden file' button.

Output:
	- The hidden file is extracted.

====================================================================
********************************************************************
====================================================================

What is the obfuscation level in steganography ?:
------------------------------------------------

The level of obfuscation defines the pattern of dispersion of the content of the file to hide inside the image.

Each pixel in the image has three components (blue, green and red).
Each component has 8 bits (24 per pixel).
Those are the bits that will be modified to hide the file avoiding that the image deteriorates the minimum.
Higher scatter (few bits) means better but more pixels are needed to hide the file.

Levels of obfuscation:

1 bit with Max scattering
Obfuscation level: Very High

1 bit without Max scattering:
Obfuscation level: High

2 bits with Max scattering:
Obfuscation level: Medium

2 bits without Max scattering:
Obfuscation level: Low

4 bits with Max scattering:
Obfuscation level: Very low

4 bits without Max scattering:
Obfuscation level: None

Please see folder 'Documentation/Examples_steganography', contains images with hidden files using different levels of obfuscation.

====================================================================
********************************************************************
====================================================================

Secure Chat and File Transfer:
------------------------------

Allows you to create a chat network between different users. One of the users must be the creator of the chat, he will be the Server user and must use the option 'Tools/Create Secure Chat (Server)'.
The rest of users will be the Clients users and must connect to the Server user using the option 'Tools/Connect to Secure Chat (Client)'.
All communication is encrypted with AES-256 algorithm (messages and files).
The communication is true point-to-point, direct connection between Cryptermite applications, without intermediaries. Only an external server is used for the storage and transfer the IP of the Server user.


Creating the Chat Server:
-------------------------
Required:
	- Nickname.
 	- Password to encrypt and decrypt the communication.
	
Procedure:
	1. In top menu bar, select 'Tools/Create Secure Chat (Server)'.
	2. Enter your nickname in 'Your Nickname' field.
	3. Enter the password in 'Password' field.
	4. Press 'Send IP' button to send your IP address to a server on the Internet.
	5. Press 'Create Chat Server' button.

	
Connecting to the Chat Server:
------------------------------
Required:
	- Nickname.
 	- Password to encrypt and decrypt the communication.
	- IP address of the Server user.
	
Procedure:
	1. In top menu bar, select 'Tools/Connect to Secure Chat (Client)'.
	2. Enter your nickname in 'Your Nickname' field.
	3. Enter the password in 'Password' field. The same used by the Server user.
	4. Enter the nickname of the Server user in 'Server Nickname' field. It is necessary for the next step.
	5. Press 'Get IP' button to get the Server IP from a server on the Internet.
	6. Press 'Connect to Chat Server' button.


Receiving files:
----------------
Required:
 	- Password to decrypt the files. The same used for chat.

Procedure:
	1. Check 'Allow receive'.

Note:
	The received files are stored in the 'Downloads' folder of Cryptermite application.


Sending files:
--------------
Required:
 	- Password to encrypt the files. The same used for chat.
	- IP address of the user you want to send the file.

Procedure:
	1. Un-check 'Allow receive'.
	2. Select file to send in 'File' field.
	3. Enter IP address of the user in 'IP user' field.
	4. Press 'Send' button.
	
Note:
	You can know the IP addresses of all users by pressing the 'Get users IPs' button.
	

Connection errors:
------------------
For this feature, Cryptermite needs to make incoming and outgoing connections through ports 8086 and 8087 on your computer.
Please grant connection permissions to Cryptermite on your firewall. You must also open these ports on your Internet router.
Otherwise, connection errors may occur.


====================================================================
********************************************************************
====================================================================

Private Forums:
---------------

This feature allows you to have non-live conversations with other people.
The storage of these forums is managed on a server on the Internet. Currently this server is the same that hosts the official website of the Cryptermite application.
Data transfer and storage is encrypted with the AES-256 algorithm.

To access these forums you must use the option 'Tools/Private Forums' in the menu bar.


Create a new Forum:
-------------------
Required:
	- Nickname.
	- New Forum name.
 	- Password to encrypt the Forum.

Procedure:
	1. Press 'New' button.
	2. Enter your nickname in 'Your Nickname' field.
	3. Enter the password in 'Password' field.
	4. Enter the Forum name in 'Forum name' field.
	5. You can use the bottom left box to add multiple messages to the Forum content.
	6. When you have finished press the 'Upload' button to update the Forum on the Internet.

	
Access an existing Forum:
-------------------------
Required:
	- Nickname.
	- Forum name.
 	- Password to encrypt and decrypt the Forum. The same used in the creation process.

Procedure:
	1. Enter your nickname in 'Your Nickname' field.
	2. Enter the password in 'Password' field.
	3. Enter the Forum name in 'Forum name' field or select it from the 'Recent forums' list.
	4. Press 'Download' button.
	5. You can use the bottom left box to add multiple messages to the Forum content.
	6. When you have finished press the 'Upload' button to update the Forum on the Internet.

Note:
	You can delete the Forum stored on the Internet by pressing 'Delete' button or just remove it from the list of recent Forums by pressing 'Remove' button.
	Each Forum only has a capacity of 3000 characters.

	
Connection errors:
------------------
For this feature, Cryptermite needs to make incoming and outgoing connections on your computer.
Please grant connection permissions to Cryptermite on your firewall.
Otherwise, connection errors may occur.


====================================================================
********************************************************************
====================================================================

Passwords Manager:
------------------

Searches are performed on all fields.
If you want field-specific searching, click on the header of that field and perform the search.
To search again on all fields use the cleaning button (near to the 'Search' button).


====================================================================
********************************************************************
====================================================================

What means 'wipe' in this application ?:
----------------------------------------

The term 'wipe' means a deletion of content so that it can not be retrieved in any way.
The application performs multiple overwriting with junk information over the content before deleting it from the system.

====================================================================
********************************************************************
====================================================================

How to encrypt all files in a folder:
-------------------------------------

Procedure:
	1. Select Encrypt Process.
	2. Select the encryption algorithm to use.
	3. Select (in 'File to encrypt' field) a file into the folder to encrypt all files.
	4. Enter a password in 'Password' field and repeat in 'Verify' field.
	5. (Optionally you can use the option 'Wipe file after process' to wipe all the original files after the encryption process).	
	6. Use the menu bar to select 'File/Encrypt folder contents'.
	
Output:
	- All files are always encrypted with the AES-256 algorithm.

====================================================================
********************************************************************
====================================================================

How to decrypt all files in a folder:
-------------------------------------

Procedure:
	1. Select Decrypt Process.
	2. Select the decryption algorithm to use. The same used in the encryption process.
	3. Select (in 'Encrypted file' field) a file into the folder to decrypt all files.
	4. Enter a password in 'Password' field.
	5. Use the menu bar to select 'File/Decrypt folder contents'.


====================================================================
********************************************************************
====================================================================

What's new in v3.0a (July/2019):
--------------------------------

- Random Number Generator.
- The application is released under Freeware license without limitations.

//////////////////////////////////

What's new in v2.0b (August/2017):
----------------------------------

- Passwords Manager.
- Support Unzip files.
- Encrypt folder contents.
- Wipe folder contents.
- Fast wipe files.
- Text boxes support 'Enter'.
- Icons in menu bar.
- Improve steganography.
- Fix bug: The application failed to encrypt large files.
- Fix minor bugs.
- Files encrypted with v1.4a are incompatible with this version.

====================================================================
********************************************************************
====================================================================

Donatios:
---------

If you like Cryptermite and it was useful, please consider making a donation (via PayPal) through the official page of the application.
Thank you.

Cryptermite WebSite:
http://www.entidad-3d.com/cryptermite

====================================================================
********************************************************************
====================================================================

CREDITS:
--------

Programmer: Jordi Prez

Application developed with Microsoft Visual C/C++

This software uses the Crypto++ class library of cryptographic algorithms and schemes written by Wei Dai.
See https://www.cryptopp.com/ for details.
Crypto++ is used under public domain license.
Crypto++ FIPS validations: 140-2 Level 1

This software uses the FreeImage open source image library.
See http://freeimage.sourceforge.net for details.
FreeImage is used under the FIPL license version.

Cryptermite WebSite: http://www.entidad-3d.com/cryptermite

Copyright  August/2017 - July/2019 Jordi Prez. All Rights Reserved.
