# melcom's FFmpeg Audio Normalizer - Pomoc

## Spis Treści

- Wymagania
- Kroki Użycia Wersji v2 (GUI)
- Dodatkowe Uwagi
- Porady Dotyczące Użycia FFmpeg
- O Tym Pliku

## Wymagania

- Aby używać melcom's FFmpeg Audio Normalizer, potrzebujesz FFmpeg (ffmpeg.exe). Możesz pobrać FFmpeg z tego linku.
- Upewnij się, że `ffmpeg.exe` znajduje się w folderze, który jest zawarty w ścieżce systemowej (`PATH`), **lub** że możesz określić ścieżkę do `ffmpeg.exe` w opcjach programu (zobacz sekcję 'Opcje' w instrukcji GUI).

## Kroki Użycia Wersji v2 (GUI)

1. Uruchom wersję GUI (plik `.exe`). Upewnij się, że FFmpeg jest poprawnie zainstalowany i że program może znaleźć `ffmpeg.exe`. Jeśli otrzymasz komunikaty o błędach, sprawdź ścieżkę FFmpeg w opcjach (Plik -> Opcje).
2. Kliknij "Przeglądaj", aby wybrać plik audio.
3. Opcjonalnie wybierz Preset LUFS z listy rozwijanej lub wprowadź Docelową Wartość LUFS.
4. Opcjonalnie wybierz Preset True Peak z listy rozwijanej lub wprowadź Wartość True Peak (dBTP).
5. Opcjonalnie wybierz Format Wyjściowy (nowość: również OGG).
6. Kliknij "Analizuj Audio" lub "Start Normalizacji".
7. Postęp jest wyświetlany na pasku postępu i w polu informacji o procesie.
8. Znormalizowany plik wyjściowy jest tworzony domyślnie w **tym samym folderze co plik oryginalny**. Nazwa pliku jest oparta na oryginalnej nazwie pliku, uzupełniona o dodatek '-Normalized' przed rozszerzeniem pliku. **Przykład:** `plikmuzyczny.wav` staje się `plikmuzyczny-Normalized.wav`.

## Dodatkowe Uwagi

Informacje o Presetach LUFS i True Peak w tym narzędziu:

- Presety LUFS: Wstępnie zdefiniowane docelowe wartości głośności (Integrated Loudness) w LUFS, zoptymalizowane dla różnych platform i aplikacji:
  - Domyślny (-14 LUFS): Powszechna standardowa wartość docelowa dla produkcji muzycznej i masteringu.
  - YouTube (-14 LUFS): Zalecana wartość docelowa dla uploadów na YouTube.
  - Spotify (-14 LUFS): Zalecana wartość docelowa dla Spotify.
  - Broadcast EBU R128 (-23 LUFS): Wartość docelowa dla transmisji TV i radiowych zgodnie ze standardem EBU R128.
  - Własny: Umożliwia ręczne wprowadzenie własnej docelowej wartości LUFS w polu wprowadzania obok rozwijanej listy presetów. Jest to przydatne, jeśli potrzebujesz specyficznych docelowych wartości głośności dla innych platform lub aplikacji, które nie są zawarte w presetach. Uwaga: Zalecany zakres LUFS wynosi od -70 do -5 LUFS.
- Presety True Peak: Wstępnie zdefiniowane wartości graniczne True Peak w dBTP (Decybele True Peak):
  - Domyślny (-1 dBTP): Powszechna standardowa wartość graniczna, aby uniknąć szczytów międzysamplowych.
  - Broadcast (-2 dBTP): Bardziej rygorystyczna wartość graniczna dla aplikacji nadawczych.
  - Bez Limitu (0 dBTP): Brak limitu True Peak (0 dBTP). Uwaga: Ryzykowne! Może prowadzić do szczytów międzysamplowych i clippingu, szczególnie przy kodowaniu do formatów stratnych. Zalecane tylko dla doświadczonych użytkowników.
  - Własny: Umożliwia ręczne wprowadzenie własnej wartości granicznej True Peak (w dBTP) w polu wprowadzania obok rozwijanej listy presetów. Jest to przeznaczone dla zaawansowanych użytkowników, którzy mają specyficzne wymagania dotyczące True Peak. Uwaga: Zalecany zakres True Peak wynosi od -9 do 0 dBTP.

Opcja 'Pojedynczy Wpis Logu' (Opcje -> Ustawienia Pliku Logu):

- Domyślnie włączona: Przy każdej analizie lub normalizacji, poprzedni plik logu jest **czyszczony** i zapisywane są tylko informacje o bieżącym procesie. Tworzy to **krótki i przejrzysty plik logu**, który zawsze zawiera tylko ostatnią operację.
- Możliwość dezaktywacji: Jeśli dezaktywujesz tę opcję, **wszystkie** procesy analizy i normalizacji są **zapisywane jeden po drugim** w pliku logu (zachowanie log rolling, jeśli plik logu osiągnie określony rozmiar). Jest to przydatne, jeśli chcesz mieć **historię** wykonanych procesów.
- Pole 'Maksymalny Rozmiar Pliku Logu': Jeśli opcja 'Pojedynczy Wpis Logu' jest włączona, pole 'Maksymalny Rozmiar Pliku Logu' jest **nieaktywne**, ponieważ plik logu i tak zaczyna się od nowa przy każdym procesie.

