Wymagania

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

• ffmpeg.exe - analiza, normalizacja audio i zapisywanie metadanych
• ffplay.exe - podgląd audio i funkcje odtwarzacza
• ffprobe.exe - odczyt parametrów technicznych audio i wykrywanie kanałów

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", "Dodaj folder", lub przeciągnij pliki bezpośrednio metodą **Drag & Drop** do kolejki.
5. Wybierz preset LUFS, limit True Peak oraz format wyjściowy.
6. Wybierz preset charakteru audio. Transparentny jest ustawieniem domyślnym i nie dodaje dodatkowego zabarwienia dźwięku.
7. Kliknij:
   "Rozpocznij normalizację"

Sprawdzanie aktualizacji

Przy uruchamianiu program może sprawdzać w GitHub Releases, czy jest dostępna nowsza publiczna wersja. Opcję tę można włączyć lub wyłączyć w menu Plik -> Opcje. Wersje wstępne można uwzględnić za pomocą osobnej opcji; domyślnie są pomijane.

Automatyczne sprawdzanie nie wyświetla komunikatu, gdy zainstalowana wersja jest aktualna lub GitHub jest niedostępny. Polecenie Info -> Sprawdź aktualizacje... uruchamia ręczne sprawdzanie, które zawsze pokazuje wynik.

Układ okna

Przeciągnij poziomy separator nad dziennikiem, aby zmienić jego wysokość. Pionowy separator między plikami a ustawieniami zmienia ich szerokość. Przy mniejszej ilości miejsca ustawienia można przewijać. Przyciski przetwarzania pozostają widoczne pod obszarami roboczymi.

Rozmiar okna, położenie separatorów i stan maksymalizacji są automatycznie zapisywane w sekcji Layout pliku options.ini i przywracane przy następnym uruchomieniu. Plik - Przywróć domyślny układ okna przywraca układ wbudowany. Układ jest niezależny od profili audio i zachowywany przy zmianie formatu wyjściowego, języka lub motywu.

Wyniki analizy

Użyj Tylko analizuj, aby zmierzyć pliki z kolejki bez zmiany ani kodowania dźwięku. Raport otwiera się automatycznie po zakończeniu i można go otworzyć ponownie przyciskiem "Wyniki analizy...". Lista pokazuje głośność, True Peak, zakres głośności (LRA) i PLR oraz dodatkowe pomiary dla każdego pliku. Cele wybrane przy rozpoczęciu analizy służą wyłącznie do porównania; różnice nie przewidują wyniku normalizacji. Można skopiować jeden wynik lub wszystkie wyniki oraz wyeksportować cały raport jako CSV. Raporty analizy i normalizacji są przechowywane oddzielnie w tej sesji. Nowe uruchomienie zastępuje tylko raport tego samego rodzaju. Brak pomiaru, błędy i anulowanie są oznaczone osobno. Po błędzie pliku analiza jest kontynuowana dla pozostałych plików. Anulowanie zachowuje zebrane wyniki.

Wyniki normalizacji również umożliwiają kopiowanie jednego lub wszystkich wyników i eksport CSV z oryginałem, celem, zmierzonym wynikiem, stanem, trybem przetwarzania i szczegółami kodowania.

Po zakończeniu analizy lub normalizacji odpowiednie okno wyników otwiera się automatycznie. Najedź myszą na przycisk wyników, aby zobaczyć wyjaśnienie, także gdy przycisk jest nieaktywny. Po anulowaniu zebrane wyniki pozostają dostępne przez odpowiedni przycisk.

Sprawdzanie plików wyjściowych i wyniki

