pw-profiler(1)

πŸ’– pw-profiler β€” the PipeWire profiler, bestie edition πŸ’–

okay so real talk: this is pw-profiler(1), like, the PipeWire profiler? it lives in the General Commands Manual and it's about to spill all the tea on how your audio graph is actually performing πŸ‘‘


✨ SYNOPSIS ✨

pw-profiler [options]

that's it. that's the whole vibe. go off πŸ’…


🌸 DESCRIPTION 🌸

so you wanna start profiling a PipeWire instance. icon behaviour, honestly.

if the server has the profiler module loaded, this program will connect to it and log the profiler data. and bestie, "profiler data" means times and durations β€” specifically when processing nodes and devices started and completed. it's like a little diary of your graph's whole day, no cap ⏱️✨

when this program is stopped, it generates a set of gnuplot files plus a script to generate SVG files from the .plot files. and also a .html file so you can visualize the profiling results in a browser. so you stop it and boom πŸ’₯ β€” charts. we love a glow-up.

fun fact that is actually a fact: this function uses the same data used by pw-top. same data, different serve 🫢

πŸŽ€ OPTIONS πŸŽ€

  • -r | --remote=NAME β€” the name of the remote instance to monitor. leave it unspecified and it just connects to the default PipeWire instance. defaults stay winning ✨
  • -h | --help β€” show help. short, sweet, slay πŸ’…
  • --version β€” show version information. know your roots, queen πŸ‘‘
  • -o | --output=FILE β€” profiler output name, default "profiler.log". name your baby whatever you want 🍼 (but the default is literally profiler.log, so)

πŸ‘‘ AUTHORS πŸ‘‘

the PipeWire Developers 🧚

genuinely obsessed with them, fr fr πŸ’œ


🌈 SEE ALSO 🌈

go read those too, iykyk πŸ“šβœ¨


and that's the whole page, bestie!! this lil' number is from PipeWire version 1.6.11, and yeah it's a General Commands Manual situation. mwah πŸ’‹ go profile something gorgeous πŸ¦‹πŸ’–

πŸ“¦ where this page comes from