This is an experimental release intended to test new features for Stratoshark 1.0.

What is Stratoshark?

Stratoshark is a system call and log analyzer. It combines the analysis and filtering features of Wireshark with the capture and data enrichment features of Falco. It can be used for troubleshooting, analysis, development and education.

Stratoshark is hosted by the Wireshark Foundation, a nonprofit which promotes protocol and system analysis education. Stratoshark and the foundation depend on your contributions in order to do their work. If you or your organization would like to contribute or become a sponsor, please visit wiresharkfoundation.org.

What’s New

The following changes have been made since version 1.0.0rc1:

  • The Preferences dialog works much better on small screens.

  • A theme designer (View › Internals › Theme Designer) has been added.

  • Several more themes have been added, including color blind-friendly themes.

  • All dialogs now have Help buttons and associated documentation.

  • The Lua debugger has been improved.

  • Many other UI, style, and theme improvements.

The following changes have been made since version 0.10.4:

  • The Windows and macOS installers now ship with Falco libs 0.26.1, which adds a raw scap/pcapng block processing engine.

  • Many style and theme issues have been fixed.

  • macOS disk images and applications are now signed using certificates issued by Apple’s Developer ID Certification Authority (G2). The previous certificate was issued by Apple’s Developer ID Certification Authority, which expires in early 2027.

The following changes have been made since version 0.10.3:

  • The user interface icons have been refreshed, and now scale with the View zoom settings.

  • Holding down ↓ and ↑ will move rapidly through the event list.

  • The event bytes pane can show text as UTF-8. Multi-byte characters are drawn over the column of their first byte with a “]” over their last byte, and hovering over any of those bytes highlights the whole character.

  • Coloring rules are now saved as a JSONC (JSON with comments) file. The legacy colorfilters file is only read, and converted, when no personal coloring_rules.jsonc exists; otherwise only the JSONC file is used, so deleted rules no longer reappear from an old legacy file. A personal coloring_rules.jsonc that cannot be parsed is now reported instead of silently treated as empty. Support for the legacy file format will be removed in a future release.

  • Support for automatic update notification and updates on Linux distributions supporting PackageKit over D-Bus.

The following changes have been made since version 0.10.2:

  • The minimum supported Windows version is Windows 10 21H2 (build 19044) or Windows Server 2022.

  • Extcap interfaces now support "bookmarks," which let you have multiple configurations for the same interfaces. Extcap configurations are now shared across profiles, and existing per-profile configurations will be migrated to bookmarks. Issue 14224.

  • An issue which prevented loading .scap files generated by Falco or the sysdig CLI utility has been fixed.

The following changes have been made since version 0.10.1:

  • Timestamps missing in Stratoshark in 0.10.0 and 0.10.1. Issue 21406.

The following changes have been made since version 0.10.0:

  • The Stratoshark Windows installer now includes a DLL that was required by the cloudtrail and gcpaudit plugins.

  • Wireshark appears in German where Systemlanguage is Dutch. Issue 20347.

  • If you double-click an interface in the welcome screen interface list, and have typed nothing in the capture filter box, the system reports an invalid capture filter. Issue 21303.

  • Qt: Appearance mode is stored per-profile while theme name is global — theme flips on profile switch. Issue 21311.

  • Qt: 'Recent filters' arrow button gives no hover/pressed feedback. Issue 21322.

  • Qt: Hidden interfaces (Welcome page right-click) not persisted across profile switch or restart. Issue 21325.

  • Qt: Preferences dialog left category tree cannot be resized (labels truncated, only horizontal scrollbar) Issue 21327.

  • Stratoshark: no-libpcap compilation broken (actionCaptureRestart) — fix from 554baf6294 never applied. Issue 21328.

  • Qt: Make theme preview resemble a real Wireshark window (mini packet-list mockup) Issue 21329.

  • stratoshark -D lists a bunch of network capture devices. Issue 21332.