MP3 i M4A domyślnie używają teraz jawnie 320 kbps CBR, niezależnie od przepływności źródła. MP3 używa jakości algorytmu LAME 0. VBR włącza się tylko przez wybór poziomu jakości VBR; M4A oferuje q2 i q1. OGG/Vorbis domyślnie używa 320 kbps ABR, czyli średniej przepływności docelowej, a nie ścisłego CBR. Poziomy jakości VBR pozostają osobnymi opcjami. Starsze profile stratne z Oryginalny / Domyślny wczytują nową wartość domyślną formatu; dawna opcja Vorbis 320 kbps (CBR) jest wczytywana jako 320 kbps (ABR). Profile zapisują jawny wybór jakości. Pomoc pod specyfikacją wyjaśnia headroom kodera i dopasowuje zawijanie tekstu do szerokości panelu. Wyniki i schowek zawierają wybrane ustawienie kodowania.

"Headroom kodera (dB)" rezerwuje od 0 do 3 dB przed kodowaniem MP3, M4A lub OGG na szczyty, które mogą powstać przy kodowaniu stratnym. Wewnętrzny limit True Peak jest obniżany o ustawioną wartość, nie niżej niż do minimalnego poziomu -9 dBTP obsługiwanego przez FFmpeg. Cel głośności i końcowy docelowy limit True Peak pozostają bez zmian. Wartość 0 wyłącza dodatkowy zapas. Ustawienie jest dostępne w sekcji Format wyjściowy i zapisywane w profilach. Starsze profile używają wartości domyślnej 0. WAV i FLAC ignorują to ustawienie. Wyniki i schowek pokazują żądany i zastosowany zapas. Weryfikacja porównuje gotowy zakodowany plik z wybranymi celami bez zmieniania pliku.

Włącz "Sprawdzaj pliki wyjściowe" przed normalizacją, aby zmierzyć gotowe, zakodowane pliki. Opcja jest domyślnie wyłączona i wymaga dodatkowego czasu analizy. Plik - Opcje zapisuje ustawienie domyślne; profile mogą zapisać wybór. Starsze profile są wczytywane ze sprawdzaniem wyłączonym.

Po przetwarzaniu otwórz "Wyniki...", aby porównać oryginał, cel i zmierzony wynik. Wyniki dotyczą ostatniej partii normalizacji i pozostają w pamięci do rozpoczęcia kolejnej partii lub zamknięcia programu. Wybrany wynik można skopiować.

Utworzenie pliku i jego sprawdzenie mają osobne stany. Błąd lub anulowanie sprawdzania nie usuwa poprawnie utworzonego pliku. Tolerancja głośności wynosi +/- 0,2 LU; True Peak może przekroczyć wybrany limit najwyżej o 0,1 dB, aby kontrola zakończyła się pomyślnie. LRA jest wyświetlane bez oceny względem celu. Są to tolerancje aplikacji, a nie certyfikacja.

Najpierw mierzy sygnał, a potem żąda stałej zmiany poziomu. FFmpeg może przejść do trybu dynamicznego, jeśli limity True Peak lub zakresu głośności (LRA) uniemożliwiają przetwarzanie liniowe. Preset masteringowy przetwarza dźwięk przed normalizacją i może zmienić dynamikę nawet wtedy, gdy FFmpeg zgłasza tryb liniowy. Gdy nie można zmierzyć głośności, w trybie dwuprzebiegowym regulacja głośności jest pomijana i nie można potwierdzić zgodności z celem. Dotyczy to na przykład ciszy i bardzo krótkich plików.

Poprawne cele to od -70 do -5 LUFS oraz od -9 do 0 dBTP. Oryginalny / Domyślny zachowuje obsługiwane głębie bitowe WAV, w tym 64-bitowy float. Gdy bitrate źródła nie pasuje do kodeka wyjściowego, używane są jego ustawienia domyślne. Konflikty ścieżek wyjściowych są odrzucane przed przetwarzaniem.

Tryby Normalizacji i Opcje Eksportu

Zaawansowane Opcje Eksportu i Parametry w Czasie Rzeczywistym

Edycja Herbstklang oferuje pełną kontrolę nad formatem wyjściowym:

