Аудио
Проверить записи на клиппинг
Находит треки, где пик слишком близок к 0 dB, и показывает среднюю громкость.
Shell
macOS
Linux
Средний
Что делает скрипт
Скрипт анализирует файл или папку через volumedetect и сравнивает максимальный пик с порогом. Результаты можно сохранить в CSV. Файлы не изменяются, проверка полезна перед нормализацией и мастерингом.
Запуск
Быстрый старт
bash check_clipping.sh ./music
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
Другие варианты
bash check_clipping.sh track.wavbash check_clipping.sh ./music --threshold -0.5 --csv report.csv
Что понадобится
Bash 4+
Стандартные утилиты coreutils, find и sed
macOS
brew install bash
Linux
sudo apt install bash
FFmpeg 6+
Кодирование, фильтры и ffprobe
macOS
brew install ffmpeg
Linux
sudo apt install ffmpeg
Исходник
check_clipping.sh
#!/usr/bin/env bash
set -euo pipefail
usage() {
echo "Использование: $0 <файл|папка> [--threshold -0.1] [--csv отчёт.csv]"
}
src="${1:-}"
if [[ -z "$src" ]]; then
usage >&2
exit 2
fi
shift || true
threshold="-0.1"
csv=""
while [[ $# -gt 0 ]]; do
case "$1" in
--threshold) threshold="${2:-}"; shift 2 ;;
--csv) csv="${2:-}"; shift 2 ;;
-h|--help) usage; exit 0 ;;
*) echo "Неизвестный аргумент: $1" >&2; exit 2 ;;
esac
done
if [[ ! -e "$src" ]]; then
echo "Источник не найден: $src" >&2
exit 2
fi
if ! command -v ffmpeg >/dev/null 2>&1; then
echo "ffmpeg не найден. Установите FFmpeg." >&2
exit 1
fi
if [[ -d "$src" ]]; then
mapfile -d '' files < <(
find "$src" -maxdepth 1 -type f \
\( -iname '*.mp3' -o -iname '*.wav' -o -iname '*.flac' \
-o -iname '*.ogg' -o -iname '*.m4a' -o -iname '*.aac' \) \
-print0
)
else
files=("$src")
fi
if [[ "${#files[@]}" -eq 0 ]]; then
echo "Аудиофайлы не найдены." >&2
exit 1
fi
if [[ -n "$csv" ]]; then
printf 'file,max_db,mean_db,status\n' > "$csv"
fi
clipped=0
checked=0
for file in "${files[@]}"; do
stats="$(ffmpeg -hide_banner -nostdin -i "$file" -af volumedetect -f null - 2>&1 || true)"
max_db="$(awk '/max_volume:/ { print $(NF-1) }' <<< "$stats" | tail -n 1)"
mean_db="$(awk '/mean_volume:/ { print $(NF-1) }' <<< "$stats" | tail -n 1)"
if [[ -z "$max_db" ]]; then
echo "Пропуск: не удалось прочитать $file" >&2
continue
fi
checked=$((checked + 1))
status="OK"
if [[ "$max_db" == "-inf" ]]; then
status="тишина"
elif awk -v m="$max_db" -v t="$threshold" 'BEGIN { exit !(m > t) }'; then
status="клиппинг"
clipped=$((clipped + 1))
fi
printf '%-9s %s (пик %s dB, средняя %s dB)\n' "$status" "$file" "$max_db" "$mean_db"
if [[ -n "$csv" ]]; then
printf '"%s",%s,%s,%s\n' "$file" "$max_db" "$mean_db" "$status" >> "$csv"
fi
done
echo "Проверено: $checked, с риском клиппинга: $clipped"
if [[ -n "$csv" ]]; then
echo "Отчёт: $csv"
fi
[[ "$clipped" -eq 0 ]]
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.