# cutter

Analyses the audio signal for periods of silence. The start and end of silence is signalled by bus messages named `cutter`.

The message's structure contains these fields:

- GstClockTime `timestamp`: the timestamp of the buffer that triggered the message.
- GstClockTime `stream-time`: the stream time of the buffer.
- GstClockTime `running-time`: the running time of the buffer.
- gboolean `above`: TRUE for begin of silence and FALSE for end of silence.

## Example launch line

     gst-launch-1.0 -m filesrc location=foo.ogg ! decodebin ! audioconvert ! cutter ! autoaudiosink

Show cut messages.

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──cutter

## Factory details

Authors: – Thomas Vander Stichele

Classification: – `Filter/Editor/Audio`

Rank – none

Plugin – cutter

Package – GStreamer Good Plug-ins

## Pad Templates

### `sink`

    audio/x-raw:
             format: { S8, S16LE }
               rate: [ 1, 2147483647 ]
           channels: [ 1, 2147483647 ]
             layout: interleaved

Presence – always

Direction – sink

Object type – GstPad

### `src`

    audio/x-raw:
             format: { S8, S16LE }
               rate: [ 1, 2147483647 ]
           channels: [ 1, 2147483647 ]
             layout: interleaved

Presence – always

Direction – src

Object type – GstPad

## Properties

### audio-level-meta

    “audio-level-meta” gboolean

If TRUE, generate or update GstAudioLevelMeta on output buffers.

Flags : Read / Write

Default value : false

Since : 1.24

### leaky

    “leaky” gboolean

do we leak buffers when below threshold ?

Flags : Read / Write

Default value : false

### pre-length

    “pre-length” guint64

Length of pre-recording buffer (in nanoseconds)

Flags : Read / Write

Default value : 200000000

### run-length

    “run-length” guint64

Length of drop below threshold before cut_stop (in nanoseconds)

Flags : Read / Write

Default value : 500000000

### threshold

    “threshold” gdouble

Volume threshold before trigger

Flags : Read / Write

Default value : 0.1

### threshold-dB

    “threshold-dB” gdouble

Volume threshold before trigger (in dB)

Flags : Read / Write

Default value : -46.0517

The results of the search are