# pulsesrc

The pulsesrc plugin interacts with the underlying PulseAudio sound server to capture the pulse-coded modulation (PCM) samples.

The PulseAudio server interacts with the underlying hardware to provide the capture capability and is based on the [GstAudioSrc](https://gstreamer.freedesktop.org/documentation/audio/gstaudiosrc.html#GstAudioSrc) base class.

## Inheritance chain

[GObject](https://docs.gtk.org/gobject/) → [GstObject](https://gstreamer.freedesktop.org/documentation/gstreamer/gstobject.html?gi-language=c) → [GstElement](https://gstreamer.freedesktop.org/documentation/gstreamer/gstelement.html?gi-language=c) → [GstBaseSrc](https://gstreamer.freedesktop.org/documentation/base/gstbasesrc.html#GstBaseSrc) → [GstPushSrc](https://gstreamer.freedesktop.org/documentation/base/gstpushsrc.html#GstPushSrc) → [GstAudioBaseSrc](https://gstreamer.freedesktop.org/documentation/audio/gstaudiobasesrc.html#GstAudioBaseSrc) → [GstAudioSrc](https://gstreamer.freedesktop.org/documentation/audio/gstaudiosrc.html#GstAudioSrc) → GstPulseSrc

The following tables provide information on pad templates and element properties of pulsesrc. For use cases, see Audio (only) capture.

## Pad configuration

| Pad Name | Capabilities | Capabilities | Capabilities |
| --- | --- | --- | --- |
| <br>SRC template: 'src'<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p><em>Availability:</em>  Always</p></li><br>> <li><p><em>Direction:</em>  src</p></li><br>> </ul> | audio/x-raw | format: | { (string)S16LE, (string)S16BE, (string)F32LE, (string)F32BE, (string)S32LE, (string)S32BE, (string)S24LE, (string)S24BE, (string)S24\_32LE, (string)S24\_32BE, (string)U8 } |
| <br>SRC template: 'src'<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p><em>Availability:</em>  Always</p></li><br>> <li><p><em>Direction:</em>  src</p></li><br>> </ul> | audio/x-raw | layout: | interleaved |
| <br>SRC template: 'src'<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p><em>Availability:</em>  Always</p></li><br>> <li><p><em>Direction:</em>  src</p></li><br>> </ul> | audio/x-raw | rate: | [ 1, 22579200 ] |
| <br>SRC template: 'src'<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p><em>Availability:</em>  Always</p></li><br>> <li><p><em>Direction:</em>  src</p></li><br>> </ul> | audio/x-raw | channels: | [ 1, 32 ] |
| <br>SRC template: 'src'<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p><em>Availability:</em>  Always</p></li><br>> <li><p><em>Direction:</em>  src</p></li><br>> </ul> | audio/x-alaw | rate: | [ 1, 22579200 ] |
| <br>SRC template: 'src'<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p><em>Availability:</em>  Always</p></li><br>> <li><p><em>Direction:</em>  src</p></li><br>> </ul> | audio/x-alaw | channels: | [ 1, 32 ] |
| <br>SRC template: 'src'<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p><em>Availability:</em>  Always</p></li><br>> <li><p><em>Direction:</em>  src</p></li><br>> </ul> | audio/x-mulaw | rate: | [ 1, 22579200 ] |
| <br>SRC template: 'src'<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p><em>Availability:</em>  Always</p></li><br>> <li><p><em>Direction:</em>  src</p></li><br>> </ul> | audio/x-mulaw | channels: | [ 1, 32 ] |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |

## Element configuration

Table : Element properties of pulsesrc

| Property | Description |
| --- | --- |
| name | - The name of the object.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>String. Default: "pulsesrc0"</p></li><br></ul> |
| parent | - The parent of the object.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>Object of type "GstObject"</p></li><br></ul> |
| blocksize | - Size in bytes to read per buffer (-1 = default).<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>Unsigned Integer. Range: 0 - 4294967295 Default: 0</p></li><br></ul> |
| num-buffers | - Number of buffers to output before sending EOS (-1 = unlimited).<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>Integer. Range: ˗1 to 2147483647, default: ˗1</p></li><br></ul> |
| typefind | - Run type find before negotiating (deprecated, non-functional).<br>    - <ul class="simple"><br><li><p>flags: readable, writable, deprecated</p></li><br><li><p>Boolean. Default: false</p></li><br></ul> |
| do-timestamp | - Apply current stream time to buffers.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>Boolean. Default: true</p></li><br></ul> |
| buffer-time | - Size of audio buffer in microseconds. This size is the maximum amount of data that's buffered in the device and the maximum latency that the source reports. The pulsesrc plugin can ignore this value.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>Integer64. Range: 1 - 9223372036854775807 Default: 200000</p></li><br></ul> |
| latency-time | - The minimum amount of data to read in each iteration is in microseconds. This is the minimum latency that the source reports. The plugin can ignore this value.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>Integer64. Range: 1 - 9223372036854775807 Default: 10000</p></li><br></ul> |
| actual-buffer-time | - Actual configured size of audio buffer in microseconds.<br>    - <ul class="simple"><br><li><p>flags: readable</p></li><br><li><p>Integer64. Range: ˗1 to 9223372036854775807, default: ˗1</p></li><br></ul> |
| actual-latency-time | - Actual configured audio latency in microseconds.<br>    - <ul class="simple"><br><li><p>flags: readable</p></li><br><li><p>Integer64. Range: ˗1 to 9223372036854775807, default: ˗1</p></li><br></ul> |
| provide-clock | - Provide a clock to be used as the global pipeline clock.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>Boolean. Default: true</p></li><br></ul> |
| slave-method | - Algorithm used to match the rate of the primary clock.<br>    - <ul><br><li><p>flags: readable, writable</p></li><br><li><p>Enum "GstAudioBaseSrcSlaveMethod" Default: 2, "skew"</p><br><blockquote><br><div><ul class="simple"><br><li><p>(0): resample - GST_AUDIO_BASE_SRC_SLAVE_RESAMPLE</p></li><br><li><p>(1): re-timestamp - GST_AUDIO_BASE_SRC_SLAVE_RE_TIMESTAMP</p></li><br><li><p>(2): skew - GST_AUDIO_BASE_SRC_SLAVE_SKEW</p></li><br><li><p>(3): none - GST_AUDIO_BASE_SRC_SLAVE_NONE</p></li><br></ul><br></div></blockquote><br></li><br></ul> |
| server | - The PulseAudio server for the connection.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>String. Default: null</p></li><br></ul> |
| device | - The PulseAudio source device for connection.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>String. Default: null</p></li><br></ul> |
| current-device | - The current PulseAudio source device.<br>    - <ul class="simple"><br><li><p>flags: readable</p></li><br><li><p>String. Default: ""</p></li><br></ul> |
| device-name | - Human-readable name of the sound device.<br>    - <ul class="simple"><br><li><p>flags: readable</p></li><br><li><p>String. Default: null</p></li><br></ul> |
| volume | - Linear volume of this stream, 1.0=100%.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>Double. Range: 0 - 10 Default: 1</p></li><br></ul> |
| mute | - Mute state of this stream.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>Boolean. Default: false</p></li><br></ul> |
| client-name | - The PulseAudio client\_name\_to\_use.<br>    - <ul class="simple"><br><li><p>flags: readable, writable, changeable only in NULL or READY state</p></li><br><li><p>String. Default: "gst-inspect-1.0"</p></li><br></ul> |
| stream-properties | - A list of PulseAudio stream properties.<br>    - <ul class="simple"><br><li><p>flags: readable, writable</p></li><br><li><p>Boxed pointer of type "GstStructure"</p></li><br></ul> |
| source-output-index | - The index of the PulseAudio source output corresponding to this record stream.<br>    - <ul class="simple"><br><li><p>flags: readable</p></li><br><li><p>Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295</p></li><br></ul> |
| stream-flags | - Stream flags (not all default flags can be overridden).<br>    - <ul><br><li><p>flags: writable</p></li><br><li><p>Flags "GstPulseStreamFlags" Default: 0x0000000f, "Timing update requests are issued periodically and automatically. Don't force the time to increase monotonically and interpolate the latency for this stream.</p><br><blockquote><br><div><ul class="simple"><br><li><p>((0x00000000): Flag to pass when no specific options are needed - GST_PULSE_STREAM_NOFLAGS</p></li><br><li><p>(0x00000001): Create the corked stream- GST_PULSE_STREAM_START_CORKED</p></li><br><li><p>(0x00000002): Interpolate the latency for this stream - GST_PULSE_STREAM_INTERPOLATE_TIMING</p></li><br><li><p>(0x00000004): Don't force the time to increase monotonically - GST_PULSE_STREAM_NOT_MONOTONIC</p></li><br><li><p>(0x00000008): Timing update requests are issued periodically and automatically - GST_PULSE_STREAM_AUTO_TIMING_UPDATE</p></li><br><li><p>(0x00000010): Don't remap channels by their name, instead map them simply by their index - GST_PULSE_STREAM_NO_REMAP_CHANNELS</p></li><br><li><p>(0x00000020): When remapping channels by name, don't upmix or downmix them to related channels - GST_PULSE_STREAM_NO_REMIX_CHANNELS</p></li><br><li><p>(0x00000040): Use the sample format of the sink/device this stream is being connected to - GST_PULSE_STREAM_FIX_FORMAT</p></li><br><li><p>(0x00000080): Use the sample rate of the sink - GST_PULSE_STREAM_FIX_RATE</p></li><br><li><p>(0x00000100): Use the number of channels and the channel map of the sink - GST_PULSE_STREAM_FIX_CHANNELS</p></li><br><li><p>(0x00000200): Don't allow moving of this stream to another sink/device - GST_PULSE_STREAM_DONT_MOVE</p></li><br><li><p>(0x00000400): Allow dynamic changing of the sampling rate during playback - GST_PULSE_STREAM_VARIABLE_RATE</p></li><br><li><p>(0x00000800): Find peaks instead of resampling - GST_PULSE_STREAM_PEAK_DETECT</p></li><br><li><p>(0x00001000): Create in muted state - GST_PULSE_STREAM_START_MUTED</p></li><br><li><p>(0x00002000): Try to adjust the latency of the sink/source based on the requested buffer metrics and adjust buffer metrics accordingly - GST_PULSE_STREAM_ADJUST_LATENCY</p></li><br><li><p>(0x00004000): Enable compatibility mode for legacy clients that rely on a classic hardware device fragment-style playback model - GST_PULSE_STREAM_EARLY_REQUESTS</p></li><br><li><p>(0x00008000): If set, this stream isn't considered when it's checked whether the stream is connected. It's auto-suspended. GST_PULSE_STREAM_DONT_INHIBIT_AUTO_SUSPEND</p></li><br><li><p>(0x00010000): Create in unmuted state - GST_PULSE_STREAM_START_UNMUTED</p></li><br><li><p>(0x00020000): If the sink/source of this stream is connected, it's suspended during the creation of this stream, causing it to fail - GST_PULSE_STREAM_FAIL_ON_SUSPEND</p></li><br><li><p>(0x00040000): If a volume is passed when this stream is created, creation of this stream causes it to fail - GST_PULSE_STREAM_RELATIVE_VOLUME</p></li><br><li><p>((0x00080000): Used to tag content that's rendered by pass-through sinks - GST_PULSE_STREAM_PASSTHROUGH write-only</p></li><br></ul><br></div></blockquote><br></li><br></ul> |

Last Published: Apr 02, 2026

[Previous Topic
Configure audio plugins](https://docs.qualcomm.com/bundle/publicresource/80-70029-50/topics/audio-plugins.md) [Next Topic
pulsesink](https://docs.qualcomm.com/bundle/publicresource/80-70029-50/topics/pulsesink.md)

Source: [https://docs.qualcomm.com/doc/80-70029-50/topic/pulsesrc.html](https://docs.qualcomm.com/doc/80-70029-50/topic/pulsesrc.html)