README

charemap
========

Charemap is a little program to play with substitution ciphers. It's able to
remap text, perform characters and word analysis and to automatically decrypt
ciphertext.


Requirements
------------
Glib, GNU make and a C compiler.


Installation
------------
In order to compile charemap, simply type `make'. No installation required.


Running charemap
----------------
See ./charemap -h


Example
-------
Here is an example of automatic decryption with a ciphertext shipped with
charemap:

./charemap -i ciphers/tobeornot.txt -d -m samples/dorian.txt 

Decripting using bigram and trigram detection...
done!

The mapping found is:

	<- etaoihnsrdlumwyfcgpbvkxqjz
	   ||||||||||||||||||||||||||
	-> jzfusrgtkxapyeilwomdnhbqcv

Decryption result:

to me, or not to me: that is the fuestion:
whether 'tis nomver in the yink to suller
the svings ank arrows ol outrageous lortune,
or to tabe a arys against a sea ol troumves,
ank mp oddosing enk they. to kie: to sveed;
no yore; ank mp a sveed to sap we enk
the heartache, ank the thousank naturav shocbs
that lvesh is heir to.

Affining result with dictionary-based decryption...
done!

The mapping found is:

	<- etaoihnsrdlumwyfcgpbvkxqjz
	   ||||||||||||||||||||||||||
	-> jzqusrgtdxaymeifwobpnhkvcl

Decryption result:

to be, or not to be: that is the question:
whether 'tis nobler in the mind to suffer
the slings and arrows of outrageous fortune,
or to take a arms against a sea of troubles,
and by opposing end them. to die: to sleep;
no more; and by a sleep to say we end
the heartache, and the thousand natural shocks
that flesh is heir to.


Author
------
Charemap is written by Marco Squarcina <lavish@gmail.com>


Website
-------
http://www.minimalblue.com/projects/charemap.html
https://github.com/lavish/charemap