pulsesrc

This element captures audio from a PulseAudio sound server.

Example pipelines

 gst-launch-1.0 -v pulsesrc ! audioconvert ! vorbisenc ! oggmux ! filesink location=alsasrc.ogg

Record from a sound card using pulseaudio and encode to Ogg/Vorbis.

Hierarchy

GObject
    ╰──GInitiallyUnowned
        ╰──GstObject
            ╰──GstElement
                ╰──GstBaseSrc
                    ╰──GstPushSrc
                        ╰──GstAudioBaseSrc
                            ╰──GstAudioSrc
                                ╰──pulsesrc

Implemented interfaces

Factory details

Authors: – Lennart Poettering

Classification: – Source/Audio

Rank – primary + 10

Plugin – pulseaudio

Package – GStreamer Good Plug-ins

Pad Templates

src

audio/x-raw:
         format: { S16LE, S16BE, F32LE, F32BE, S32LE, S32BE, S24LE, S24BE, S24_32LE, S24_32BE, U8 }
         layout: interleaved
           rate: [ 1, 384000 ]
       channels: [ 1, 32 ]
audio/x-alaw:
           rate: [ 1, 384000 ]
       channels: [ 1, 32 ]
audio/x-mulaw:
           rate: [ 1, 384000 ]
       channels: [ 1, 32 ]

Presence – always

Direction – src

Object type – GstPad

Properties

client-name 

“client-name” gchararray

The PulseAudio client name to use.

Flags : Read / Write

Default value : gst-hotdoc-plugins-scanner

current-device 

“current-device” gchararray

The current PulseAudio source device

Flags : Read

device 

“device” gchararray

The PulseAudio source device to connect to

Flags : Read / Write

Default value : NULL

device-name 

“device-name” gchararray

Human-readable name of the sound device

Flags : Read

Default value : NULL

mute 

“mute” gboolean

Whether the stream is muted or not.

Flags : Read / Write

Default value : false

server 

“server” gchararray

The PulseAudio server to connect to

Flags : Read / Write

Default value : NULL

source-output-index 

“source-output-index” guint

The index of the PulseAudio source output corresponding to this element.

Flags : Read

Default value : -1

stream-properties 

“stream-properties” GstStructure *

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);

Flags : Read / Write

volume 

“volume” gdouble

The volume of the record stream.

Flags : Read / Write

Default value : 1

The results of the search are