# tee

Split data to multiple pads. Branching the data flow is useful when e.g. capturing a video where the video is shown on the screen and also encoded and written to a file. Another example is playing music and hooking up a visualisation module.

One needs to use separate queue elements (or a multiqueue) in each branch to provide separate threads for each branch. Otherwise a blocked dataflow in one branch would stall the other branches.

## Example launch line

     gst-launch-1.0 filesrc location=song.ogg ! decodebin ! tee name=t ! queue ! audioconvert ! audioresample ! autoaudiosink t. ! queue ! audioconvert ! goom ! videoconvert ! autovideosink

Play song.ogg audio file which must be in the current working directory and render visualisations using the goom element (this can be easier done using the playbin element, this is just an example pipeline).

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──tee

## Factory details

Authors: – Erik Walthinsen <omega>, Wim Taymans <wim></wim></omega>

Classification: – `Generic`

Rank – none

Plugin – coreelements

Package – GStreamer

## Pad Templates

### `sink`

    ANY

Presence – always

Direction – sink

Object type – GstPad

### `src_%u`

    ANY

Presence – request

Direction – src

Object type – GstPad

## Properties

### alloc-pad

    “alloc-pad” GstPad *

The pad ALLOCATION queries will be proxied to (DEPRECATED, has no effect)

Flags : Read / Write

### allow-not-linked

    “allow-not-linked” gboolean

This property makes sink pad return GST_FLOW_OK even if there are no source pads or any of them is linked.

This is useful to avoid errors when you have a dynamic pipeline and during a reconnection you can have all the pads unlinked or removed.

Flags : Read / Write / Construct

Default value : false

Since : 1.6

### has-chain

    “has-chain” gboolean

If the element can operate in push mode

Flags : Read / Write / Construct

Default value : true

### last-message

    “last-message” gchararray

The message describing current status

Flags : Read

Default value : NULL

### num-src-pads

    “num-src-pads” gint

The number of source pads

Flags : Read

Default value : 0

### pull-mode

    “pull-mode” Tee-pull-mode *

Behavior of tee in pull mode

Flags : Read / Write / Construct

Default value : never (0)

### silent

    “silent” gboolean

Don't produce last_message events

Flags : Read / Write / Construct

Default value : true

## Named constants

### Tee-pull-mode

The different ways that tee can behave in pull mode. TEE_PULL_MODE_NEVER disables pull mode.

#### Members

`never` (0) – Never activate in pull mode
`single` (1) – Only one src pad can be active in pull mode

The results of the search are