protobuf-inspector
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
| Website | github.com |
|---|---|
| Vendor | Alba Mendez (mildsunrise) and contributors |
| Licence | Open source (ISC) |
| Category | Utilities and libraries |
| Functions | Decoding, Parsing |
| Targets | Android, iOS |
| Runs on | Windows, macOS, Linux |
| Pricing | Free |
| Users | Open-source DFIR community, Research |
| Last activity | 2020-11 · Last commit (documentation update, 2020-11-24); no releases [github.com] |
| GitHub activity | mildsunrise/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]
Links
Related tools
- Blackbox Protobuf · Utilities and libraries
- CyberChef · Utilities and libraries
- FQLite · Recovery and carving
- ALEAPP · Artefact parsers
Sources
- protobuf-inspector README (github.com)
- protobuf-inspector commit history (github.com)
Reviewed . Spotted an error? See the corrections policy.