• Wybór częstotliwości próbkowania: Dostosuj wyjściowe próbkowanie od "Oryginalny / Domyślny" aż do 192000 Hz (192 kHz).
• Jakość i głębia bitowa:
  • WAV: Wybierz próbki zmiennoprzecinkowe 32- lub 64-bitowe ("Floating Point"), PCM całkowitoliczbowy 16-, 24- lub 32-bitowy ("Integer") albo 8-bitowy PCM bez znaku ("Unsigned").
  • FLAC: Wybierz bezstratną rozdzielczość 24-bit lub 16-bit.
  • MP3 & M4A (CBR/VBR): Wybierz stałe bitraty (do 320 kbps) lub bardzo wydajne profile zmienne (np. V0, V2 dla MP3).
  • OGG: Obsługuje VBR oparte na jakości (q4 do q10) oraz cel 320 kbps ABR.
• Specyfikacje na żywo i Auto-Reset: Wiersz Parametry: pokazuje bieżące ustawienia wyjściowe. Zmiana formatu przywraca częstotliwość próbkowania "Oryginalny / Domyślny" oraz domyślną jakość danego formatu. MP3 i M4A używają domyślnie 320 kbps CBR, a OGG/Vorbis 320 kbps ABR.

Sterowanie Odtwarzaniem i Kolejka

Zintegrowany odtwarzacz i kolejka plików zostały zoptymalizowane dla maksymalnej płynności pracy:

• Zamrażanie procesów w systemie Windows (0% CPU): Kliknięcie pauzy całkowicie usypia proces FFplay w systemie (za pomocą NtSuspendProcess) [5], co sprawia, że w stanie wstrzymania zużywa on dokładnie 0% mocy procesora.
• Interaktywne przewijanie: Kliknij bezpośrednio na pasek postępu odtwarzacza, aby natychmiast przeskoczyć do wybranego momentu w utworze. Oś czasu aktualizuje się płynnie i bez opóźnień od sekundy 0.
• Asynchroniczne kolumny Treeview: Kolumny *Długość*, *Format* i *Próbkowanie* są skanowane w osobnym wątku w tle, dzięki czemu główny interfejs pozostaje całkowicie płynny.
• Zarządzanie kolumnami i integracja z Windows: Kliknij prawym przyciskiem myszy na nagłówki lub użyj menu kontekstowego, aby pokazać lub ukryć kolumny. Kliknięcie prawym przyciskiem myszy na plik pozwala również szybko zlokalizować go w Eksploratorze lub otworzyć natywne okno właściwości systemu Windows.

Właściwości dźwięku

Zakres głośności (LRA) opisuje zmienność głośności w czasie. Sample Peak to najwyższy poziom próbki cyfrowej; True Peak uwzględnia także szacowane szczyty między próbkami. Offset DC to składowa stała sygnału.

Głośność w tabelach wyników oznacza głośność zintegrowaną całego pliku, mierzoną w LUFS. Względny próg bramkowania to względny próg pomiaru głośności podawany przez FFmpeg, a nie próg kompresora ani bramka szumów w torze audio. Min. / maks. wartość próbki oznacza wartości próbek ze znakiem, a nie poziomy w dBFS. Współczynnik szczytu porównuje Sample Peak z RMS, a PLR porównuje True Peak z głośnością zintegrowaną. LRA opisuje zmienność głośności i nie jest zamiennikiem żadnego z tych współczynników. Zmierzona głębia bitowa opisuje zdekodowane próbki, a nie głębię bitową formatu pliku.

PLR (Peak-to-Loudness Ratio): PLR to różnica między maksymalnym poziomem True Peak a głośnością zintegrowaną tego samego pliku. Wartość w LU uzupełnia LRA i współczynnik szczytu. Jest obliczana z istniejącej analizy bez dodatkowego pomiaru. Brakujące lub nieskończone wartości są wyświetlane jako N/A; sam PLR nie ocenia jakości dźwięku.

Dzięki zintegrowanemu narzędziu Właściwości dźwięku możesz przeglądać szczegółowe informacje o swoich plikach audio, edytować metadane (tagi ID3), zarządzać okładkami oraz analizować szczegółowe statystyki głośności.

Jak otworzyć okno "Właściwości dźwięku":

