# clip.remove_silences

> Cuts the silent stretches out of a clip, leaving one clip per stretch of speech.

Source: https://alexgalhardo.github.io/vukem-video/pt-br/docs/reference/commands/clip.remove_silences/

Replaces the clip by one clip per non-silent stretch of its source range. Silences shorter than min_silence are kept; padding of speech is kept on each side of a cut. With ripple track the pieces close up and the later items of the track follow. The silences come from the analysis of the asset and are supplied by the service in resolved; the command never starts a job.

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `item_id` | `string` | yes | A clip of a video asset with audio. |
| `min_silence` | `string` | no | A length; shorter silences are ignored. Default "0.4s". |
| `new_ids` | array of `string` | no | Ids for the second, third, ... pieces, in order. |
| `padding` | `string` | no | A length, may be 0; speech kept around each cut. Default "0.1s". |
| `resolved` | `object` | no | Filled by the service from the silence analysis of the asset; never sent by a caller. |
| `ripple` | `track`, `none` | no | track (default) or none. |
| `threshold_db` | `integer` | no | Noise level of silence: -30, -35 (default), -40 or -45. |

## Example

As one operation of an `edit` batch (the `edit` tool of MCP, `vukem-video edit --ops`, or `POST /api/v1/projects/{id}/edit`):

```json
{
  "op": "clip.remove_silences",
  "args": {
    "item_id": "itm_m1n2p3q4r5",
    "min_silence": "0.4s",
    "padding": "0.1s",
    "ripple": "track"
  }
}
```

## Errors

[`E_VALIDATION`](/docs/reference/error-codes#e_validation), [`E_INVALID_TIME`](/docs/reference/error-codes#e_invalid_time), [`E_NOT_FOUND`](/docs/reference/error-codes#e_not_found), [`E_TYPE_MISMATCH`](/docs/reference/error-codes#e_type_mismatch), [`E_ID_EXISTS`](/docs/reference/error-codes#e_id_exists), [`E_INVALID_STATE`](/docs/reference/error-codes#e_invalid_state), [`E_LIMIT`](/docs/reference/error-codes#e_limit)

## Scope and phase

Scope `edit`, phase `alpha`. Run `vukem-video command:help clip.remove_silences` for the same description from the binary.
