pw-dot
TLDR
Generate a graph to pw.dot file
$ pw-dot
Read objects from pw-dump JSON file$ pw-dot -j [path/to/file.json]
Specify output file and show all object types$ pw-dot -o [path/to/file.dot] -a
Print graph to stdout with object properties$ pw-dot -o - -d
Generate graph from remote instance showing linked objects$ pw-dot -r [remote_name] -s
Lay graph from left to right$ pw-dot -L
Use 90-degree angles in edges$ pw-dot -9
SYNOPSIS
pw-dot [options]
DESCRIPTION
pw-dot generates Graphviz DOT files from the PipeWire graph, visualizing the connections between nodes, ports, and devices. The output can be rendered to images using the dot command from Graphviz.
This is useful for understanding audio/video routing, debugging connection issues, and documenting system audio configurations.
PARAMETERS
-o, --output file
Output file (default: pw.dot, use - for stdout)-a, --all
Show all object types-s, --smart
Show only linked objects-d, --detail
Show all object properties-r, --remote name
Connect to remote PipeWire instance-j, --json file
Read objects from pw-dump JSON file-L, --lr
Lay graph left to right-9, --90
Use 90-degree angles for edges-h, --help
Display help message
CAVEATS
Requires Graphviz to render the DOT file to images. Complex graphs with many objects can be difficult to read; use --smart to show only connected objects.
HISTORY
Part of PipeWire, providing visualization of the multimedia graph. Useful for developers, system integrators, and users troubleshooting audio routing.
