Skip to main content

Automated Decryption Tool

Project description

Translations
๐Ÿ‡ฎ๐Ÿ‡ฉ ID ๐Ÿ‡ฎ๐Ÿ‡น IT ๐Ÿ‡ฉ๐Ÿ‡ช DE ๐Ÿ‡ญ๐Ÿ‡บ HU ๐Ÿ‡ณ๐Ÿ‡ฑ NL ๐Ÿ‡ง๐Ÿ‡ท PT-BR ๐Ÿ‡ท๐Ÿ‡บ RU ๐Ÿ‡ซ๐Ÿ‡ท FR ๐Ÿ‡จ๐Ÿ‡ณ ZH

โžก๏ธ Documentation | Discord | Installation Guide โฌ…๏ธ
Ciphey

GitHub commit activity Discord Ciphey Ciphey
Fully automated decryption/decoding/cracking tool using natural language processing & artificial intelligence, along with some common sense.


Installation Guide

๐Ÿ Python

๐Ÿ‹ Docker (Universal)

python3 -m pip install ciphey --upgrade docker run -it --rm remnux/ciphey
Linux Mac OS Windows
GitHub Workflow Status GitHub Workflow Status GitHub Workflow Status

๐Ÿค” What is this?

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

Ciphey aims to be a tool to automate a lot of decryptions & decodings such as multiple base encodings, classical ciphers, hashes or more advanced cryptography.

If you don't know much about cryptography, or you want to quickly check the ciphertext before working on it yourself, Ciphey is for you.

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

No neural networks or bloated AI here. We only use what is fast and minimal.

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

โœจ Features

  • 50+ encryptions/encodings supported such as binary, Morse code and Base64. Classical ciphers like the Caesar cipher, Affine cipher and the Vigenere cipher. Along with modern encryption like repeating-key XOR 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. Whether that plaintext is JSON, a CTF flag, or English, Ciphey can get it in a couple of milliseconds.
  • Multi Language Support at present, only German & English (with AU, UK, CAN, USA variants).
  • Supports encryptions and hashes Which the alternatives such as CyberChef Magic do not.
  • C++ core Blazingly fast.

๐Ÿ”ญ Ciphey vs CyberChef

๐Ÿ” Base64 Encoded 42 times

