Микширует голосовую дорожку и амбиент через sidechaincompress в ffmpeg. Ambient автоматически уходит на -10dB пока говорит voice. Используй для всех voice-over видео (Mystic, MViC, Travel, Tutorial). Корень типичной проблемы «голос тонет в музыке» или «музыка перебивает голос» — это решает.
Пока нет рефлексий. Запиши через ~/.claude/bin/append-reflection.py после следующего вызова.
## INVARIANTS — never override
1. Только через `sidechaincompress` ffmpeg-фильтр. Не ручной volume-keyframing.
2. Дефолтные параметры: `threshold=0.02:ratio=10:attack=50:release=500`. Менять только при явной необходимости.
3. Ambient громкость в финальном миксе: -10 до -15 dB (volume=0.18-0.32).
4. НЕ обрезать концы ambient до тишины — пусть растекается за voice (естественнее).
5. Финальный output: stereo (2 channel), 44100 Hz, AAC 160k.
6. Если voice отсутствует (только музыка) — НЕ применять sidechaincompress, просто amix.
## Назначение
Соединить voice-over и ambient так, чтобы голос всегда был выше музыки автоматически. Источник техники: `SecondBrain/4-KNOWLEDGE/topics/sound-design-mystery-shorts.md`.
## Когда вызывать
- При сборке voice-over видео (Mystic, Travel, MViC tutorials)
- Когда нужно подложить музыку под подкаст/интервью
- При финальной сборке short-form с voiceover
## Когда НЕ вызывать
- Чистый music video (без voice) → просто amix
- Если voice уже смикширован с музыкой в исходнике
- Для голосовых сообщений / коротких уведомлений без музыки
## Команда (template)
```bash
ffmpeg -i voice.wav -stream_loop -1 -i ambient.wav \
-filter_complex "
[1:a]volume=0.18[amb];
[amb][0:a]sidechaincompress=threshold=0.02:ratio=10:attack=50:release=500[duck];
[duck][0:a]amix=inputs=2:duration=first:normalize=0[mix]
" \
-map "[mix]" -ac 2 -ar 44100 -c:a pcm_s16le \
output.wav
```
Объяснение filter_complex:
1. `[1:a]volume=0.18[amb]` — ambient на ~-15dB (база)
2. `[amb][0:a]sidechaincompress=...[duck]` — compressor с side-chain от голоса. Когда голос громче threshold — ambient давится с ratio:10
3. `[duck][0:a]amix=...[mix]` — финальный микс ducked-ambient + raw voice
## Параметры (если нужно тонкая настройка)
| Параметр | Дефолт | Когда менять |
|---|---|---|
| `threshold` | 0.02 | Если голос тихий — снизить до 0.01 |
| `ratio` | 10 | Если ambient слишком давится — снизить до 6 |
| `attack` | 50 (ms) | Если ducking слышно резко — поднять до 100 |
| `release` | 500 (ms) | Если ambient медленно возвращается — снизить до 300 |
| `ambient volume` | 0.18 | Для драмы — 0.12, для тёплого фона — 0.25 |
## LEARNED (auto-updated by agent-self-improve)
(пока пусто)