volume_adjust

Adjusts gain on all clips matching a level and/or source filter.

Tip: The edit processor's volume and fade operations adjust a single source's audio within a chain of edits. Use volume_adjust when you want to apply one gain change across clips in bulk.

When to use

Use to bring audio levels to a consistent target. Common use: lower background music relative to the speaker, or normalize speaker audio.

In the editor

Add it from the Library (Audio group), or with + add step and a search for volume_adjust.

It takes no inputs. gain_db is required, and the Inspector marks it with a red asterisk until you fill it in: negative numbers make things quieter, positive louder. Choose what it applies to with level (for example music, to duck the background track) or source (a single filename). Leaving both empty changes the volume of everything, which is rarely what you want.

Nothing new appears in the run timeline; the clips that were already there simply play at the new level in the preview and the export. Balancing a voice against music usually means two of these steps, one per level, which is why they are cheap to add.

YAML Example

- id: vol_main
  processor: volume_adjust
  params:
    gain_db: -7
    level: main

- id: vol_music
  processor: volume_adjust
  params:
    gain_db: -23
    level: music

Inputs

None. Applies to all edit decisions already in the timeline.

Params

Output

TransformPatches: gain adjustments on matching edit decisions.

Notes

• Gain is applied in FCPXML, not rendered to a new file.
• Use level: to target just music or just the backbone; avoid adjusting everything at once.