dbc2shark
| Crates.io | dbc2shark |
| lib.rs | dbc2shark |
| version | 0.1.2 |
| created_at | 2025-12-24 00:38:32.326363+00 |
| updated_at | 2025-12-24 01:08:44.769791+00 |
| description | A CLI tool that converts a CAN DBC file (Vector DBC format) into a Wireshark Lua dissector |
| homepage | |
| repository | https://github.com/haradama/dbc2shark |
| max_upload_size | |
| id | 2002588 |
| size | 182,939 |
haradama (haradama)
documentation
README
dbc2shark
dbc2shark is a small CLI tool that converts a CAN DBC file (Vector DBC format) into a Wireshark Lua dissector. The generated Lua script registers fields for each DBC signal and decodes CAN frames based on can.id, making it easier to inspect signal values directly inside Wireshark.
Installation
From crates.io
cargo install dbc2shark
From source
git clone https://github.com/haradama/dbc2shark.git
cd dbc2shark
cargo install --path .
Usage
Generate a Lua dissector from a DBC file and write it to a file:
dbc2shark -i path/to/file.dbc > dbc_dissector.lua
Options
-i, --input <FILE>: Path to the input DBC file (required)-p, --proto-name <NAME>: Base name for the generated WiresharkProto(default:myproto)
Example:
dbc2shark -i vehicle.dbc -p vehicle > vehicle.lua
Using the Lua dissector in Wireshark
Generate the Lua script.
dbc2shark -i your.dbc -p yourproto > yourproto.lua
Copy the script to Wireshark's Lua plugin folder. The exact location depends on your OS and Wireshark installation.
Restart Wireshark
Open a capture that contains CAN frames
As long as Wireshark can decode the capture into CAN packets with a valid can.id field, the generated dissector will decode and show DBC signals for matching CAN IDs.
License
MIT License. See LICENSE for details.