## Porady Dotyczące Użycia FFmpeg

FFmpeg to potężne narzędzie do przetwarzania plików multimedialnych. Oto kilka przydatnych poleceń związanych z analizą i normalizacją audio, w tym standardowe polecenie, którego to narzędzie używa wewnętrznie:

- Standardowe Polecenie Normalizacji (używane przez 'melcom's FFmpeg Audio Normalizer'):
  `ffmpeg -i "plikmuzyczny.wav" -af "loudnorm=I=-14:TP=-1" -ar 48000 -ac 2 -c:a pcm_f32le "plikmuzyczny-Normalized.wav"`
  To polecenie jest przykładem standardowego polecenia normalizacji, którego 'melcom's FFmpeg Audio Normalizer' używa, gdy wybierzesz ustawienia domyślne (Preset LUFS: 'Domyślny (-14 LUFS)', Preset True Peak: 'Domyślny (-1 dBTP)', Format Wyjściowy: WAV). Oto szczegółowe wyjaśnienie poszczególnych opcji i parametrów:
  - `ffmpeg`: Wywołuje program FFmpeg.
  - `-i "plikmuzyczny.wav"`: Określa **plik wejściowy**. W tym przypadku jest to `plikmuzyczny.wav`. Zastąp to ścieżką do Twojego rzeczywistego pliku audio.
  - `-af "loudnorm=I=-14:TP=-1"`: Używa **filtra audio** `loudnorm` do normalizacji głośności.
    - `loudnorm`: Nazwa filtra normalizacji głośności.
    - `I=-14`: Ustawia **Docelową Głośność Zintegrowaną (Integrated Loudness)** na -14 LUFS (Loudness Units Full Scale). Jest to domyślna wartość LUFS w narzędziu.
    - `TP=-1`: Ustawia **Docelowy Poziom True Peak** na -1 dBTP (Decybele True Peak). Jest to domyślna wartość True Peak w narzędziu i pomaga uniknąć clippingu.
  - `-ar 48000`: Ustawia **częstotliwość próbkowania audio** na 48000 Hz. 48 kHz to powszechna częstotliwość próbkowania dla audio i wideo.
  - `-ac 2`: Ustawia **liczbę kanałów audio** na 2 (stereo). Zapewnia to, że sygnał wyjściowy jest stereo.
  - `-c:a pcm_f32le`: Ustawia **kodek audio** dla wyjścia na `pcm_f32le`.
    - `-c:a`: Opcja do określenia kodeka audio.
    - `pcm_f32le`: Oznacza "Pulse Code Modulation, 32-bit float, little-endian". Jest to nieskompresowany, bezstratny kodek audio (format WAV z 32-bitowym punktem zmiennoprzecinkowym). Narzędzie domyślnie używa formatu WAV jako formatu wyjściowego.
  - `"plikmuzyczny-Normalized.wav"`: Określa **plik wyjściowy**. W tym przypadku zostanie utworzony nowy plik o nazwie `plikmuzyczny-Normalized.wav`. Narzędzie domyślnie dodaje "-Normalized" do nazwy pliku.
- Analiza Audio za Pomocą Filtra Loudnorm:
  `ffmpeg -i plikwejściowy.wav -af loudnorm=print_format=summary -f null -`
  To polecenie analizuje plik audio `plikwejściowy.wav` za pomocą filtra `loudnorm` FFmpeg, ale nie generuje znormalizowanego pliku wyjściowego. Zamiast tego, wypisuje podsumowanie wartości głośności (Integrated Loudness, True Peak, Loudness Range) w konsoli. Może to być przydatne do sprawdzenia aktualnych wartości głośności pliku przed rozpoczęciem normalizacji.
- Prosta Konwersja Audio (Przykład WAV do MP3):
  `ffmpeg -i plikwejściowy.wav plikwyjściowy.mp3`
  To polecenie konwertuje plik WAV `plikwejściowy.wav` na plik MP3 `plikwyjściowy.mp3`. Jeśli masz ogólne problemy z FFmpeg, możesz użyć tego prostego polecenia, aby sprawdzić, czy FFmpeg w zasadzie działa.

## O Tym Pliku

Ten program został stworzony przez Andreasa 'melcom' Urbana i jest **oprogramowaniem open-source**, licencjonowanym na licencji **MIT**. Oznacza to, że możesz go swobodnie używać, modyfikować i rozpowszechniać, zarówno do celów prywatnych, jak i komercyjnych. Pełne warunki licencji można znaleźć w pliku `LICENSE.txt`, który towarzyszy programowi.

Jeśli masz jakieś pytania, możesz skontaktować się z melcom za pomocą poniższego linku: Formularz Kontaktowy