When only selected channels should move, give FFmpeg an adelay value for each channel in input order, using 0 for every channel that must remain in place. Check that the list covers the intended channels and that all is off unless you deliberately want the last value to apply to the remaining channels. For sample-accurate offsets, append S to sample counts; bare numbers mean milliseconds.
Map the channels before choosing delays
The adelay filter processes channels in order. Write down the channel order reported for the input stream, then assign one delay to each position. Do not infer a channel’s role from a name such as “left” or “dialogue” alone; use the actual input layout and your project’s routing notes.
Use these steps:
- Inspect the selected audio stream’s channel count and layout in your media information or FFmpeg input probe. Confirm you are filtering the intended stream, not a different language or audio program.
- Create a numbered list in input-channel order. Mark the desired offset for every channel, including channels that should not move.
- Choose one unit for the list. Use milliseconds for time-based offsets or sample counts with
Swhen the requirement is an exact number of samples. Do not mix units by treating an unmarked value as samples. - Write the
adelaylist with|separators. For example, the hypothetical four-channel mapping in the worksheet below corresponds toadelay=0|500S|0|700Swith the defaultallsetting. - Compare the filtered output against the unfiltered input, channel by channel. Check the start of each channel’s audible material, not just the combined mix, which can hide an unintended shift.
The official `adelay` options define unmarked delay values as milliseconds and document the S suffix for sample counts. They also specify that channels beyond a shorter delay list are left undelayed by default. That default is not the same as an explicit mapping: a short list can conceal an omitted channel, so fill in zeros when the intent is to keep channels stationary.
Acceptance worksheet for a four-channel stream
The following values and observations are hypothetical. They describe a proposed routing check, not a measured FFmpeg run. Assume the input has four channels in the order shown and the goal is to delay only channels 2 and 4. “Silent lead-in” means the initial silence added by the requested offset; source material may already contain silence.
| Input channel | Requested delay | Expected added silent lead-in | Decision if the comparison disagrees |
|---|---|---|---|
| 1 | 0 samples | No added delay | Check that channel 1 still starts at its input position |
| 2 | 500S | 500 samples | Check the offset in samples, not by reading 500 as milliseconds |
| 3 | 0 samples | No added delay | Confirm channel 3 was not shifted along with channel 2 |
| 4 | 700S | 700 samples | Confirm the fourth list entry maps to input channel 4 |
Record the input channel order, the exact delay list, the chosen units, and whether all is enabled. A reviewer can then compare each output channel’s leading silence with the intended mapping. This is a way to make the check auditable; the documentation defines the filter’s delay behavior, not a particular visual inspection method or a guarantee about a media player’s channel display.
Limits and what to do when it fails
A delay list with fewer entries than the stream’s channel count does not automatically delay the omitted channels: with default settings, remaining channels are left unchanged. Conversely, enabling all applies the last specified delay to the remaining channels. The official filter example for `all` illustrates this mode for applying one sample delay to all channels. Therefore, if an unlisted channel moves unexpectedly, check whether all was enabled and inspect the full filter expression before changing the requested values.
If the wrong material shifts, first verify the selected stream and the input channel order, then compare the mapping position by position. If the offset is wrong by a large factor, check the units: 500 means 500 milliseconds, while 500S means 500 samples. The seconds suffix s is also available, but avoid mixing units in one list unless the values are carefully documented.
adelay adds silence at the start of delayed channels. It does not identify which channel contains a voice or correct an incorrect channel layout. If the input order or channel labels are unclear, resolve that routing question before applying offsets. This guide concerns FFmpeg filtering; it does not imply that Imagild provides an adelay control.
Three quick questions
Does a shorter list delay every channel by its last value? No. By default, channels not covered by the list are not delayed. With `all` enabled, the last listed delay is used for the remaining channels.
Is `500` the same as `500S`? No. `500` is milliseconds; `500S` is 500 samples. Use the suffix that matches the required unit.
How can I tell whether an untouched channel stayed in place? Compare that channel’s output start with the same channel in the input, separately from the combined mix. The worksheet’s zero-delay entries state the expected result for the hypothetical mapping.
Sources and next step
This guide interprets public documentation and uses explicitly hypothetical acceptance examples, not application tests. Controls and availability can change; verify the cited manual against your installed version.
For work created in Imagild, carry the input requirements and acceptance checklist into the film workspace. The external software controls discussed above belong to their respective products.