Debugging Pipelines

GST_DEBUG

Set the debug level, optionally per component.

  • GST_DEBUG=2
  • GST_DEBUG="filesrc:5"
  • GST_DEBUG="filesrc:5,matroskademux:4"

GST_DEBUG_DUMP_DOT_DIR

Set the output directory for *.dot files describing the pipline configuration. Must be an absolute path.

  • GST_DEBUG_DUMP_DOT_DIR="/tmp/debug_gst/"
  • GST_DEBUG_DUMP_DOT_DIR="$(readlink -f ./dbg)"
  • GST_DEBUG_DUMP_DOT_DIR="$(mktemp -d)"

From within your application, you can use the following macros to generate *.dot files.

  • GST_DEBUG_BIN_TO_DOT_FILE()
  • GST_DEBUG_BIN_TO_DOT_FILE_WITH_TS()

Convert a *.dot file to *.png:

dot "${IN_FILE}.dot" -Tpng -o "${OUT_FILE}.png"