# alsasrc

This element reads data from an audio card using the ALSA API.

## Example pipelines

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

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

## Hierarchy

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

## Factory details

Authors: – Wim Taymans

Classification: – `Source/Audio`

Rank – primary

Plugin – gstalsa

Package – GStreamer Base Plug-ins

## Pad Templates

### `src`

    audio/x-raw:
             format: { F64LE, F64BE, F32LE, F32BE, S32LE, S32BE, U32LE, U32BE, S24_32LE, S24_32BE, U24_32LE, U24_32BE, S24LE, S24BE, U24LE, U24BE, S20LE, S20BE, U20LE, U20BE, S18LE, S18BE, U18LE, U18BE, S16LE, S16BE, U16LE, U16BE, S8, U8 }
             layout: interleaved
               rate: [ 1, 2147483647 ]
           channels: [ 1, 2147483647 ]

Presence – always

Direction – src

Object type – GstPad

## Properties

### actual-buffer-time

    “actual-buffer-time” gint64

Actual configured size of audio buffer in microseconds

Flags : Read

Default value : 18446744073709551615

### actual-latency-time

    “actual-latency-time” gint64

Actual configured audio latency in microseconds

Flags : Read

Default value : 18446744073709551615

### blocksize

    “blocksize” guint

Size in bytes to read per buffer (-1 = default)

Flags : Read / Write

Default value : 0

### buffer-time

    “buffer-time” gint64

Size of audio buffer in microseconds. This is the maximum amount of data that is buffered in the device and the maximum latency that the source reports. This value might be ignored by the element if necessary; see "actual-buffer-time"

Flags : Read / Write

Default value : 200000

### card-name

    “card-name” gchararray

Human-readable name of the sound card

Flags : Read

### device

    “device” gchararray

ALSA device, as defined in an asound configuration file

Flags : Read / Write

Default value : default

### device-name

    “device-name” gchararray

Human-readable name of the sound device

Flags : Read

Default value : NULL

### do-timestamp

    “do-timestamp” gboolean

Apply current stream time to buffers

Flags : Read / Write

Default value : false

### latency-time

    “latency-time” gint64

The minimum amount of data to read in each iteration in microseconds. This is the minimum latency that the source reports. This value might be ignored by the element if necessary; see "actual-latency-time"

Flags : Read / Write

Default value : 10000

### num-buffers

    “num-buffers” gint

Number of buffers to output before sending EOS (-1 = unlimited)

Flags : Read / Write

Default value : -1

### provide-clock

    “provide-clock” gboolean

Provide a clock to be used as the global pipeline clock

Flags : Read / Write

Default value : true

### slave-method

    “slave-method” GstAudioBaseSrcSlaveMethod *

Algorithm used to match the rate of the masterclock

Flags : Read / Write

Default value : skew (2)

### typefind

    “typefind” gboolean

Run typefind before negotiating (deprecated, non-functional)

Flags : Read / Write

Default value : false

### use-driver-timestamps

    “use-driver-timestamps” gboolean

Use driver timestamps or the pipeline clock timestamps

Flags : Read / Write

Default value : true

The results of the search are