The following changes have been made since version 0.9.3:

  • Stratoshark can now read Process Monitor (Procmon) files.

  • The welcome page has been redesigned to be more informative and easier to navigate. It now highlights the learning sections better and includes a new sidebar with tips and tricks for using Wireshark effectively. The welcome page is now also more accessible, with improved keyboard navigation and screen reader support.

  • A built-in Lua script debugger has been added. It supports breakpoints, single-stepping, variable inspection, expression evaluation, and stack traces.

  • Themes Stratoshark now uses the same theme system as Wireshark. The colors used throughout the GUI, including graphs, come from a theme instead of individual color preferences; event coloring rules are unchanged. The Appearance › Theme preferences page lets you pick a theme, choose Light, Dark, or System appearance, and preview the result before applying it. See Theme preferences in the User’s Guide for details. Besides the default Stratoshark Default theme, a High Contrast theme, two color-blind friendly themes, Protanopia & Deuteranopia and Tritanopia, and the themes Solarized, Catppuccin Frappé, Catppuccin Macchiato, Catppuccin Mocha, Tokyo Night and Tokyo Night Storm are included. A new Contrast setting (System, Standard, or High) raises the contrast of any theme; System follows the contrast preference of the operating system. The expert information severity icons now differ by shape as well as by color. You can add your own themes as .jsonc files in the personal themes folder, which is shown in the About dialog’s Folders tab and opens from Help › Personal Themes Folder. See Personal themes for details. If you had customized the event selection, marked, ignored, or Follow Stream colors in the Default profile, Stratoshark converts them once into a personal theme named Personal (Migrated) and selects it, so those colors are kept.

  • Theme Designer The new View › Internals › Theme Designer…​ tool, also reachable from the Theme Designer…​ button on the Appearance › Theme preferences page, lets you create your own themes. Copy any theme or start from the default, then edit every color a theme file can set (including the graph colors) and the theme fonts. Colors that are derived from others are shown read-only. Edited colors and fonts are highlighted and can be reverted one by one, and a code view shows the generated JSONC with a diff against the base theme. A mock welcome page and packet list, shown on two tabs, let you try the result in light and dark before you use it. Clicking a part of a sample selects the color that draws it in the Colors tab, and the context menu of a sample lists all colors of that part and saves the sample as an image. Derived colors have a context menu entry that jumps to the color they are computed from. Themes that ship with Stratoshark are read-only and can only be copied. Your own themes are stored with the other personal themes and can be renamed and deleted. Themes can be exported to a .jsonc file and imported from one to exchange them with colleagues; imported files are validated and problems are reported.

  • Zooming (View › Zoom In / View › Zoom Out) now scales the whole window, including the capture and display filter fields and other window elements. Previously only the packet list and detail pane text size changed. The new behavior should be much more useful for demos and presentations.

  • The keyboard shortcuts dialog (About Wireshark → Keyboard Shortcuts) has been moved out of of the About dialog to the menu View → Internals → Keyboard Shortcuts and now has a button to print the list of keyboard shortcuts to an HTML file.

  • The application icon has been updated to support Liquid Glass on macOS Tahoe.

  • Stratoshark and strato can now read plain Kubernetes Audit logs and Google Cloud Audit logs, and CloudTrail logs.

  • The CloudTrail and Google Cloud Audit log plugins have been translated to Rust on macOS and Windows. Issue 20869

The following changes have been made since version 0.9.2:

  • The Windows installers now ship with Qt 6.8.3. They previously shipped with Qt 6.8.1.

  • Stratoshark now ships with “strato”, a command line tool similar to tshark.

  • The Windows and macOS packages now ship with the gcpaudit and k8saudit plugins.

  • The Falco Events dissector now adds IP geolocation fields alongside IPv4 and IPv6 address fields.

The following changes have been made since version 0.9.1:

  • A new “Plots” dialog has been added, which provides scatter plots in contrast to the “I/O Graphs” dialog, which provides histograms. The Plots dialog window supports multiple plots, markers, and automatic scrolling.

  • The Falco Bridge dissector has been renamed to Falco Events. Filter fields now have a "falcoevents" protocol prefix, but a "falcobridge" protocol alias has been added for backward compatibility. Issue 20397

  • Stratoshark can now show field offsets for supported plugins.

  • Cloudtrail log messages can now be viewed as formatted JSON data.

  • The system call dissector now has a "falcoevents.fd.stream" field, which provides a unique number for each file descriptor. The "Follow File Descriptor Stream" feature now uses this field to track streams. Issue 20538

  • We now ship universal macOS installers instead of separate packages for Arm64 and Intel. Issue 17294

The following changes have been made since version 0.9.0:

  • The application icons have been updated.

Bug Fixes

The following bugs have been fixed since version 0.9.3:

In order to work around issue 20869, the macOS package ships with the gcpaudit and k8saudit plugins disabled. In order to enable them, you can rename them from Stratoshark.app/Contents/PlugIns/stratoshark/falco/plugin.so.disabled to Stratoshark.app/Contents/PlugIns/stratoshark/falco/plugin.so.

  • Interfaces hidden from the welcome page are now remembered across profile switches and restarts. Issue 21325

The following bugs have been fixed since version 0.9.2:

  • .scap file extension wrongly associated with Wireshark. Issue 20583.

  • sshdig should have a snaplen option. Issue 20586.

