diff --git a/README.md b/README.md index 3641b38..1b279fe 100644 --- a/README.md +++ b/README.md @@ -1,73 +1,35 @@ -

- basecrack -

BaseCrack

-

Decoder Tool For Base Encoding Schemes

+

Decoder For Base Encoding Schemes

- version + version GitHub license - Twitter

-![basecrack tool](https://raw.githubusercontent.com/mufeedvh/basecrack/master/assets/basecrack-tool.png) - ------------- - **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! + Fun Fact! +
+ I initially made this after being fed up with lame CTF challenges with multi-encoded bases. Now some of them started doing that in Steganography challenges as well so I automated that too smh!
---- - -### Jump to [Usage](https://github.com/mufeedvh/basecrack#usage) - ---- - -## Changelog - -**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. :fire: -- Magic Mode now works with Wordlist Generator. :fire: - -**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(Fp@nNG6ef<,*TFE]IT^zdINAb9EVbp,e<*[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**](https://github.com/mufeedvh/basecrack#api). - -**What's new in v1.1:** - -I heard your feature requests, now you can generate a wordlist/output with the decoded bases! :) +## Table of Contents +- [Features](#features) +- [Supported Encoding Schemes](#supported-encoding-schemes) +- [Installation](#installation) +- [Usage](#usage) +- [API](#api) +- [Contribution](#contribution) +- [License](#license) + +## Features + +- Decode multi-encoded bases of any pattern. +- Decode bases in image EXIF data. +- Decode bases on images with OCR detection. +- Can decode multiple base encodings from a file. +- Generate a wordlist/output with the decoded bases. +- Predicts the type of encoding scheme. ## Supported Encoding Schemes - Base16 @@ -81,26 +43,16 @@ I heard your feature requests, now you can generate a wordlist/output with the d - 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. - ------------- +- [Base100](https://github.com/AdamNiederer/base100) ([#14](https://github.com/mufeedvh/basecrack/issues/14)) ## Installation $ git clone https://github.com/mufeedvh/basecrack.git $ cd basecrack - $ pip install -r requirements.txt - $ python basecrack.py -h + $ pip3 install -r requirements.txt + $ python3 basecrack.py -h -📝 **NOTE:** Python3 is recommended to use! +**NOTE:** Python3 is recommended to use! **Linux:** @@ -120,35 +72,35 @@ OCR Detection is implemented with [Tesseract](https://github.com/tesseract-ocr/t **Tesseract Docs:** https://tesseract-ocr.github.io/ -📝 **NOTE:** I haven't completely tested this tool on Windows so if you stumble upon any issues, please [open an issue](https://github.com/mufeedvh/basecrack/issues/new). +**NOTE:** I haven't completely tested this tool on Windows so if you stumble upon any issues, please [open an issue](https://github.com/mufeedvh/basecrack/issues/new). ## Usage Get a list of all the arguments: - python basecrack.py -h + python3 basecrack.py -h To decode a single base encoding from user input: - python basecrack.py + python3 basecrack.py To decode a single base encoding from argument **(-b/--base)**: - python basecrack.py -b SGVsbG8gV29ybGQh + python3 basecrack.py -b SGVsbG8gV29ybGQh To decode multiple base encodings from a file **(-f/--file)**: - python basecrack.py -f file.txt + python3 basecrack.py -f file.txt **Magic Mode:** To decode multi-encoded base of any pattern **(-m/--magic)**: - python basecrack.py --magic + python3 basecrack.py --magic To input an image for **EXIF/OCR** detection mode **(-i/--image)**: - python basecrack.py -i image.jpg (--exif/--ocr) + python3 basecrack.py -i image.jpg (--exif/--ocr) -**EXIF Data Detection:** To decode bases in image EXIF data **(-e/--exif)**: +**EXIF Data:** To decode bases in image EXIF data **(-e/--exif)**: python basecrack.py -i image.jpg --exif @@ -159,6 +111,26 @@ To input an image for **EXIF/OCR** detection mode **(-i/--image)**: To generate a wordlist/output with the decoded bases **(-o/--output)**: python basecrack.py -f file.txt -o output-wordlist.txt + +## 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! ;) + +Want to test it out? Just give it this input: + +``` +IX(Fp@nNG6ef<,*TFE]IT^zdINAb9EVbp,e<*[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**](https://github.com/mufeedvh/basecrack#api). ## API @@ -192,26 +164,6 @@ Decoded String: spaghetti Encoding Scheme: Base64 ``` -Time to integrate this into your automation tools! ;) - -## Screenshots - -## EXIF Data Detection 📸 - -![basecrack exif detection](https://raw.githubusercontent.com/mufeedvh/basecrack/master/assets/basecrack-exif-detection.png) - -**Try It Yourself!** - - python basecrack.py -i examples/exif-example.jpg --exif - -## OCR Base Detection 🔎 - -![basecrack ocr detection](https://raw.githubusercontent.com/mufeedvh/basecrack/master/assets/basecrack-ocr-detection.png) - -**Try It Yourself!** - - python basecrack.py -i examples/ocr-example.jpg --ocr - ## Contribution Ways to contribute @@ -221,7 +173,7 @@ Ways to contribute - Help me document the code - Spread the word -Before you open a PR, make sure everything's good with a Unit Test: +Before you open a PR, make sure everything's good by running the tests: **Unit Tests:** (Thanks [@FavasM](https://github.com/mufeedvh/basecrack/pull/8)) @@ -233,10 +185,6 @@ Licensed under the MIT License, see Buy Me A Coffee - ------------- +Buy Me A Coffee -***Support this project by starring ⭐, sharing 📲, and contributing 👩‍💻! :heart:*** - ------------- +---