Skip to main content

An encryption tool, designed for recreational purposes.

Project description


Memecrypt is an encryption tool designed for recreational use, with the purpose of encrypting and sending messages and memes between your friends. It features a substitution cipher, designed and made completely from scratch, where text can be encrypted and decrypted with the same key from a variety of input sources.

Memecrypt can be imported as a python module or used as a standalone program, depending on which is required.

GitHub forks GitHub stars GitHub watchers


  • A GNU/Linux based OS (Tested on: Ubuntu 18.04/Kali 2019.1)
  • Bash
  • Git
  • Python3 (pip3, requests)


There are 2 main ways to use memecrypt. Both the program and module usage is covered here.

Program usage

To use this as a program, start by cloning the repository from GitHub. Then build the PyPi format package and install it.

$ git clone
$ cd Memecrypt
$ python3 -m pip install --user --upgrade setuptools wheel
$ python3 sdist bdist_wheel
$ cd dist/ && python3 -m pip install *.whl --user && cd .. && rm build/ dist/ memecrypt.egg-info/ -rf

Alternatively, you may install it direct from PyPi, ready for use.

$ python3 -m pip install memecrypt


Let's start by viewing all the supported arguments.

$ memecrypt --help
[+] Usage: memecrypt [options]

[i] Examples:

      memecrypt -se -i foo -k bar

      memecrypt --subs -x -f file.txt -k "super secret"

      memecrypt -sx -c Ciphertext -k key

      memecrypt --subs -e -u -k lolcat

[i] Positional arguments:

       -s --subs
              Select the substitution cipher.
       -e --encrypt
              Select encryption mode.
       -x --decrypt
              Select decryption mode.
       -k --key key
              Specify the key to use.
       -i --input input-string
              Specify a string to encrypt/decrypt.
       -u --url url
              Fetch the plaintext/ciphertext from the url.
       -f --file file-path
              Use local file for encrypting/decrypting.

[i] Optional arguments:

       -h --help
              Show this help screen and exit.
       -v --version
              Print version information and exit.
       -q --quiet
              Only show output. Any errors are still displayed.
       -o --output-file file
              Specify a file to output to.


Encrypt a message, taking input as an; argument, url or file, respectively. In each example, different representations of arguments may have been used or more options may have been added to display potential permutations.

# As an argument
$ ./ -se -i "foo bar" -k "lorem ipsum"
[!] Note: Please use the same key for decryption.
[+] Encrypted result:

# From a URL
$ ./ --subs --encrypt --url --key "cat"
[+] Fetched data from URL.
[!] Note: Please use the same key for decryption.
[+] Encrypted result:
WiJeTFoiXkxaOl5ETDpeREw6XkRMOl5ET.....(and so on).....

# From a local file
$ ./ -se -f <file-path> -k "foobar" -q
NWl8eSlMd35ZXTQxU289Y0ZdNGdGTCdrU2FBQ3pM...(and so on)...


Decrypt a message, again using argument, and local file respectively. An URL can also be used here, but I didn't have the time to host a memecrypt encrypted text page.

# Decrypt as an argument.
./ -sx -i bVQ0cjJfVkY1TGNCKFRWWzIkZVF... -k wow
[+] Decrypted result:
Much encryption, very wow

# Decrypt from file
$ ./ --subs --decrypt -f ../../projects/outputfile -k lol
[+] Decrypted result:
Cupcake ipsum dolor. Sit amet topping chocolate bar


Arguments can be used in any order, any form and arguments can be combined, as long as they don't need a passed value. A bit like how you would use ls -al.

There are more options and ways you can use them. Please see the help screen for info on the options.

This is just my implementation of memecrypt and you are welcome to create your own, or improve upon the algorithm.

To create this, I used Easyparse, which is a user-friendly, lightweight argument parser that I wrote.

Module usage

To use Memecrypt as a python3 module, we'll need to install this from PyPi using pip3. Simply run python3 -m pip install memecrypt to install the module.


Let's start by creating an instance of the meme_cipher class.

# Import our module
import memecrypt

# Create an instance
cipher = memecrypt.meme_cipher(message=None, enc_key=None, show_colors=True)

# message is the message to work on
# enc_key is the key
# show_colors=False to turn off all colors

# message, enc_key, show_colors are optional.
# You could simply just do:
cipher = memecrypt.meme_cipher()

Setting a message

Once you have created an instance of the meme_cipher class, you can set the message at any time, by calling the method shown below. The message cannot be blank or None. You don't have to use this method for setting the message, you can simply set the <object>.message attribute too. The method is there for simplicity reasons.

# Using our previous instance

# We can access/modify this by accessing the message attribute
# Prints: foo

# Let's try and set a blank message.
# Prints: [!] Memecrypt: Plaintext/Ciphertext cannot be empty.

Setting a key

This works the same way as setting a message. As usual, we'll use our cipher instance. Again, the key cannot be blank or None. Similar to before, you can set the key by modifying the enc_key attribute.

# Setting a key

# We can access/modify the key from the enc_key attribute
# Prints: bar

# Same as before, we can't set a blank key
# Prints: [!] Memecrypt: Key value cannot be empty.


Once we have set a key and a message, we can encrypt them. This will return the result. If the key or message is missing, it will display an error.

# message => foo, key => bar
# Returns: 'NEgydQ=='


Decrypting is a similar process to encrypting. A valid non-empty key and message is needed, and errors are displayed if any are not present.

# message => NEgydQ==, key=> bar
# Returns: 'foo'

Input sources

If we wanted, we could also get our message/key text from a local file or an URL. You don't have to use this of course, you could implement your own file handing using with blocks or get the contents from a url using requests, urllib3, aiohttp or any module you want. It's simply there for convenience purposes, but chances are you can do it better.

# transfer the contents of the url.
cat = cipher.fetch_url("")
# Returns a ascii cat.
# We just set our message as the ascii cat!

# Read a local file.
foo_file = cipher.read_file("/path/to/file/file.txt")
# foo_file will have contents of file.txt

# Set our message to contents of file.txt

Output files

If you want to write the output to a file, you can simply do:

# Append to a file. Create file if file non-existent.
cipher.write_to("path/to/file/file.txt", "lorem ipsum dolor")

# Let's put our encrypted output to a file.
cipher.write_to("foo_bar.txt", cipher.encrypt())

Like the input sources, you could write your own method of writing to a file.


I would like to thank you for taking the time to read this. I hope it has been useful in explaining Memecrypt and how it can be used as a module or program. If you have any questions, please create an issue in GitHub, and I will try my best to respond to it, as long as its related to memecrypt and its use.

Memecrypt is just one of my 'weekend projects'. You can view my other projects at my GitHub page, where I have built a Wireless network auditing script called Airscript-ng with quite a few built-in tools, and Easyparse a lightweight, user-friendly argument parser.

GitHub Link


  • [ ] Add support for binary files
  • [ ] Add other modes of operation (in progress)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for memecrypt, version 1.3
Filename, size File type Python version Upload date Hashes
Filename, size memecrypt-1.3-py3-none-any.whl (24.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size memecrypt-1.3.tar.gz (13.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page