Awesome Open Source
Awesome Open Source



Decoder Tool For Base Encoding Schemes

version GitHub license Twitter

basecrack tool

BaseCrack is a tool written in Python that can decode all alphanumeric base encoding schemes. This tool can accept single user input, multiple inputs from a file, input from argument, multi-encoded bases, bases in image EXIF data, bases on images with OCR and decode them incredibly fast.

Decode Base16, Base32, Base36, Base58, Base62, Base64, Base64Url, Base85, Ascii85, Base91, Base92 and more with the best base encoding scheme decoding tool in town. It's useful for CTFs, Bug Bounty Hunting, and Cryptography (NOTE: Base Encoding is not an "Encryption" hence it doesn't fall under the Cryptography category, it's useful as base scheme encoding are often used in cryptography tools/projects/challenges).

Fun Fact!
I initially made this after being fed up with lame AF CTF challenges with multi-encoded bases in Cryprography challenges and now some of them started doing that in Steganography challenges so I automated that too smh!

Jump to Usage


What's new in v3.0:

  • Decode bases in image EXIF data. 📸
  • Decode bases on images with OCR detection. ğŸ”Ž
  • Better Accuracy. (+added charset validation along with replacement char checks) 💯
  • Magic Mode now works with File Read mode. 🔥
  • Magic Mode now works with Wordlist Generator. 🔥

What's new in v2.0:

  • Now BaseCrack supports both Python2 and Python3.

Magic Mode 🪄

Now you can decode multi-encoded bases of any pattern in a single shot.

Have you ever stumbled upon that one lame CTF challenge that gives you an encoded string which is just encoded over and over with Base64, Base91, Base85 and so on? Just give that to BaseCrack and you're done with it! ;)

basecrack magic mode

Want to test it out? Just give it this input:

IX([email protected]<,*TFE]IT^zdINAb9EVbp,e<u=O6nN)/u+MTnU;Fo#VvQ&cK;mLZI#Jbdook<O{W#+gY%ooe#6pTkTa.9YPU8Uc=pl9BhSM9%kISw2k:8..u/6F2BwNndPZ2o#7NHNP3g,HlZu><*[Nv+T8

and see for yourself! :)

BaseCrack API

BaseCrack can now be used as a library! Just import the BaseCrack() class and call the decode() function.

See API.

What's new in v1.1:

I heard your feature requests, now you can generate a wordlist/output with the decoded bases! :)

Supported Encoding Schemes

  • Base16
  • Base32
  • Base36
  • Base58
  • Base62
  • Base64
  • Base64Url
  • Base85
  • Ascii85
  • Base91
  • Base92

Main Features

  • Decode multi-encoded bases of any pattern.
  • Decode bases in image EXIF data.
  • Decode bases on images with OCR detection.
  • Dan decode multiple base encodings from a file.
  • Generate a wordlist/output with the decoded bases.
  • Predicts the type of encoding scheme.


$ git clone
$ cd basecrack
$ pip install -r requirements.txt
$ python -h

📝 NOTE: Python3 is recommended to use!


$ sudo apt-get update
$ sudo apt-get install tesseract-ocr libtesseract-dev


$ brew install tesseract


OCR Detection is implemented with Tesseract and Windows requires installation of the Tesseract executable. Installing the dependencies from requirements.txt which includes pytesseract should install it. If in case it doesn't, here's how you can set it up:

  1. First check whether you have it installed or not in the Program Files/Program Files (x86) under the Tesseract-OCR directory.
  2. If there is, give that path in the config.json and you're all set! If you don't have it, install it from here and set the path in config.json.

Tesseract Docs:

📝 NOTE: I haven't completely tested this tool on Windows so if you stumble upon any issues, please open an issue.


Get a list of all the arguments:

python -h

To decode a single base encoding from user input:


To decode a single base encoding from argument (-b/--base):

python -b SGVsbG8gV29ybGQh

To decode multiple base encodings from a file (-f/--file):

python -f file.txt

Magic Mode: To decode multi-encoded base of any pattern (-m/--magic):

python --magic

To input an image for EXIF/OCR detection mode (-i/--image):

python -i image.jpg (--exif/--ocr)

EXIF Data Detection: To decode bases in image EXIF data (-e/--exif):

python -i image.jpg --exif

OCR Base Detection: To decode bases on image with OCR detection (-c/--ocr):

python -i image.jpg --ocr

To generate a wordlist/output with the decoded bases (-o/--output):

python -f file.txt -o output-wordlist.txt


Want to use BaseCrack as a library? We got you covered!

Just put basecrack in your project's directory and you're ready to go!


# import the BaseCrack class from
from basecrack import BaseCrack

# calling the api function decode() with the encoded base
result = BaseCrack().decode('c3BhZ2hldHRp')

# printing the output
result is tuple where:
result[0] = DECODED STRING
print('Decoded String: {}'.format(result[0]))
print('Encoding Scheme: {}'.format(result[1]))


Decoded String: spaghetti
Encoding Scheme: Base64

Time to integrate this into your automation tools! ;)


EXIF Data Detection 📸

basecrack exif detection

Try It Yourself!

python -i examples/exif-example.jpg --exif

OCR Base Detection ğŸ”Ž

basecrack ocr detection

Try It Yourself!

python -i examples/ocr-example.jpg --ocr


Ways to contribute

  • Suggest a feature
  • Report a bug
  • Fix something and open a pull request
  • Help me document the code
  • Spread the word

Before you open a PR, make sure everything's good with a Unit Test:

Unit Tests: (Thanks @FavasM)

python3 -m unittest discover -v -s tests


Licensed under the MIT License, see LICENSE for more information.

Liked the project?

Support the author by buying him a coffee!

Buy Me A Coffee

Support this project by starring ⭐, sharing 📲, and contributing 👩‍💻! ❤️

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (53,337) 
tool (412) 
cryptography (396) 
infosec (197) 
bugbounty (178) 
ctf (169) 
decoder (82) 
ctf-tools (51) 
encoder-decoder (39) 
base64 (36) 
base (26) 
decode (20)