Ciphey Fully Automated Decryption Tool


What is this?

Ciphey is an automated decryption tool. Input encrypted text, get the decrypted text back.

“What type of encryption?”

That’s the point. You don’t know, you just know it’s possibly encrypted. Ciphey will figure it out for you.

Ciphey can solve most things in 3 seconds or less.

Ciphey demo

The technical part. Ciphey uses a custom built artifical intelligence module (AuSearch) with a Cipher Detection Interface to approximate what something is encrypted with. And then a custom-built, customisable natural languge processing Language Checker Interface, which can detect when the given text becomes plaintext.

And that’s just the tip of the iceberg. For the full technical explanation, check out our documentation.

sparkles Features

  • 20+ encryptions supported such as encodings (binary, base64) and normal encryptions like Caesar cipher, Transposition and more. For the full list, click here
  • Custom Built Artificial Intelligence with Augmented Search (AuSearch) for answering the question “what encryption was used?” Resulting in decryptions taking less than 3 seconds.
  • Custom built natural language processing module Ciphey can determine whether something is plaintext or not. It has an incredibly high accuracy, along with being fast.
  • Multi Language Support at present, only German & English (with AU, UK, CAN, USA variants).
  • Supports encryptions Which the alternatives such as CyberChef Magic do not.
  • C++ core Blazingly fast.

telescope Ciphey vs CyberChef

repeat Base64 Encoded 42 times

Namezap Ciphey zapturtle CyberChef turtle
Time2 seconds6 seconds
SetupRun ciphey on the fileSet the regex param to “{“You need to know how many times to recurseYou need to know it’s Base64 all the way downYou need to load CyberChef (it’s a bloated JS app)Know enough about CyberChef to create this pipelineInvert the match

Note The gifs may load at different times, so one may appear significantly faster than another.
A note on magic CyberChef’s most similar feature to Ciphey is Magic. Magic fails instantly on this input and crashes. The only way we could force CyberChef to compete was to manually define it.

We also tested CyberChef and Ciphey with a 6gb file. Ciphey cracked it in 5 minutes and 54 seconds. CyberChef crashed before it even started.

bar_chart Ciphey vs Katana vs CyberChef Magic

Namezap Ciphey zapclown_face Katana clown_faceturtle CyberChef Magic turtle
Advanced Language Checkerwhite_check_markxwhite_check_mark
Supports Encryptionswhite_check_markwhite_check_markx
Releases named after Dystopian themes night_with_starswhite_check_markxx
Supports hasheswhite_check_markwhite_check_markx
Easy to set upwhite_check_markxwhite_check_mark
Can guess what something is encrypted withwhite_check_markxx
Created for hackers by hackerswhite_check_markwhite_check_markx

clapper Getting Started

If you’re having trouble with installing Ciphey, read this.

bangbang Important Links (Docs, Installation guide, Discord Support)

Installation GuideDocumentationDiscord
book Installation Guidebooks Documentationparrot Discord

running_womanRunning Ciphey

There are 3 ways to run Ciphey.

  1. File Input ciphey - encrypted.txt
  2. Unqualified input ciphey -- "Encrypted input"
  3. Normal way ciphey -t "Encrypted input"
Gif showing 3 ways to run Ciphey

To get rid of the progress bars, probability table, and all the noise use the quiet mode.

ciphey -t "encrypted text here" -q

For a full list of arguments, run ciphey --help.

alembic Importing Ciphey

You can import Ciphey’s main and use it in your own programs and code. from Ciphey.__main__ import main

circus_tent Contributors

Ciphey was invented by Brandon Skerritt in 2008, and revived in 2019. Ciphey wouldn’t be where it was today without Cyclic3 – president of UoL’s Cyber Security Society.

Ciphey was revived & recreated by the Cyber Security Society for use in CTFs. If you’re ever in Liverpool, consider giving a talk or sponsoring our events. Email us at to find out more cowboy_hat_face

Major Credit to George H for working out how we could use proper algorithms to speed up the search process. Special thanks to varghalladesign for designing the logo. Check out their other design work!

service_dog Contributing

Don’t be afraid to contribute! We have many, many things you can do to help out. Each of them labelled and easily explained with examples. If you’re trying to contribute but stuck, tag @brandonskerritt in the GitHub issue sparkles

Alternatively, join the Discord group and send a message there (link in contrib file) or at the top of this README as a badge.

Please read the contributing file for exact details on how to contribute sparkles


Please follow and like us: