protobuf-inspector

Alba Mendez (mildsunrise) and contributors

Open sourceUnmaintained

Last commit 2020-11-24; no GitHub releases.

protobuf-inspector is a small Python program that parses Google Protobuf (version 2 or 3) encoded blobs without their definition and prints a coloured representation of the contents. Examiners meet such blobs in SQLite and file caches from many mobile apps; the README itself does not mention mobile devices. Users progressively define fields in a configuration so the parser can stop guessing.

Facts

Websitegithub.com
VendorAlba Mendez (mildsunrise) and contributors
LicenceOpen source (ISC)
CategoryUtilities and libraries
FunctionsDecoding, Parsing
TargetsAndroid, iOS
Runs onWindows, macOS, Linux
PricingFree
UsersOpen-source DFIR community, Research
Last activity2020-11 · Last commit (documentation update, 2020-11-24); no releases [github.com]
GitHub activitymildsunrise/protobuf-inspector · 1,131 stars · last push 2020-12-13 · checked 2026-11-10

Capabilities

  • Parses Google Protobuf encoded blobs (version 2 or 3) without the accompanying definition and prints a coloured representation of the contents, typically guessing the message structure correctly. [github.com]
  • Installs with pip as the protobuf_inspector command, reading the blob on stdin; fields can be defined in a config file, including types such as bytes, message and dump (which extracts a chunk's raw data to files). [github.com]
  • On a parsing error, parsing stops within that field and carries on outside the hierarchy, printing a stack trace and hexdump; the program exits non-zero if errors occurred. [github.com]

Limitations

  • Field names are lost, and the README says it cannot know whether a varint uses zig-zag encoding, whether a 32/64-bit value is an integer or float, or signedness unless told; it 'can make mistakes, especially with small chunks'. [github.com]
  • The latest commit is dated 2020-11-24 and the repository has no GitHub releases. [github.com]

Related tools

Sources

  1. protobuf-inspector README (github.com)
  2. protobuf-inspector commit history (github.com)

Reviewed . Spotted an error? See the corrections policy.