An open API service indexing awesome lists of open source software.

https://github.com/bcbrookman/wireshark-profiles

A collection of my Wireshark profiles for troubleshooting, and analzying network protocols.
https://github.com/bcbrookman/wireshark-profiles

networking wireshark

Last synced: about 1 month ago
JSON representation

A collection of my Wireshark profiles for troubleshooting, and analzying network protocols.

Awesome Lists containing this project

README

          

# Wireshark Profiles

A collection of Wireshark profiles I've developed over time while frequently troubleshooting, and analzying network protocols.

## Features

These profiles aim to save time by applying some common configurations, and protocol specific customizations. In general, they include:

- The preferred split layout
- Protocol specific columns
- Quick filter buttons
- Useful I/O graph presets
- Mostly default coloring rules
- Mostly default "decode as" rules
- A few other basic configs

## Installation

1. Download the latest `wireshark-profiles_bcbrookman_YYYY.MM.DD.zip` from [Releases](https://github.com/bcbrookman/wireshark-profiles/releases)
2. Launch Wireshark and navigate to "**Edit**" → "**[Configuration Profiles…](https://www.wireshark.org/docs/wsug_html_chunked/ChCustConfigProfilesSection.html#ChCustGUIConfigProfilesPage)**" in the menu bar
3. Click the "**Import**" button, and select "**From Zip File...**" in the dropdown menu
4. Navigate to and select the release zip file downloaded in step 1 to import the profiles
5. Finally, don't forget to click the "**OK**" button in the "**Configuration Profiles…**" window to confirm your changes

## Development

Development really just means making changes within Wireshark and exporting or copying profiles.

Whenever changes are saved, however, Wireshark also includes some unnecessary comments, line breaks, and user-specific settings which are undesirable in shared profiles (see [Wireshark Configuration Files](https://www.wireshark.org/docs/wsug_html_chunked/ChAppFilesConfigurationSection.html) for more). To exclude this unwanted content, a `.gitignore` and Python script, `.scripts/clean_conf_files.py`, are used.

A [Taskfile](https://taskfile.dev/) is also included to help automate this process and perform other common tasks.
To see a list of tasks available in the Taskfile, run `task --list`.

```
$ task --list
task: Available tasks for this project:
* profiles:build: Generates an importable profile bundle (after cleaning) (aliases: build)
* profiles:clean: Cleans up profile config files (comments, blanks, etc.) (aliases: clean)
* profiles:pull: Pulls profiles from the default profiles directory (aliases: pull)
* profiles:push: Pushes profiles to the default profiles directory (aliases: push)
```

To override the default Wireshark profiles directory used with `push`/`pull`, set the `CUSTOM_WS_PROFILE_DIR` environment variable in your shell or `.env` file.
This is especially useful when developing with the PortableApps® versions of Wireshark.