# 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

    GstStreamVolume

## 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