2023-12-30 13:06:53 +00:00
|
|
|
# pw-dot
|
|
|
|
|
|
|
|
> Create `.dot` files of the PipeWire graph.
|
|
|
|
> See also: `dot`, for rendering graph.
|
|
|
|
> More information: <https://docs.pipewire.org/page_man_pw-dot_1.html>.
|
|
|
|
|
|
|
|
- Generate a graph to `pw.dot` file:
|
|
|
|
|
|
|
|
`pw-dot`
|
|
|
|
|
2024-06-04 01:11:32 +01:00
|
|
|
- Read objects from `pw-dump` JSON file:
|
2023-12-30 13:06:53 +00:00
|
|
|
|
2024-06-04 01:11:32 +01:00
|
|
|
`pw-dot {{-j|--json}} {{path/to/file.json}}`
|
|
|
|
|
2024-06-12 06:43:11 +01:00
|
|
|
- Specify an [o]utput file, showing all object types:
|
2024-06-04 01:11:32 +01:00
|
|
|
|
|
|
|
`pw-dot --output {{path/to/file.dot}} {{-a|--all}}`
|
2023-12-30 13:06:53 +00:00
|
|
|
|
|
|
|
- Print `.dot` graph to `stdout`, showing all object properties:
|
|
|
|
|
2024-06-04 01:11:32 +01:00
|
|
|
`pw-dot --output - {{-d|--detail}}`
|
2023-12-30 13:06:53 +00:00
|
|
|
|
2024-06-04 01:11:32 +01:00
|
|
|
- Generate a graph from a [r]emote instance, showing only linked objects:
|
2023-12-30 13:06:53 +00:00
|
|
|
|
2024-06-04 01:11:32 +01:00
|
|
|
`pw-dot --remote {{remote_name}} {{-s|--smart}}`
|
2023-12-30 13:06:53 +00:00
|
|
|
|
2024-06-12 06:43:11 +01:00
|
|
|
- Lay the graph from left to right, instead of dot's default top to bottom:
|
2023-12-30 13:06:53 +00:00
|
|
|
|
2024-06-04 01:11:32 +01:00
|
|
|
`pw-dot {{-L|--lr}}`
|
2023-12-30 13:06:53 +00:00
|
|
|
|
|
|
|
- Lay the graph using 90-degree angles in edges:
|
|
|
|
|
2024-06-04 01:11:32 +01:00
|
|
|
`pw-dot {{-9|--90}}`
|
|
|
|
|
|
|
|
- Display help:
|
|
|
|
|
|
|
|
`pw-dot --help`
|