The following bugs have been fixed since version 0.9.1:

  • Stratoshark help message has Wiresharkisms in it. Issue 20229.

  • Stratoshark and editcap could write incorrect block types. Merge request 19238.

  • Stratoshark says I can’t capture on local interfaces. Issue 20494.

  • Stratoshark: Crash While Sorting on evt.buflen column. Issue 20571.

The following bugs have been fixed since version 0.9.0:

  • Falco Bridge: Empty frame.protocols field. Issue 20248.

  • Sysdig event and Falco bridge dissection mismatch due to unsupported pcapng block types. Issue 20358.

New and Updated Features

Stratoshark can capture system calls locally on Linux and a variety of log sources on Windows, macOS, and Linux.

The following features are either new or have been significantly updated since version 0.9.0:

  • The welcome screen’s capture-source activity sparklines now keep their history for the whole session. Previously the sparklines, and the activity-first ordering of the source list, were reset whenever you started or stopped a capture or returned to the welcome screen, so the list re-shuffled each time. Now the history persists, the ordering stays stable, and a break in a sparkline marks the interval during which a capture was running (statistics are not sampled while capturing). When a source is dropping packets, the drops are shown as a separate line. Issue 21318

  • On Linux, Stratoshark can check whether the distribution offers a newer version of the package it was installed from. The check uses PackageKit and never contacts wireshark.org; the update itself is installed through the desktop’s software center (e.g. GNOME Software or KDE Discover). Self-compiled builds and Flatpak, Snap or AppImage installations are not checked. PackageKit is queried over D-Bus, so building with this support only requires the Qt DBus module.

  • Disabled coloring rules can now be shown in the packet details. With the new preference gui.coloring_rules_include_disabled (Edit › Preferences › Appearance › Layout, "Show disabled coloring rules", off by default) a disabled rule that matches a packet is listed under the Frame tree, dimmed and in italics, and can be found with the frame.coloring_rule.* fields. Disabled rules never color packets. When several rules match, they are listed as a "Coloring Rules" subtree with one entry per rule (name, filter string and a Disabled flag); the new frame.coloring_rule.count field holds the number of listed rules. In the Frame tree, the context menu of a coloring rule now offers Disable and Enable, which change the rule itself, are saved with the coloring rules and re-dissect the capture.

  • The Help menu has a new Help › Discord entry, which opens the invitation to the Wireshark Discord server.

  • The Help menu entries Website and Wiki now show the Stratoshark application icon on Linux and Windows (previously they had no icon), and Ask (Q&A) no longer has an icon.

  • The monospace font used in the packet list, packet details, packet bytes and other text views is now chosen on the new Edit › Preferences › Appearance › Fonts page, below Theme, instead of in the Theme page and the system font dialog. The page lists the font families, each drawn in its own typeface, with a filter field, a "Show only monospaced fonts" option (on by default), the styles of the family, the size (steps of 0.5 points, can be typed) and a sample. Strikeout and Underline can be set, and bold or oblique styles are now applied (they were stored but ignored before). An italic or underlined font hides the italic and underline markers in the packet details, so only their colors mark disabled coloring rules and links then. The inline page also fixes the font selection on macOS, where the native font panel ignored the monospaced filter and offered no usable size control. Issue 21688

  • A new Distribution dialog (Statistics › Distribution, or the "Distribution" entry in the packet details context menu) counts how often the values of up to four fields occur. The fields are entered in a separate Fields line (comma separated, with completion and validation), and the Display filter line limits the events that are counted. Values sort by their type (numbers, addresses), the new Resolve values option shows value strings, a Show chart option draws a bar chart of the most frequent values, and the table updates in place during a live capture. Rows can be used as filters from their context menu (including Copy as Filter) or sent to the I/O Graph with Show in I/O Graph. The copied and saved text includes the Count column, -z distribution,<fields> opens the dialog, and the dialog has a Help button.

Removed Features and Support

Dumpcap’s TCP@host:port interface has been removed.

Building with Qt 5 is no longer supported.

Getting Stratoshark

Stratoshark source code and installation packages are available from https://www.stratoshark.org/download.html.

File Locations

Stratoshark looks in several different locations for preference files, plugins, and other files. These locations vary from platform to platform. You can use Help › About Stratoshark › Folders to find the default locations on your system.

Getting Help

Community support is available on Wireshark’s Q&A site and on the wireshark-users mailing list. Subscription information and archives for all of Wireshark’s mailing lists can be found on the mailing list site.

Bugs and feature requests can be reported on the issue tracker.

You can learn system call and log analysis and meet Stratoshark’s developers at SharkFest.

How You Can Help

The Wireshark Foundation helps as many people as possible understand their systems and networks as much as possible. You can find out more and donate at wiresharkfoundation.org.