HcryptoJ (Historical cryptology in Java)
Download Page

HcryptoJ is a Java Application Programming Interface (API) for historical cryptology. It is modelled after the Java Cryptography Extension (JCE).

In addition to encryption engines, HcryptoJ v1.3 contains cryptanalyzers for simple substitution, Caesar, affine and Vigenere ciphers.

Version 1.3: Download the compressed archive file hcryptoj1.3.tar.Z.

The v1.3 archive contains the following files and directories:

README.txt -- A brief overview of the library.
classes -- The HcryptoJ class library consisting of the hcrypto.cipher, hcrypto.engines, hcrypto.provider, hcrypto.analyzer, and analyzers packages.
source -- The complete source code for HcryptoJ v1.3
applications/cryptotoolj -- A GUI tool for encrypting/decrypting text.
applications/filecipher -- A command-line test program for encrypting/decrypting files.
applications/testcipher -- A command-line program for testing cipher engines.
applications/testanalyzer -- A command-line program for testing analyzer applications.
appcode -- The classes for the application programs.

HcryptoJ 1.2 contains classes for encrypting and decrypting files using a variety of historical ciphers.

Version 1.2: Download the compressed archive file hcryptoj1.2.tar.Z.

The v1.2 archive contains the following files and directories:

hcrypto.jar -- The Java archive containing the API class files. This can be used instead of the classes directory to compile and run programs by listing it on the classpath.
source -- The complete source code for HcryptoJ.
applications/testcipher -- A command-line test program.
applications/filecipher -- A command-line test program for encrypting/decrypting files.
applications/cryptotoolj -- A GUI tool for encrypting/decrypting text.

Uncompress and untar the archive:
- $ uncompress hcryptojN.tar.Z (where N is the version number, 1.2 or 1.3).
- $ tar xvf hcryptojN.tar (where N is the version number, 1.2 or 1.3).
The TestCipher.java is simple program that illustrates how to use the API.
- Change to the applications/testcipher directory:
  $ cd applications/testcipher
- Compile TestCipher.java using a jar file or using the classes directory:
  $ javac -classpath ../../hcrypto.jar:. TestCipher.java
  $ javac -classpath ../../classes:. TestCipher.java
- Run TestCipher.java using a jar file or using the classes directory:
  $ java -classpath ../../hcrypto.jar:. TestCipher Caesar 4/az thisisatest
  $ java -classpath ../../classes:. TestCipher Caesar 4/az thisisatest
If everything is installed correctly, the program should encrypt and then decrypt the message "thisisatest".