pulsesrc

pulsesrc — Captures audio from a PulseAudio server

Synopsis

struct              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

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

Synopsis

Element Information

plugin

pulseaudio

author

Lennart Poettering

class

Source/Audio

Element Pads

name

src

direction

source

presence

always

details

audio/x-raw-int, endianness=(int){ 1234, 4321 }, signed=(boolean)true, width=(int)16, depth=(int)16, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 32 ]

audio/x-raw-float, endianness=(int){ 1234, 4321 }, width=(int)32, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 32 ]

audio/x-raw-int, endianness=(int){ 1234, 4321 }, signed=(boolean)true, width=(int)32, depth=(int)32, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 32 ]

audio/x-raw-int, signed=(boolean)false, width=(int)8, depth=(int)8, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 32 ]

audio/x-alaw, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 32 ]

audio/x-mulaw, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 32 ]

Details

struct GstPulseSrc

struct 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.

1
2
3
4
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