Name โšก Ciphey โšก ๐Ÿข CyberChef ๐Ÿข
Gif The guy she tells you not to worry about You
Time 2 seconds 6 seconds
Setup
  • Run ciphey on the file
  • Set the regex param to "{"
  • You need to know how many times to recurse
  • You need to know it's Base64 all the way down
  • You need to load CyberChef (it's a bloated JS app)
  • Know enough about CyberChef to create this pipeline
  • Invert 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.

๐Ÿ“Š Ciphey vs Katana vs CyberChef Magic

Name โšก Ciphey โšก ๐Ÿ—ก๏ธ Katana ๐Ÿ—ก๏ธ ๐Ÿข CyberChef Magic ๐Ÿข
Advanced Language Checker โœ… โŒ โœ…
Supports Encryptions โœ… โœ… โŒ
Releases named after Dystopian themes ๐ŸŒƒ โœ… โŒ โŒ
Supports hashes โœ… โœ… โŒ
Easy to set up โœ… โŒ โœ…
Can guess what something is encrypted with โœ… โŒ โŒ
Created for hackers by hackers โœ… โœ… โŒ

๐ŸŽฌ Getting Started

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

โ€ผ๏ธ Important Links (Docs, Installation guide, Discord Support)

Installation Guide Documentation Discord Docker Image (from REMnux)
๐Ÿ“– Installation Guide ๐Ÿ“š Documentation ๐Ÿฆœ Discord ๐Ÿ‹ Docker Documentation

๐Ÿƒโ€โ™€๏ธRunning Ciphey

There are 3 ways to run Ciphey.

  1. File Input ciphey -f 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.

โš—๏ธ Importing Ciphey

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

๐ŸŽช Contributors

Ciphey was invented by Brandon 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 cybersecurity@society.liverpoolguild.org to find out more ๐Ÿค 

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!

๐Ÿ•โ€๐Ÿฆบ 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 @bee-san or @cyclic3 in the GitHub issue โœจ

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 โœจ

By doing so, you'll get your name added to the README below and get to be apart of an ever-growing project! Stargazers over time

๐Ÿ’ฐ Financial Contributors

The contributions will be used to fund not only the future of Ciphey and its authors, but also Cyber Security Society at the University of Liverpool.

GitHub doesn't support "sponsor this project and we'll evenly distribute the money", so pick a link and we'll sort it out on our end ๐Ÿฅฐ

โœจ Contributors

Thanks goes to these wonderful people (emoji key):


cyclic3

๐ŸŽจ ๐Ÿšง ๐Ÿ’ป ๐Ÿค”

Brandon

๐ŸŽจ ๐Ÿšง ๐Ÿ’ป ๐Ÿค”

michalani

๐Ÿ’ป

ashb07

๐Ÿ’ป

Shardion

๐Ÿ›

Bryan

๐ŸŒ ๐Ÿ“–

Lukas Gabriel

๐Ÿ’ป ๐Ÿ› ๐ŸŒ ๐Ÿค”

Darshan

๐Ÿ›

SkeletalDemise

๐Ÿ’ป

Christian Clauss

๐Ÿ’ป ๐Ÿ›

Machinexa2

๐Ÿ–‹

Anant Verma

๐Ÿ’ป ๐Ÿ›

XVXTOR

๐Ÿ“–

Itamikame

๐Ÿ’ป

MikeMerz

๐Ÿ’ป

Jacob Galam

๐Ÿ’ป ๐Ÿ›

TuxTheXplorer

๐ŸŒ

Itamai

๐Ÿ’ป ๐Ÿ›

Filipe

๐ŸŒ

Malathi

๐Ÿ’ป

Jack

๐ŸŒ

Younes

๐ŸŒ

Marnick Vandecauter

๐ŸŒ

Michael V

๐Ÿ’ป

chuinzer

๐ŸŒ

blackcat-917

๐ŸŒ

ร…smund Brekke

๐Ÿ’ป

Sashreek Shankar

๐Ÿ’ป

cryptobadger

๐Ÿ’ป ๐Ÿ›

This project follows the all-contributors specification. Contributions of any kind welcome!

Project details


Download files

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

Source Distribution

ciphey-5.10.0.tar.gz (58.6 kB view details)

Uploaded Source

Built Distribution

ciphey-5.10.0-py3-none-any.whl (87.5 kB view details)

Uploaded Python 3

File details

Details for the file ciphey-5.10.0.tar.gz.

File metadata

  • Download URL: ciphey-5.10.0.tar.gz
  • Upload date:
  • Size: 58.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.8.5 Linux/5.8.16-2-MANJARO

File hashes

Hashes for ciphey-5.10.0.tar.gz
Algorithm Hash digest
SHA256 b4277812a267750620f03f9a53280e862e004286f45de53a42530c685f2aaf97
MD5 15aa95648b8dda7b0af5cb03285d0ba7
BLAKE2b-256 58b14c81f106c1f29e23b49327dffb75931a2a2bf8465a3a7c2b8f8ab46bbbfe

See more details on using hashes here.

File details

Details for the file ciphey-5.10.0-py3-none-any.whl.

File metadata

  • Download URL: ciphey-5.10.0-py3-none-any.whl
  • Upload date:
  • Size: 87.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.8.5 Linux/5.8.16-2-MANJARO

File hashes

Hashes for ciphey-5.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 722c5fce69d0fbe2a0f7e24a773df996ac1792d1ccfec375a667b7eaec2cbabb
MD5 a8071b052e5f374911f85f7752fd9e02
BLAKE2b-256 1adb15c256f826f29c311a64007b5182d90c2a4b8ea9a83777afd60b3678787e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page