# dvbsrc

dvbsrc can be used to capture media from DVB cards. Supported DTV broadcasting standards include DVB-T/C/S, ATSC, ISDB-T and DTMB.

## Example launch line

     gst-launch-1.0 dvbsrc modulation="QAM 64" trans-mode=8k bandwidth=8 frequency=514000000 code-rate-lp=AUTO code-rate-hp=2/3 guard=4  hierarchy=0 ! mpegtsdemux name=demux ! queue max-size-buffers=0 max-size-time=0 ! mpegvideoparse ! mpegvideoparse ! mpeg2dec ! xvimagesink demux. ! queue max-size-buffers=0 max-size-time=0 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! pulsesink

Captures a full transport stream from DVB card 0 that is a DVB-T card at tuned frequency 514000000 Hz with other parameters as seen in the pipeline and renders the first TV program on the transport stream.

     gst-launch-1.0 dvbsrc modulation="QAM 64" trans-mode=8k bandwidth=8 frequency=514000000 code-rate-lp=AUTO code-rate-hp=2/3 guard=4  hierarchy=0 pids=100:256:257 ! mpegtsdemux name=demux ! queue max-size-buffers=0 max-size-time=0 ! mpegvideoparse ! mpeg2dec ! xvimagesink demux. ! queue max-size-buffers=0 max-size-time=0 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! pulsesink

Captures and renders a transport stream from DVB card 0 that is a DVB-T card for a program at tuned frequency 514000000 Hz with PMT PID 100 and elementary stream PIDs of 256, 257 with other parameters as seen in the pipeline.

     gst-launch-1.0 dvbsrc polarity="h" frequency=11302000 symbol-rate=27500 diseqc-source=0 pids=50:102:103 ! mpegtsdemux name=demux ! queue max-size-buffers=0 max-size-time=0 ! mpegvideoparse ! mpeg2dec ! xvimagesink demux. ! queue max-size-buffers=0 max-size-time=0 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! pulsesink

Captures and renders a transport stream from DVB card 0 that is a DVB-S card for a program at tuned frequency 11302000 kHz, symbol rate of 27500 kBd (kilo bauds) with PMT PID of 50 and elementary stream PIDs of 102 and 103.

     gst-launch-1.0 dvbsrc frequency=515142857 guard=16 trans-mode="8k" isdbt-layer-enabled=7 isdbt-partial-reception=1 isdbt-layera-fec="2/3" isdbt-layera-modulation="QPSK" isdbt-layera-segment-count=1 isdbt-layera-time-interleaving=4 isdbt-layerb-fec="3/4" isdbt-layerb-modulation="qam-64" isdbt-layerb-segment-count=12 isdbt-layerb-time-interleaving=2 isdbt-layerc-fec="1/2" isdbt-layerc-modulation="qam-64" isdbt-layerc-segment-count=0 isdbt-layerc-time-interleaving=0 delsys="isdb-t" ! tsdemux ! "video/x-h264" ! h264parse ! queue ! avdec_h264 ! videoconvert ! queue ! autovideosink

Captures and renders the video track of TV Paraíba HD (Globo affiliate) in Campina Grande, Brazil. This is an ISDB-T (Brazilian ISDB-Tb variant) broadcast.

      gst-launch-1.0 dvbsrc frequency=503000000 delsys="atsc" modulation="8vsb" pids=48:49:52 ! decodebin name=dec dec. ! videoconvert ! autovideosink dec. ! audioconvert ! autoaudiosink

Captures and renders KOFY-HD in San Jose, California. This is an ATSC broadcast, PMT ID 48, Audio/Video elementary stream PIDs 49 and 52 respectively.

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──GstBaseSrc
                        ╰──GstPushSrc
                            ╰──dvbsrc

## Factory details

Authors: – P2P-VCR, C-Lab, University of Paderborn, Zaheer Abbas Merali , Reynaldo H. Verdejo Pinochet

Classification: – `Source/Video`

Rank – none

Plugin – dvb

Package – GStreamer Bad Plug-ins

## Pad Templates

### `src`

    video/mpegts:
        mpegversion: 2
       systemstream: true

Presence – always

Direction – src

Object type – GstPad

## Signals

### tuning-done

    tuning_done_callback (GstElement * gstdvbsrc,
                          gpointer udata)

    def tuning_done_callback (gstdvbsrc, udata):
        #python callback for the 'tuning-done' signal

    function tuning_done_callback(gstdvbsrc: GstElement * gstdvbsrc, udata: gpointer udata): {
        // javascript callback for the 'tuning-done' signal
    }

