Installation

This guide provides step-by-step instructions to install the BLTP plugin for Wireshark on your system.

WARNING

The BLTP Dissector is currently under active development. Certain features, such as Stream Reassembly, may not function correctly yet. Please stay tuned for updates and report any issues you encounter.

Prerequisites

Ensure that Wireshark version 4.4.X is installed on your system. The plugin API is only compatible within minor versions; thus, earlier or later versions will not be compatible.

You can download Wireshark, including earlier versions, from the Wireshark download page.

On macOS, glib is also required. You can install it using Homebrew with brew install glib.

1. Download the Plugin Binary

Download the archive containing the precompiled plugin binary for your platform and extract it to a location of your choice. The plugin is available for the following platforms:

• Windows x86_64
• macOS arm64
• Linux x86_64

On macOS, you will need to remove the quarantine attribute from the plugin binary by running the following command in the terminal:

xattr -d com.apple.quarantine /path/to/bltp.so

If your platform is not listed, you can build the plugin from source.

2. Install the Plugin

1. Launch Wireshark and open the About Wireshark dialog via the Wireshark menu on macOS or the Help menu on other platforms.

2. Navigate to the Folders tab, then double-click the hyperlink next to the Personal Plugins entry to open it. You may be asked to create this directory if it doesn't already exist.

3. Inside the Personal Plugins directory, create a folder named epan if it does not already exist.

4. Copy the extracted plugin binary file (e.g., bltp.so, bltp.dll) into the epan folder you just created.

3. Restart Wireshark

Restart Wireshark. To verify installation, open the About Wireshark dialog again and check under the Plugins tab. The BLTP plugin should now be listed.