pulsesrc

pulsesrc — Captures audio from a PulseAudio server

Synopsis

                    GstPulseSrc;

Object Hierarchy

  GObject
   +----GstObject
         +----GstElement
               +----GstBaseSrc
                     +----GstPushSrc
                           +----GstBaseAudioSrc
                                 +----GstAudioSrc
                                       +----GstPulseSrc

Implemented Interfaces

GstPulseSrc implements GstImplementsInterface, GstMixer and GstPropertyProbe.

Properties

  "device"                   gchar*                : Read / Write
  "server"                   gchar*                : Read / Write
  "device-name"              gchar*                : Read
  "stream-properties"        GstStructure*         : Read / Write
  "client"                   gchar*                : Read / Write

Description

This element captures audio from a PulseAudio sound server.

Example pipelines

gst-launch -v pulsesrc ! audioconvert ! vorbisenc ! oggmux ! filesink location=alsasrc.ogg
Record from a sound card using pulseaudio and encode to Ogg/Vorbis.

Details

GstPulseSrc

typedef struct _GstPulseSrc GstPulseSrc;

Property Details

The "device" property

  "device"                   gchar*                : Read / Write

The PulseAudio source device to connect to.

Default value: NULL


The "server" property

  "server"                   gchar*                : Read / Write

The PulseAudio server to connect to.

Default value: NULL


The "device-name" property

  "device-name"              gchar*                : Read

Human-readable name of the sound device.

Default value: NULL


The "stream-properties" property

  "stream-properties"        GstStructure*         : Read / Write

List of pulseaudio stream properties. A list of defined properties can be found in the pulseaudio api docs.

Below is an example for registering as a music application to pulseaudio.

GstStructure *props;
props = gst_structure_from_string ("props,media.role=music", NULL);
g_object_set (pulse, "stream-properties", props, NULL);
gst_structure_free (props);

Since 0.10.26


The "client" property

  "client"                   gchar*                : Read / Write

The PulseAudio client_name_to_use.

Default value: "<unknown>"

See Also

pulsesink, pulsemixer