Signal emitted when the tunner has successfully got a lock on a signal.

Parameters:

`gstdvbsrc` –

the element on which the signal is emitted

`udata` –
No description available

Flags: Run Last

### tuning-fail

    tuning_fail_callback (GstElement * gstdvbsrc,
                          gpointer udata)

    def tuning_fail_callback (gstdvbsrc, udata):
        #python callback for the 'tuning-fail' signal

    function tuning_fail_callback(gstdvbsrc: GstElement * gstdvbsrc, udata: gpointer udata): {
        // javascript callback for the 'tuning-fail' signal
    }

Signal emitted when the tunner failed to get a lock on the signal.

Parameters:

`gstdvbsrc` –

the element on which the signal is emitted

`udata` –
No description available

Flags: Run Last

### tuning-start

    tuning_start_callback (GstElement * gstdvbsrc,
                           gpointer udata)

    def tuning_start_callback (gstdvbsrc, udata):
        #python callback for the 'tuning-start' signal

    function tuning_start_callback(gstdvbsrc: GstElement * gstdvbsrc, udata: gpointer udata): {
        // javascript callback for the 'tuning-start' signal
    }

Signal emitted when the element first attempts to tune the frontend tunner to a given frequency.

Parameters:

`gstdvbsrc` –

the element on which the signal is emitted

`udata` –
No description available

Flags: Run Last

## Action Signals

### tune

    g_signal_emit_by_name (gstdvbsrc, "tune");

    ret = gstdvbsrc.emit ("tune")

    let ret = gstdvbsrc.emit ("tune");

Signal emitted from the application to the element, instructing it to tune.

Parameters:

`gstdvbsrc` (GstElement *) –

the element on which the signal is emitted

Flags: Run Last / Action

## Properties

### adapter

    “adapter” gint

The DVB adapter device number (eg. 0 for adapter0)

Flags : Read / Write

Default value : 0

### bandwidth

    “bandwidth” GstDvbSrcBandwidth *

(DVB-T) Bandwidth. Deprecated

Flags : Read / Write

Default value : AUTO (3)

### bandwidth-hz

    “bandwidth-hz” guint

Channel bandwidth in Hz

Flags : Read / Write

Default value : 0

### code-rate-hp

    “code-rate-hp” GstDvbSrcCode_Rate *

(DVB-T, DVB-S/S2 and DVB-C) High priority code rate

Flags : Read / Write

Default value : auto (9)

### code-rate-lp

    “code-rate-lp” GstDvbSrcCode_Rate *

(DVB-T) Low priority code rate

Flags : Read / Write

Default value : 1/2 (1)

### delsys

    “delsys” GstDvbSrcDelsys *

Delivery System

Flags : Read / Write

Default value : undefined (0)

### diseqc-source

    “diseqc-source” gint

(DVB-S/S2) Selected DiSEqC source. Only needed if you have a DiSEqC switch. Otherwise leave at -1 (disabled)

Flags : Read / Write

Default value : -1

### dvb-buffer-size

    “dvb-buffer-size” guint

The kernel buffer size used by the DVB api

Flags : Read / Write

Default value : 1925120

### frequency

    “frequency” guint

Center frequency to tune into. Measured in kHz for the satellite distribution standards and Hz for all the rest

Flags : Read / Write

Default value : 0

### frontend

    “frontend” gint

The frontend device number (eg. 0 for frontend0)

Flags : Read / Write

Default value : 0

### guard

    “guard” GstDvbSrcGuard *

(DVB-T) Guard Interval

Flags : Read / Write

Default value : 16 (1)

### hierarchy

    “hierarchy” GstDvbSrcHierarchy *

(DVB-T) Hierarchy information

Flags : Read / Write

Default value : 1 (1)

### interleaving

    “interleaving” GstDvbSrcInterleaving *

(DTMB) Interleaving type

Flags : Read / Write

Default value : auto (1)

### inversion

    “inversion” GstDvbSrcInversion *

(DVB-T and DVB-C) Inversion information

Flags : Read / Write

Default value : on (1)

### isdbt-layer-enabled

    “isdbt-layer-enabled” guint

(ISDB-T) Layer Enabled (7 = All layers)

Flags : Read / Write

Default value : 7

### isdbt-layera-fec

    “isdbt-layera-fec” GstDvbSrcCode_Rate *

(ISDB-T) layer A Forward Error Correction

Flags : Read / Write

Default value : auto (9)

### isdbt-layera-modulation

    “isdbt-layera-modulation” GstDvbSrcModulation *

(ISDB-T) Layer A modulation type

Flags : Read / Write

