Blackbox Protobuf
Open sourceUnmaintained
Latest release v1.4.2 and the last commit on the default branch (master) are both dated 2025-03-14. Later repository activity consists of dependency-bot and other pull requests that remain open and unmerged.
Blackbox Protobuf is an NCC Group toolset for working with encoded Protocol Buffers without the matching protobuf definition. It was originally written as a Burp extension for decoding and modifying messages during mobile pentests and has also been used for reverse engineering and forensics tooling. It ships a Python library, a command-line interface and a mitmproxy add-on, and ALEAPP bundles a vendored copy (version 1.0.1).
Facts
| Website | github.com |
|---|---|
| Vendor | NCC Group |
| Licence | Open source (MIT) |
| Category | Utilities and libraries |
| Functions | Decoding, Parsing, App analysis |
| Targets | Android, iOS |
| Runs on | Windows, macOS, Linux |
| Pricing | Free |
| Users | Open-source DFIR community, Research, Civil society |
| Last activity | 2025-03 · v1.4.2 release (2025-03-14) [github.com] |
| GitHub activity | nccgroup/blackboxprotobuf · 743 stars · last push 2026-04-13 · latest release v1.4.2 (2025-03-14) · checked 2026-11-10 |
Capabilities
- Designed to allow working with protocol buffers without the message definition; originally implemented as a Burp extension for decoding and modifying messages during mobile pentests, and also used for reverse engineering and forensics tooling. [github.com]
- The repository contains a Burp (Jython) extension, a Python library, a Python-based CLI embedded in the library, and a mitmproxy add-on. [github.com]
- A type definition guide explains editing typedefs to fix field types and improve readability of decoded output. [github.com]
- ALEAPP's requirements file states it uses a vendored copy in scripts/blackboxprotobuf rather than the PyPI package, and the vendored package header labels it 'Vendored third-party code (blackboxprotobuf 1.0.1)'. [github.com]
Limitations
- The README states the official PyPI package is now named 'bbpb' and that the 'blackboxprotobuf' package on PyPI is an older fork. [github.com]
- Because the encoding strips most type information, decoded field types are inferred and may need manual correction through typedefs (README: 'guide for editing typedefs to fix types'). The latest release is v1.4.2 (2025-03-14). [github.com]
Links
Related tools
- protobuf-inspector · Utilities and libraries
- ALEAPP · Artefact parsers
- CyberChef · Utilities and libraries
- FQLite · Recovery and carving
Sources
- Blackbox Protobuf README (github.com)
- ALEAPP requirements.txt (github.com)
- ALEAPP vendored blackboxprotobuf header (github.com)
- Blackbox Protobuf v1.4.2 release (github.com)
Reviewed . Spotted an error? See the corrections policy.