Wybierz plik z listy i kliknij przycisk [ i ], lub po prostu kliknij prawym przyciskiem myszy na wybrany plik.

Funkcje w poszczególnych zakładkach:

• Zakładka Ogólne (General): Wyświetla kontener, kodek, częstotliwość próbkowania, kanały, czas trwania oraz nominalny bitrate. Aby zapewnić dokładność techniczną, głębia bitowa dla formatów stratnych jest poprawnie wyświetlana jako N/D.
• Zakładka Szczegóły (Details - Metadane): Edytuj tytuł utworu, artystę, album, rok, gatunek i inne. Obsługiwane funkcje dopasowują się dynamicznie (WAV obsługuje tylko standard RIFF INFO, surowy AAC jest tylko do odczytu, a M4A oferuje pełne wsparcie dla tagowania).
• Zakładka Okładka (Cover - Artwork): Wyświetla osadzone okładki dla MP3, FLAC i M4A. Pozwala bezstratnie zastępować obrazy, eksportować je lub całkowicie usuwać za pomocą dedykowanego przycisku "X".
• Zakładka Statystyki (Statistics): Łączy pomiar głośności według EBU R128 ze statystykami sygnału: głośność zintegrowana, True Peak, LRA, Sample Peak, średni poziom RMS, Offset DC, zmierzona głębia bitowa, współczynnik szczytu i PLR.
• Smart-Copy: Formatuje i kopiuje zawartość aktualnie otwartej zakładki bezpośrednio do schowka systemowego za pomocą jednego kliknięcia.

Wygląd Inspektora:

Kliknij na zdjęcia, aby je powiększyć.

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 / Bezpieczny dla streamingu (-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, M4A i OGG.
• Bez headroomu (0,0 dBTP) ustawia limit 0,0 dBTP bez zapasu na dodatkowe szczyty powstające przy kodowaniu stratnym.

Charakter Masteringu

Preset masteringowy przetwarza dźwięk przed normalizacją i może zmienić dynamikę nawet wtedy, gdy FFmpeg zgłasza tryb liniowy.

Nazwy te opisują zamierzony charakter brzmienia, a nie znormalizowane wielkości pomiarowe. Efekt zależy od materiału źródłowego. Kompresja i miękkie obcinanie szczytów działają przed normalizacją głośności i mogą zmieniać zarówno atak i gęstość brzmienia, jak i poziom szczytów.

Jakość i Metadane

Zachowanie jakości audio

Podczas eksportu do WAV lub FLAC oryginalne częstotliwości próbkowania i głębie bitowe są zachowywane automatycznie, chyba że użytkownik ręcznie wybierze inną konfigurację.

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.

Zarządzanie profilami

Edycja Herbstklang oferuje elastyczny system profili konfiguracyjnych, który umożliwia zapisywanie, wczytywanie i zarządzanie ulubionymi ustawieniami parametrów. Jest to niezwykle przydatne do szybkiego przełączania się między różnymi procesami roboczymi (np. normalizacją podcastów a masteringiem muzyki).

Dostępne akcje:

• Zapisz profil (Save Profile...): Eksportuje wszystkie bieżące parametry do czystego pliku JSON w katalogu /profile/. Możesz określić własną nazwę pliku.
• Wczytaj profil (Load Profile...): Importuje wcześniej zapisaną konfigurację z katalogu /profile/, aby natychmiast przywrócić stan obszaru roboczego.
• Przywróć domyślne (Reset to Defaults): Natychmiast przywraca wszystkie listy rozwijane konfiguracji, niestandardowe wartości docelowe i opcje masteringu do ich bezpiecznych, domyślnych parametrów.

System profili zapisuje kompletny zestaw ustawień głośności (docelowe LUFS, True Peak, charakter masteringu), wybrany tryb normalizacji oraz szczegóły formatu wyjściowego (w tym docelową częstotliwość próbkowania i wybraną jakość/głębię bitową).

Dodatkowe Uwagi

O Tym Pliku

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

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