Default value : auto (6)

### isdbt-layera-segment-count

    “isdbt-layera-segment-count” gint

(ISDB-T) Layer A segment count (-1 = AUTO)

Flags : Read / Write

Default value : -1

### isdbt-layera-time-interleaving

    “isdbt-layera-time-interleaving” gint

(ISDB-T) Layer A time interleaving (-1 = AUTO)

Flags : Read / Write

Default value : -1

### isdbt-layerb-fec

    “isdbt-layerb-fec” GstDvbSrcCode_Rate *

(ISDB-T) layer B Forward Error Correction

Flags : Read / Write

Default value : auto (9)

### isdbt-layerb-modulation

    “isdbt-layerb-modulation” GstDvbSrcModulation *

(ISDB-T) Layer B modulation type

Flags : Read / Write

Default value : auto (6)

### isdbt-layerb-segment-count

    “isdbt-layerb-segment-count” gint

(ISDB-T) Layer B segment count (-1 = AUTO)

Flags : Read / Write

Default value : -1

### isdbt-layerb-time-interleaving

    “isdbt-layerb-time-interleaving” gint

(ISDB-T) Layer B time interleaving (-1 = AUTO)

Flags : Read / Write

Default value : -1

### isdbt-layerc-fec

    “isdbt-layerc-fec” GstDvbSrcCode_Rate *

(ISDB-T) layer C Forward Error Correction

Flags : Read / Write

Default value : auto (9)

### isdbt-layerc-modulation

    “isdbt-layerc-modulation” GstDvbSrcModulation *

(ISDB-T) Layer C modulation type

Flags : Read / Write

Default value : auto (6)

### isdbt-layerc-segment-count

    “isdbt-layerc-segment-count” gint

(ISDB-T) Layer C segment count (-1 = AUTO)

Flags : Read / Write

Default value : -1

### isdbt-layerc-time-interleaving

    “isdbt-layerc-time-interleaving” gint

(ISDB-T) Layer C time interleaving (-1 = AUTO)

Flags : Read / Write

Default value : -1

### isdbt-partial-reception

    “isdbt-partial-reception” gint

(ISDB-T) Partial Reception (-1 = AUTO)

Flags : Read / Write

Default value : 1

### isdbt-sb-segment-count

    “isdbt-sb-segment-count” guint

(ISDB-T) SB segment count

Flags : Read / Write

Default value : 1

### isdbt-sb-segment-idx

    “isdbt-sb-segment-idx” gint

(ISDB-T) SB segment IDX

Flags : Read / Write

Default value : 0

### isdbt-sb-subchannel-id

    “isdbt-sb-subchannel-id” gint

(ISDB-T) SB Subchannel ID (-1 = AUTO)

Flags : Read / Write

Default value : -1

### isdbt-sound-broadcasting

    “isdbt-sound-broadcasting” gint

(ISDB-T) Sound Broadcasting

Flags : Read / Write

Default value : 0

### lnb-lof1

    “lnb-lof1” guint

LNB's Local oscillator frequency used for low band reception (kHz)

Flags : Read / Write

Default value : 9750000

### lnb-lof2

    “lnb-lof2” guint

LNB's Local oscillator frequency used for high band reception (kHz)

Flags : Read / Write

Default value : 10600000

### lnb-slof

    “lnb-slof” guint

LNB's Upper bound for low band reception (kHz)

Flags : Read / Write

Default value : 11700000

### modulation

    “modulation” GstDvbSrcModulation *

(DVB-T/T2/C/S2, TURBO and ATSC) Modulation type

Flags : Read / Write

Default value : qam-16 (1)

### pids

    “pids” gchararray

Colon-separated list of PIDs (eg. 110:120) to capture. ACT and CAT are automatically included but PMT should be added explicitly. Special value 8192 gets full MPEG-TS

Flags : Read / Write

Default value : 8192

### pilot

    “pilot” GstDvbSrcPilot *

Pilot (DVB-S2)

Flags : Read / Write

Default value : auto (2)

### polarity

    “polarity” gchararray

(DVB-S/S2) Polarity [vhHV] (eg. V for Vertical)

Flags : Read / Write / Construct

Default value : H

### rolloff

    “rolloff” GstDvbSrcRolloff *

Rolloff (DVB-S2)

Flags : Read / Write

Default value : auto (3)

### stats-reporting-interval

    “stats-reporting-interval” guint

The number of reads before reporting frontend stats

Flags : Read / Write

Default value : 100

### stream-id

    “stream-id” gint

(DVB-T2 and DVB-S2 max 255, ISDB max 65535) Stream ID (-1 = disabled)

