---
# System prepended metadata

title: Cryptosploit

---

Cryptosploit
===
<p align="center">
  <img src="https://img.shields.io/github/issues/SNESEAR/cryptosploit.svg">
<!-- <a href="https://pypi.org/project/ciphey/"><img src="https://img.shields.io/pypi/v/ciphey.svg"></a> -->
  <img src="https://img.shields.io/github/license/SNESEAR/cryptosploit.svg">

<p>
Fully automated decryption/decoding/cracking tool using various modules.
</p>

Table of Contents
---
[TOC]

🔨 Installation Guide
---
  
`sudo pip install git+https://github.com/SNESEAR/cryptosploit.git --upgrade`

We use `sudo` to add cryptosploit to your $PATH.

🤔 What is this?
---
Cryptosploit is a new module-based cryptographic tool. You can use it for solving different cryptographic tasks.

In fact, it is a big library of cryptograhic tools, you don't need in a big folder with gigabytes of cryptographic tools. Everything you need can be found here.

Cryptosploit aims to be a tool to automate a lot of routine work with various scripts.

🏃‍♀️ Running Cryptosploit
---
Very simple way of usage:

![gif](gif_images/cryptosploit.gif?raw=true)

Read more about any command
```
crsconsole> help

Documented commands (type help <topic>):
========================================
cd  exit  get  help  run  search  set  shell  unset  use

crsconsole> help search

        Search modules by keyword.
        Example: search rot
        
```

You can search modules by regular expressions.
```
crsconsole> search hash
[>] hashes
hashes.cracker
```

Then just type use founded.module
```
crsconsole> use hashes.cracker
[>] Module loaded successfully
```

Get and set module varibles
```
crsconsole (hashes.cracker)> get
╒════════════════════╤═════════╤══════════════════════════════════════════════════╕
│ Name               │ Value   │ Description                                      │
╞════════════════════╪═════════╪══════════════════════════════════════════════════╡
│ default_cracker    │ hashcat │ Default program to crack hashes (hashcat/john).  │
│                    │         │  You must install one of these tools.            │
├────────────────────┼─────────┼──────────────────────────────────────────────────┤
│ mode               │ help    │ Operation mode. May be crack/help/advanced.      │
│                    │         │ Just type run. Advanced users can                │
│                    │         │ pass all the arguments in extra_flags            │
├────────────────────┼─────────┼──────────────────────────────────────────────────┤
│ hash_file          │         │ Path to file with hash.                          │
├────────────────────┼─────────┼──────────────────────────────────────────────────┤
│ wordlist           │         │ Path to wordlist.                                │
│                    │         │ For example, '/usr/share/wordlists/rockyou.txt'  │
├────────────────────┼─────────┼──────────────────────────────────────────────────┤
│ identify_hash_type │ true    │ We will try to identify hash type                │
│                    │         │ and pass most possible type in hash_mode         │
│                    │         │ use 'run' again to try next possible type        │
├────────────────────┼─────────┼──────────────────────────────────────────────────┤
│ hash_mode          │         │ Mode of your hash for you program.               │
│                    │         │ For example, '0' (like in hashcat)               │
├────────────────────┼─────────┼──────────────────────────────────────────────────┤
│ extra_flags        │         │ Add your own flags.                              │
│                    │         │ For example, '--save-memory=1 --fork=10'         │
├────────────────────┼─────────┼──────────────────────────────────────────────────┤
│ path_to_binary     │         │ Specify the path to your program.                │
│                    │         │ For example, '/usr/bin/hashcat'                  │
│                    │         │ Must contain hashcat/john                        │
╘════════════════════╧═════════╧══════════════════════════════════════════════════╛
crsconsole (hashes.cracker)> set mode advanced
[>] Setting mode -> advanced
crsconsole (hashes.cracker)> set extra_flags -a 3 -m 0 hash_to_crack ?a?a?a?a?a?a
[>] Setting extra_flags -> -a 3 -m 0 hash_to_crack ?a?a?a?a?a?a
```

Type run to execute module functionality.

```
crsconsole (hashes.cracker)> run
```

Modules
---
As you have already read, this tool is module-based, that's why it is still in development. We want to extend our module's database.

Anybody can write their own module in any programming language and add it to cryptosploit using a very simple and convinient API in python.



| Column 1 | Column 2 | Column 3 |
| -------- | -------- | -------- |
| Text     | Text     | Text     |
