gst-inspect-0.10
Inspect GStreamer elements, plugins, and properties
SYNOPSIS
gst-inspect-0.10 [OPTIONS] [ELEMENT_NAME | PLUGIN_NAME]
PARAMETERS
--help
Displays a help message with command-line options.
--version
Shows the GStreamer 0.10 core and gst-inspect-0.10 tool version information.
--print-plugins
Prints a list of all registered GStreamer 0.10 plugins found on the system.
--print-elements
Prints a list of all registered GStreamer 0.10 elements, categorized by plugin.
--print-uris
Lists all URI handlers supported by GStreamer 0.10 (e.g., file://, http://).
--print-formats
Outputs a list of all supported GStreamer 0.10 media formats.
--print-supported
Prints a list of supported types (e.g., video, audio) and their associated capabilities.
--print-features
Lists all supported GStreamer 0.10 features, such as element factories or type finds.
-a, --all
When used without a specific element or plugin name, it lists all elements, including base elements not part of a specific plugin.
-e ELEMENT_NAME, --element ELEMENT_NAME
Inspects and prints detailed information about a specific GStreamer 0.10 element identified by its name (e.g., fakesink, decodebin).
-p PLUGIN_NAME, --plugin PLUGIN_NAME
Inspects and prints detailed information about a specific GStreamer 0.10 plugin identified by its name (e.g., ogg, vorbis).
-f, --full
When inspecting an element or plugin, provides the most comprehensive information, including all properties, pads, signals, and their detailed descriptions.
-s, --strict
Filters the output to only show strict information, often related to compliance or specific types of elements.
--types
Prints a list of plugin types and their corresponding descriptions.
DESCRIPTION
The gst-inspect-0.10 command is a powerful command-line tool designed for the GStreamer 0.10 multimedia framework. Its primary purpose is to inspect and provide detailed information about installed GStreamer plugins, elements, and features. It helps developers and users understand the capabilities of various GStreamer components, including their properties, pads (input/output points), signals, and supported formats. This utility is indispensable for debugging pipelines, learning about available functionalities, and developing GStreamer applications on systems or environments that still rely on the GStreamer 0.10 API series. While largely superseded by the 1.x series, gst-inspect-0.10 remains crucial for maintaining and working with legacy GStreamer-based applications.
CAVEATS
This command specifically targets the GStreamer 0.10 API series. Most modern Linux distributions and GStreamer applications now use GStreamer 1.x. If you are working with a recent GStreamer setup, you should typically use gst-inspect-1.0 instead.
The functionality and available plugins might differ significantly between 0.10 and 1.x versions. Ensure you are using the correct version of gst-inspect that matches your GStreamer installation and application dependencies. It may not be installed by default on systems primarily shipping GStreamer 1.x.
OUTPUT INTERPRETATION
When inspecting an element with gst-inspect-0.10, the output typically includes several sections:
Factory: Basic information about the element's origin.
Plugin: The plugin the element belongs to.
Documentation: A brief description of the element's purpose.
Pads: Lists input (sink) and output (src) pads, detailing their capabilities (supported media types).
Properties: Describes configurable attributes of the element, including their type, default values, and range. These can be set during pipeline construction (e.g., gst-launch-0.10 filesrc location=audio.mp3 ! ...).
Signals: Events the element might emit.
Understanding these sections is crucial for constructing correct GStreamer pipelines and leveraging element functionalities.
COMMON USAGE EXAMPLES
To list all available elements:
gst-inspect-0.10 --elements
To inspect a specific element like oggdemux:
gst-inspect-0.10 oggdemux
To get full details about the audioconvert element:
gst-inspect-0.10 -f audioconvert
To list all plugins:
gst-inspect-0.10 --plugins
HISTORY
The gst-inspect-0.10 command was part of the GStreamer 0.10 stable release series, which was initially released in 2005 and served as the primary stable branch for many years. It was the standard tool for inspecting GStreamer components during that period. With the release of GStreamer 1.0 in 2012, which introduced significant API and ABI changes, the 0.10 series began to be phased out. However, due to its widespread adoption, many legacy systems, applications, and embedded devices still rely on GStreamer 0.10, making gst-inspect-0.10 an essential tool for maintaining and troubleshooting such environments.
SEE ALSO
gst-launch-0.10(1), gst-discoverer-0.10(1), gst-inspect-1.0(1), gst-launch-1.0(1), gst-discoverer-1.0(1)


