# melcom's FFmpeg Audio Normalizer

Ljudnormalisering med öppen källkod som drivs av FFmpeg, LUFS- och True Peak-bearbetning. Byggd för musikproduktion, podcaster, spelljud och stora batch-arbetsflöden - helt utan krav på kommandoradskunskap.

## Krav

För att använda melcom's FFmpeg Audio Normalizer krävs hela FFmpeg-paketet:

- `ffmpeg.exe` - Ljudanalys, normalisering och skrivning av metadata
- `ffplay.exe` - Ljuduppspelning för förhandsgranskning och spelarfunktioner
- `ffprobe.exe` - Läsa teknisk ljudinformation och kanaldetektering

Rekommenderad nedladdning:
github.com/BtbN/FFmpeg-Builds/releases
Rekommenderat paket:
`ffmpeg-master-latest-win64-gpl.zip`

Efter att du har packat upp FFmpeg, konfigurera sökvägen till FFmpeg-mappen i programmets alternativmeny.

## Komma igång

1. Starta `AudioNormalizer.exe`.
2. Öppna:
   `Arkiv -> Alternativ`
3. Välj mappen som innehåller:
   `ffmpeg.exe`, `ffplay.exe` och `ffprobe.exe`
4. Använd "Lägg till filer", "Lägg till mapp" eller dra dina filer direkt via **Drag & Drop** till kön.
5. Välj önskad LUFS-förinställning, True Peak-gräns och utdataformat.
6. Välj en förinställning för mastering-karaktär. Transparent är standard och lägger inte till någon extra färgning av ljudet.
7. Klicka på:
   "Starta normalisering"

Under bearbetningen visar loggfönstret aktuell status, FFmpeg-utdata och bearbetningsförlopp i realtid.

## Normaliseringslägen & Exportalternativ

### Linjär (2 pass)

Rekommenderas för musikproduktion, mastering och arkivering. Ljudfilen analyseras under det första passet och normaliseras med en fast förstärkning under det andra passet. Detta bevarar den ursprungliga dynamiken så troget som möjligt.

### Dynamisk (1 pass)

Rekommenderas för tal, podcaster, strömmar och sändningsmaterial. Skillnader i ljudstyrka utjämnas aktivt under bearbetningen.

### Avancerade exportalternativ & Specifikationer i realtid

Kontrollraum Edition erbjuder total kontroll över ditt utdataformat:

- Val av samplingsfrekvens: Justera utdata samplingsfrekvenser fritt från "Original / Default" upp till `192000 Hz (192 kHz)`.
- Kvalitet & Bitdjup:
  - WAV: Välj mellan 64-bit / 32-bit Floating Point, linjär 32-bit / 24-bit / 16-bit integer och 8-bit unsigned.
  - FLAC: Välj 24-bit eller 16-bit förlustfria upplösningar.
  - MP3 & M4A (CBR/VBR): Välj konstanta bithastigheter (upp till 320 kbps) eller mycket effektiva variabla profiler (t.ex. V0, V2 för MP3).
  - OGG: Stöder variabla kvalitetsnivåer (q4 till q10) samt konstant 320 kbps.
- Live-specifikationer & Återställning: En dynamisk `Specs:`-indikator uppdateras direkt med dina inställningar. För att förhindra formatkonflikter återställs menyerna automatiskt till "Original / Default" när du byter containerformat.

## Uppspelningskontroller & Kö

Den inbyggda spelaren och kön har optimerats för ett sömlöst arbetsflöde:

- Processfrysning i Windows (0 % CPU): Att klicka på paus (⏸) sätter FFplay-processen helt i viloläge (med hjälp av `NtSuspendProcess`) [5], vilket gör att den förbrukar exakt 0 % CPU-kraft under pausen.
- Klick-interaktiv sökning: Klicka var som helst på förloppsindikatorn för att hoppa direkt till den punkten i spåret. Tidslinjen uppdateras smidigt från sekund 0 utan fördröjning.
- Asynkrona Treeview-kolumner: Kolumnerna *Längd*, *Format* och *Sampl.frekv.* skannas i en bakgrundstråd, vilket håller huvudgränssnittet helt flytande.
- Kolumnväljare & Windows-integration: Högerklicka på rubrikerna eller använd kontextmenyn för att visa eller dölja kolumner. Genom att högerklicka på en fil kan du också snabbt hitta den i Utforskaren eller öppna det äkta Windows-egenskapsfönstret.

## Ljudegenskaper

Med den integrerade Ljudegenskaper kan du se detaljerad information om dina ljudfiler, redigera metadata (ID3-taggar), hantera omslagsbilder och hämta omfattande ljudstyrkestatistik.

### Så här öppnar du Ljudegenskaper:

