godot-fun Audio Volume Adjust
Apply a uniform gain change across the full clip — no fade, no loudness targeting. Negative dB reduces level; positive dB increases it.
Rules
When this skill applies, read and follow skill-dependency-manager — run scripts as documented, install missing tools into .dependency/.
Quick Start
Reduce by 6 dB (~half amplitude), output to <audio-dir>/audio-volume-adjust/<audio-name>:
.dependency/python/python .ai/audio-volume-adjust/adjust.py --audio path/to/audio.wav --volume -6
Example: audio/sfx/tank/tank_move.wav → audio/sfx/tank/audio-volume-adjust/tank_move.wav
Boost by 3 dB:
.dependency/python/python .ai/audio-volume-adjust/adjust.py --audio audio/sfx.wav --volume 3
Adjustment Guidelines
| Goal | --volume (dB) |
|---|---|
| Slight reduction | -3 |
| Half amplitude | -6 |
| Noticeably quieter | -9 to -12 |
| Background / distant | -15 to -20 |
| Slight boost | +3 |
| Noticeably louder | +6 |
Common Flags
--audio · --volume · -o / --output
.dependency/python/python .ai/audio-volume-adjust/adjust.py --audio audio/sfx.wav --volume -9
Originals are never modified. Input must be a single audio file (--audio), not a directory. Supported: .wav, .mp3, .ogg, .flac, .aac, .m4a, .wma.
Agent Notes
- Use the bundled script, not hand-written
volumefilters. - Always pass
--volumein dB (negative = reduce, positive = boost). - Missing Python/FFmpeg → populate
.dependency/per skill-dependency-manager, retry same command. - Do not copy, move, or replace the source with the adjusted output — tell the user where
audio-volume-adjust/files are; they swap assets manually when ready. - Do not use
--outputpointing at the source file; the script refuses output paths that would overwrite inputs. - Boosting (positive dB) can clip peaks — warn the user; prefer small boosts (+3 dB or less).
- FFmpeg filter details and dB math: reference.md
CLI
Copy-paste commands: cli/audio-volume-adjust.md