Blackbox Protobuf

NCC Group · also known as bbpb

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

Websitegithub.com
VendorNCC Group
LicenceOpen source (MIT)
CategoryUtilities and libraries
FunctionsDecoding, Parsing, App analysis
TargetsAndroid, iOS
Runs onWindows, macOS, Linux
PricingFree
UsersOpen-source DFIR community, Research, Civil society
Last activity2025-03 · v1.4.2 release (2025-03-14) [github.com]
GitHub activitynccgroup/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]

Related tools

Sources

  1. Blackbox Protobuf README (github.com)
  2. ALEAPP requirements.txt (github.com)
  3. ALEAPP vendored blackboxprotobuf header (github.com)
  4. Blackbox Protobuf v1.4.2 release (github.com)

Reviewed . Spotted an error? See the corrections policy.