Flags : Read / Write

Default value : -1

### symbol-rate

    “symbol-rate” guint

(DVB-S/S2, DVB-C) Symbol rate in kBd (kilo bauds)

Flags : Read / Write

Default value : 0

### timeout

    “timeout” guint64

Post a message after timeout microseconds (0 = disabled)

Flags : Read / Write

Default value : 1000000

### trans-mode

    “trans-mode” GstDvbSrcTransmission_Mode *

(DVB-T) Transmission mode

Flags : Read / Write

Default value : 8k (1)

### tune

    “tune” gpointer

Atomically tune to channel. (For Apps)

Flags : Read / Write

### tuning-timeout

    “tuning-timeout” guint64

Microseconds to wait before giving up tuning/locking on a signal

Flags : Read / Write

Default value : 10000000000

## Named constants

### GstDvbSrcBandwidth

#### Members

`8` (0) – 8
`7` (1) – 7
`6` (2) – 6
`AUTO` (3) – AUTO
`5` (4) – 5
`10` (5) – 10
`1.712` (6) – 1.712

### GstDvbSrcCode_Rate

#### Members

`none` (0) – NONE
`1/2` (1) – 1/2
`2/3` (2) – 2/3
`3/4` (3) – 3/4
`4/5` (4) – 4/5
`5/6` (5) – 5/6
`6/7` (6) – 6/7
`7/8` (7) – 7/8
`8/9` (8) – 8/9
`auto` (9) – AUTO
`3/5` (10) – 3/5
`9/10` (11) – 9/10
`2/5` (12) – 2/5

### GstDvbSrcDelsys

#### Members

`undefined` (0) – UNDEFINED
`dvb-c-a` (1) – DVB-C-A
`dvb-c-b` (2) – DVB-C-B
`dvb-t` (3) – DVB-T
`dss` (4) – DSS
`dvb-s` (5) – DVB-S
`dvb-s2` (6) – DVB-S2
`dvb-h` (7) – DVB-H
`isdb-t` (8) – ISDB-T
`isdb-s` (9) – ISDB-S
`isdb-c` (10) – ISDB-C
`atsc` (11) – ATSC
`atsc-mh` (12) – ATSC-MH
`dtmb` (13) – DTMB
`cmmb` (14) – CMMB
`dab` (15) – DAB
`dvb-t2` (16) – DVB-T2
`turbo` (17) – TURBO
`dvb-c-c` (18) – DVB-C-C

### GstDvbSrcGuard

#### Members

`32` (0) – 32
`16` (1) – 16
`8` (2) – 8
`4` (3) – 4
`auto` (4) – AUTO
`128` (5) – 128
`19/128` (6) – 19/128
`19/256` (7) – 19/256
`pn420` (8) – PN420
`pn595` (9) – PN595
`pn945` (10) – PN945

### GstDvbSrcHierarchy

#### Members

`none` (0) – NONE
`1` (1) – 1
`2` (2) – 2
`4` (3) – 4
`auto` (4) – AUTO

### GstDvbSrcInterleaving

#### Members

`none` (0) – NONE
`auto` (1) – AUTO
`240` (2) – 240
`720` (3) – 720

### GstDvbSrcInversion

#### Members

`off` (0) – OFF
`on` (1) – ON
`auto` (2) – AUTO

### GstDvbSrcModulation

#### Members

`qpsk` (0) – QPSK
`qam-16` (1) – QAM 16
`qam-32` (2) – QAM 32
`qam-64` (3) – QAM 64
`qam-128` (4) – QAM 128
`qam-256` (5) – QAM 256
`auto` (6) – AUTO
`8vsb` (7) – 8VSB
`16vsb` (8) – 16VSB
`8psk` (9) – 8PSK
`16apsk` (10) – 16APSK
`32apsk` (11) – 32APSK
`dqpsk` (12) – DQPSK
`qam-4-nr` (13) – QAM 4 NR

### GstDvbSrcPilot

#### Members

`on` (0) – ON
`off` (1) – OFF
`auto` (2) – AUTO

### GstDvbSrcRolloff

#### Members

`35` (0) – 35
`20` (1) – 20
`25` (2) – 25
`auto` (3) – auto

### GstDvbSrcTransmission_Mode

#### Members

`2k` (0) – 2K
`8k` (1) – 8K
`auto` (2) – AUTO
`4k` (3) – 4K
`1k` (4) – 1K
`16k` (5) – 16K
`32k` (6) – 32K
`c1` (7) – C1
`c3780` (8) – C3780

The results of the search are