Välj en fil i listan och klicka på [ i ]-knappen, eller högerklicka helt enkelt på önskad fil.

### Funktioner per flik:

- Fliken Allmänt (General): Visar container, codec, samplingsfrekvens, kanaler, längd och nominell bithastighet. För att säkerställa teknisk noggrannhet visas bitdjup för förlustkomprimerade format korrekt som `N/A`.
- Fliken Detaljer (Details): Redigera låtnamn, artist, album, år, genre och mer. Funktionerna anpassar sig dynamiskt (WAV stöder endast standard RIFF INFO, rå AAC är skrivskyddad och M4A erbjuder fullständigt taggningsstöd).
- Fliken Omslag (Artwork): Visa inbäddade omslag för MP3, FLAC och M4A. Ersätt bilder förlustfritt, exportera dem eller ta bort dem helt med en dedikerad "✕"-knapp.
- Fliken Statistik (Statistics): Utför en högprecisions EBU R128-analys. Visa integrerad ljudstyrka, True Peak, Sample Peak, genomsnittlig RMS-effekt, DC-offset, uppmätt bitdjup och Crest-faktor.
- Smart-Copy: Formaterar och kopierar innehållet på den den aktiva fliken direkt till ditt urklipp med ett enda klick.

### Inblick i Inspector:

Klicka på bilderna för att förstora dem.

## Förinställningar & Ljudkaraktär

### LUFS & True Peak-förinställningar

- Appen erbjuder tydliga, moderna och lättförståeliga förinställningsprofiler för alla vanliga riktlinjer för streaming och sändning.
- Standard / Streaming säker (-1.0 dBTP) är ett starkt standardval för de flesta strömmande plattformar.
- Förlustkomprimerad codec säker (-2.0 dBTP) ger extra takhöjd (headroom) för MP3-, OGG- och M4A-exporter.
- Ingen gräns / Riskabelt (0.0 dBTP) bör endast användas när målformatet uttryckligen tillåter det.

### Mastering-karaktär

Transparent

Ren normalisering av ljudstyrka utan extra ljudformning.

Cohesive

Lägger till mild komprimering och subtil soft clipping för en tätare övergripande mix.

Punchy

Levererar starkare slagkraft, mer energi och mer märkbar dynamisk bearbetning.

Aggressive

Det starkaste bearbetningsläget för tätt, skarpt eller aggressivt elektroniskt material.

## Kvalitet & Metadata

### Bevarande av ljudkvalitet

Vid export till WAV eller FLAC bevaras den ursprungliga samplingsfrekvensen och bitdjupet automatiskt, såvida inte en anpassad konfiguration har valts manuellt.

### Metadata & taggar

Artist, album, titel, år och ytterligare metadata kopieras automatiskt till den normaliserade utdatafilen.

MP3-filer använder automatiskt standarden ID3v2.3 för maximal kompatibilitet med Utforskaren i Windows och hårdvaru-spelare.

## Profilhantering

Kontrollraum Edition har ett flexibelt profilhanteringssystem som låter dig spara, ladda och hantera dina föredragna parameterinställningar. Detta är mycket användbart för att snabbt växla mellan olika arbetsflöden (t.ex. poddnormalisering kontra musikmastering).

### Tillgängliga åtgärder:

- Spara profil... (Save Profile...): Exportera alla dina aktuella parametrar till en ren JSON-fil i katalogen `/profile/`. Du kan ange ett valfritt filnamn.
- Ladda profil... (Load Profile...): Importera en tidigare sparad konfiguration från katalogen `/profile/` för att omedelbart återställa arbetsytans tillstånd.
- Återställ till standardvärden (Reset to Defaults): Återställ omedelbart alla konfigurationsmenyer, anpassade målvärden och masteringsalternativ till deras säkra standardparametrar.

Profilsystemet sparar hela uppsättningen av ljudstyrkeinställningar (mål-LUFS, True Peak, mastering-karaktär), det valda normaliseringsläget samt utdataformatets detaljer (inklusive målsamplingsfrekvens och val av kvalitet/bitdjup).

## Ytterligare anmärkningar

Körningsutjämning: Subprocessläsning sker nu via `readline()` istället för att läsa tecken för tecken. Detta minskar CPU-overhead avsevärt och eliminerar helt GUI-stutter under pågående bearbetning.
Robusthetsskydd: Applikationen förhindrar proaktivt att filer läggs till i kön om den konfigurerade FFmpeg-sökvägen saknas eller är ogiltig för att undvika runtime-problem.
Om en process avbryts eller ett fel inträffar tas tillfälliga arbetsfiler (`.temp`) bort automatiskt.

## Om denna hjälpfil

Detta projekt skapades av melcom och släpptes under MIT-licensen.

Projektets webbplats:
melcom-creations.github.io/melcom-music

×