# melcom's FFmpeg Audio Normalizer

Open-source'owe narzędzie do normalizacji audio oparte na FFmpeg, LUFS i True Peak. Stworzone do muzyki, podcastów, audio gamingowego oraz dużych batch-workflow - bez potrzeby używania linii poleceń.

## Wymagania

Aby korzystać z melcom's FFmpeg Audio Normalizer, wymagany jest pełny pakiet FFmpeg:

- `ffmpeg.exe` - analiza i normalizacja audio
- `ffplay.exe` - podgląd audio
- `ffprobe.exe` - odczyt parametrów technicznych audio

Zalecany download:
github.com/BtbN/FFmpeg-Builds/releases
Zalecany pakiet:
`ffmpeg-master-latest-win64-gpl.zip`

Po rozpakowaniu FFmpeg ustaw ścieżkę do folderu FFmpeg w opcjach programu.

## Pierwsze Kroki

1. Uruchom `AudioNormalizer.exe`.
2. Otwórz:
   `Plik -> Opcje`
3. Wybierz folder zawierający:
   `ffmpeg.exe`, `ffplay.exe` oraz `ffprobe.exe`
4. Użyj "Dodaj pliki" lub "Dodaj folder", aby dodać pliki audio do kolejki.
5. Wybierz preset LUFS, limit True Peak oraz format wyjściowy.
6. Wybierz preset charakteru audio. Transparent jest ustawieniem domyślnym i nie dodaje dodatkowego koloryzowania dźwięku.
7. Kliknij:
   "Rozpocznij normalizację"

Podczas przetwarzania okno logów pokazuje status procesu, komunikaty FFmpeg oraz postęp normalizacji w czasie rzeczywistym.

## Tryby Normalizacji

### Liniowy (2 przebiegi)

Zalecany do muzyki, masteringu i archiwizacji. Plik audio jest najpierw analizowany, a następnie normalizowany ze stałym gainem. Pozwala to zachować oryginalną dynamikę możliwie najdokładniej.

### Dynamiczny (1 przebieg)

Zalecany do mowy, podcastów, streamów i broadcastu. Różnice głośności są aktywnie wyrównywane podczas procesu.

## Presety i Charakter Audio

### Presety LUFS i True Peak

- Program oferuje nowoczesne, przejrzyste i łatwe do zrozumienia nazwy profili głośności dla wszystkich popularnych wytycznych dotyczących przesyłania strumieniowego.
- Domyślny / Streaming bezpieczny (-1.0 dBTP) to świetne ustawienie domyślne dla większości platform streamingowych.
- Bezpieczny dla kodeków stratnych (-2.0 dBTP) zapewnia dodatkowy headroom dla eksportów MP3, AAC i OGG.
- Bez limitu / ryzykowne (0.0 dBTP) powinno być używane tylko wtedy, gdy docelowy format wyraźnie to dopuszcza.

### Charakter Masteringu

Transparent

Czysta normalizacja głośności bez dodatkowego przetwarzania dźwięku.

Cohesive

Dodaje delikatną kompresję i subtelny soft clipping dla bardziej spójnego miksu.

Punchy

Zapewnia więcej energii, mocniejszy punch i wyraźniejsze przetwarzanie dynamiki.

Aggressive

Najmocniejszy preset przeznaczony do ostrzejszych i bardziej agresywnych materiałów elektronicznych.

## Jakość i Metadane

### Zachowanie jakości audio

Podczas eksportu do WAV lub FLAC zachowywana jest oryginalna częstotliwość próbkowania oraz głębia bitowa. Program nie wykonuje niepotrzebnego downsamplingu.

### Metadane i Tagi

Artysta, album, tytuł, rok oraz inne metadane są automatycznie kopiowane do znormalizowanego pliku wyjściowego.

Pliki MP3 automatycznie używają standardu ID3v2.3 dla maksymalnej kompatybilności z Eksploratorem Windows i sprzętowymi odtwarzaczami audio.

## Dodatkowe Uwagi

Jeśli proces zostanie przerwany lub wystąpi błąd, wszystkie tymczasowe pliki robocze są automatycznie usuwane.
Brak `ffprobe.exe` nie wpływa na samą normalizację, ale wyłącza odczyt informacji technicznych i długości plików audio.

## O Tym Pliku

Projekt został stworzony przez melcom i wydany na licencji MIT.

Strona projektu:
melcom-creations.github.io/melcom-music