Encode. Decode. Identify.
README · Contributing · Apache-2.0 License · Security · Changelog
OWASP-DecodeBox-Showcase-Final.mp4
OWASP DecodeBox is a browser-based workbench for identifying unknown data and tracing how it was encoded. Paste text or open a file to explore its layers. Each format suggestion comes with evidence you can inspect, and the steps that reach a layer can become an editable recipe.
- Detection. Follow nested encodings, including encoded fields inside structured data. The analysis shows where it found each indicator and what triggered each security finding.
- Recipes. Choose from 504 operations to convert formats, decompress data, compute hashes, or extract values. Adjust the arguments, reorder steps, and save the recipe for another input.
- Capture the flag (CTF). Search decoded layers for flag patterns, review ranked hints for the next transformation, and copy the findings into a Markdown report.
For local development, clone the source repository and run these commands from its root with Node.js 22.12.0 or later.
npm ci
npm run devRun npm test -- --run to execute the 1,205 tests. Run npm run build to produce the static
site and the standalone edition.
Select Download DecodeBox on the live site, or open the locally built
dist/decodebox.html. The file includes the engine, interface, and fonts. Large inputs can
pause the tab because processing runs on the main thread. Download a new copy after security fixes.
Analysis runs in your browser. No application backend receives ordinary analysis input. Saved recipes use browser storage. Share links include the recipe and its custom arguments in the URL fragment. Input is excluded by default. If you select Include the input as well, anyone with the link can read it. Report vulnerabilities privately through the security policy.
For decoding errors, include a small, non-sensitive sample, your recipe, and the expected result. Contributions to operations should include test vectors. Follow the OWASP contributing guidelines and Code of Conduct.
Source layout
- The engine interface exposes decoding and analysis to the React interface components.
- The engine separates operations, format detection, and recursive analysis.
DecodeBox is licensed under the Apache License 2.0.