# How to use the Yoka Premiere plugin

The plugin analyzes audio in selected clips or in the whole sequence, finds silent regions, and helps you quickly cut or remove them directly on the Premiere Pro timeline.

## Basic workflow

- Open the sequence you want to process in Premiere Pro.
- If you only want to process part of it, select the needed clip or group of clips.
- Adjust the settings in the plugin panel.
- If `Scope: Selection` is selected, click `Check selection` to confirm that the plugin sees the clips you selected.
- Run `Dry run` first to preview the cut plan without changing the timeline.
- If the result looks good, click `Apply this plan`. This button appears after a successful `Dry run` and applies the reviewed plan without running analysis again.
- Open the panel from `Window → Extensions → Yoka Plugins: Remove Silence`.
- Use the red `Cancel` button to stop the current operation; `Restore backup` restores the last saved sequence copy when duplication is enabled.

## What each setting means

- `Scope: Selection` — analyze only selected clips. Best for focused cleanup.
- `Scope: Whole sequence` — analyze the entire active sequence.
- `Check selection` — shows the active sequence name, how many selected clips were found, and their ranges. It does not cut anything; it only confirms the processing scope.
- `Preset` — quick starting values: `Soft`, `Standard`, and `Aggressive`. If you edit fields manually, the preset switches to `Custom`.
- `Save` — saves the current settings as a user preset on this computer. It stores threshold, durations, frame padding, and processing checkboxes; scope is not saved for safety.
- `Delete` — deletes only the selected user preset. Built-in presets cannot be deleted.
- `Unit` switches `Min silence` and `Min speech` between seconds and frames. Frames are selected by default.
- `Threshold dB` — loudness level below which audio is treated as silence. Values closer to zero are more aggressive. For example, `-35 dB` is a balanced starting point.
- `Min silence` — minimum silence duration in the selected unit. For example, `11` frames at 30 fps is about 0.37 seconds.
- `Min speech` — minimum speech duration between two silent regions. Lower values make nearby pauses merge less often.
- `Padding frames` — safety padding before and after speech, entered in frames. Helps avoid cutting words too tightly.
- `Duplicate sequence before apply` — create a copy of the sequence before making changes. Useful as a safe mode.
- `Delete empty zones immediately` — remove detected silent segments right after cutting.
- `Auto shift timeline after delete` — ripple-delete the removed parts so the remaining clips close the gaps automatically.

## Buttons and statuses

- `Dry run` — safe preview. The plugin analyzes audio and shows the number of cuts plus the first intervals, but does not change Premiere.
- `Details` — expands the dry-run preview to show more intervals. The small close button only hides the preview block.
- `Apply this plan` — applies the latest dry-run result. If settings or the active sequence changed, the plugin asks you to run `Dry run` again.
- `Remove Silence` — the default button before a plan exists. If there is no reviewed plan, it asks you to run `Dry run` first and does not start analysis automatically.
- `Restore backup` — restores the sequence from the last backup point. It requires `Duplicate sequence before apply` to be enabled.
- `Copy diagnostics` — copies support information: version, FPS, selected mode, audio engine state, and the latest prepared plan. It does not copy the license key.

## Recommended starting values

- For normal speech cleanup, start with `Threshold -35`, `Min silence 0.35`, `Min speech 0.25`, and `Padding 80`.
- If too little gets removed, try a more aggressive threshold such as `-30 dB`.
- If word starts or endings are cut too tightly, increase `Padding frames`.
- If you get too many tiny cuts between words, increase `Min silence s` or `Min speech s`.

## Common usage modes

- Preview only: click `Dry run`.
- Cut and remove pauses: enable `Delete empty zones immediately`, click `Dry run`, review the plan, then click `Apply this plan`.
- Cut, remove pauses, and close gaps: enable both delete and auto-shift options.
- Safest workflow: keep `Duplicate sequence before apply` enabled.

Tip: test your settings on a short fragment or on a duplicated sequence before applying them to the full project.