An extensible application for penetration testers and software developers to decode/encode data into various formats.
Decoder++ can be either installed by using
pip or by pulling the source from this repository:
# Install using pip
pip3 install decoder-plus-plus
This section provides you with an overview about the individual ways of interacting with
Decoder++. For additional usage information check out the
Advanced Usage section.
Graphical User Interface
If you prefer a graphical user interface to transform your data
Decoder++ gives you two choices: a
main-window-mode and a
main-window-mode supports tabbing, the
dialog-mode has the ability to return the transformed content to
stdout ready for further processing. This comes quite in handy if you want to call
Decoder++ from other tools like BurpSuite (check out the BurpSuite Send-to extension) or any other script in which you want to add a graphical user interface for flexible transformation of any input.
If you don’t want to startup a graphical user interface but still make use of the various transformation methods of
Decoder++ you can use the commandline mode:
$ python3 dpp.py -e base64 -h sha1 "Hello, world!"
- User Interfaces:
- Graphical User Interface
- Command Line Interface
- Preinstalled Scripts and Codecs:
- Encode/Decode: Base16, Base32, Base64, Binary, Gzip, Hex, Html, JWT, HTTP64, Octal, Url, Url+, Zlib
- Hashing: Adler-32, Apache-Md5, CRC32, FreeBSD-NT, Keccak224, Keccak256, Keccak384, Keccak512, LM, Md2, Md4, Md5, NT, PHPass, RipeMd160, Sha1, Sha3 224, Sha3 256, Sha3 384, Sha3 512, Sha224, Sha256, Sha348, Sha512, Sun Md5
- Scripts: CSS-Minify, Caesar, Filter-Lines, Identify File Format, Identify Hash Format, JS-Beautifier, JS-to-XML, HTML-Beautifier, Little/Big-Endian Transform, Reformat Text, Remove Newlines, Remove Whitespaces, Search and Replace, Split and Rejoin, Unescape/Escape String
- Plugin System
- Load & Save Current Session
This section provides you with additional information about how the command line interface and interactive python shell can be used.
Command Line Interface
The commandline interface gives you easy access to all available codecs.
To list them you can use the
-l argument. To narrow down your search the
-l argument accepts additional parameters which are used as filter:
$ dpp -l base enc
Decoder++ distinguishes between encoders, decoders, hashers and scripts. Like the graphical user interface the command line interface allows you to use multiple codecs in a row:
$ dpp "H4sIAAXmeVsC//NIzcnJ11Eozy/KSVEEAObG5usNAAAA" -d base64 -d gzip
While encoders, decoders and hashers can be used right away, some of the scripts may require additional configuration. To show all available options of a specific script you can add the
$ dpp "Hello, world!" -s split_and_rejoin help
Split & Rejoin
Name Value Group Required Description
---- ----- ----- -------- -----------
split_by_chars split_behaviour yes the chars used at which to split the text
split_by_length 0 split_behaviour yes the length used at which to split the text
rejoin_with_chars yes the chars used to join the splitted text
To configure a specific script you need to supply the individual options as name-value pairs (e.g.
$ dpp "Hello, world!" -s search_and_replace search_term="Hello" replace_term="Hey"
To add custom codecs just copy them into the
from dpp.core.plugin.abstract_plugin import DecoderPlugin
Possible plugins are DecoderPlugin, EncoderPlugin, HasherPlugin or ScriptPlugin.
See AbstractPlugin or it's implementations for more information.
def __init__(self, context):
plugin_name = "URL"
plugin_author = "Your Name"
# Python Libraries which are required to be able to execute the run method of this plugin.
plugin_requirements = ["urllib"]
super().__init__(plugin_name, plugin_author, plugin_requirements)
def run(self, text):
# Load the required libraries here ...
# Run your action ...
Feel free to open a new ticket for any feature request or bugs. Also don’t hesitate to issue a pull-requests for new features/plugins.
- Tim Menapace (RIPEMD160, KECCAK256)
- Robin Krumnow (ROT13)
Signals are not working on Mac OS
Decoder++ in Mac OS signals are not working.
This might happen when
PyQt5 is installed using homebrew. To fix this issue it is recommended to install the
libdbus-1 library. See http://doc.qt.io/qt-5/osx-issues.html#d-bus-and-macos for more information regarding this issue.
Can not start Decoder++ in Windows using CygWin
CygWin an error occurs:
ModuleNotFoundError: No module named 'PyQt5'
This happens although
PyQt5 is installed using pip. Currently there is no fix for that. Instead it is recommended to start
Decoder++ using the Windows command line.
- PortSwigger’s Burp Decoder