carta
pw-dot(1)

pw-dot1

The pipewire dot graph dump

Usage

pw-dot [options]

Overview

Create a .dot file of the PipeWire graph.

The .dot file can then be visualized with a tool like dotty or rendered to a PNG file with dot -Tpng pw.dot -o pw.png.

Options

-r | --remote=NAME

The name the remote instance to connect to. If left unspecified, a connection is made to the default PipeWire instance.

-h | --help

Show help.

--version

Show version information.

-a | --all

Show all object types.

-s | --smart

Show linked objects only.

-d | --detail

Show all object properties.

-o FILE | --output=FILE

Output file name (Default pw.dot). Use - for stdout.

-L | --lr

Lay the graph from left to right, instead of dot's default top to bottom.

-9 | --90

Lay the graph using 90-degree angles in edges.

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)

--90 since Debian 12 (Bookworm); --lr since Debian 12 (Bookworm); -9 since Debian 12 (Bookworm); -L since Debian 12 (Bookworm).

Authors

The PipeWire Developers <https://gitlab.freedesktop.org/pipewire/pipewire/issues>; PipeWire is available from <https://pipewire.org>

From pipewire 1:1.6.10-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.