Аудио

Проверить записи на клиппинг

Находит треки, где пик слишком близок к 0 dB, и показывает среднюю громкость.

Shell macOS Linux Средний
Скачать check_clipping.sh
Описание

Что делает скрипт

Скрипт анализирует файл или папку через volumedetect и сравнивает максимальный пик с порогом. Результаты можно сохранить в CSV. Файлы не изменяются, проверка полезна перед нормализацией и мастерингом.

Запуск

Быстрый старт

bash check_clipping.sh ./music

Скачайте файл, откройте терминал в папке со скриптом и выполните команду.

Примеры

Другие варианты

  • bash check_clipping.sh track.wav
  • bash 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 ]]

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get audio-clipping-check
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Аудио

Конвертация, нормализация, обрезка, теги и подготовка звука.