===============================================================================
                    ZAP AUDIO CODEC v1.0.0
                         README (DEUTSCH)
===============================================================================

WILLKOMMEN BEI ZAP!
-------------------
ZAP (Zero Audible Psychoacoustic) ist ein hochmoderner Audio-Codec, der 
Studio-Qualität bei geringen Bitraten bietet. Entwickelt für Audiophile, 
Produzenten und alle, die verlustfreie Qualität in kompakter Form schätzen.

===============================================================================
SCHNELLSTART
===============================================================================

INSTALLATION
------------
1. Entpacken Sie die heruntergeladene ZIP-Datei
2. Das Programm ist sofort einsatzbereit - keine Installation nötig!

SYSTEMVORAUSSETZUNGEN
----------------------
- Windows, macOS oder Linux
- Mindestens 2 GB RAM
- Multi-Core Prozessor empfohlen (für schnellere Kodierung)
- Audioausgabegerät

===============================================================================
GRUNDLEGENDE VERWENDUNG
===============================================================================

ZAP bietet drei Hauptfunktionen:

1. KODIERUNG (ENCODE)
----------------------
Konvertiert verlustfreie Audiodateien in das ZAP-Format.

Syntax:
    zap_codec encode <eingabedatei> [OPTIONEN]

Beispiele:
    zap_codec encode mein_song.wav
    zap_codec encode studio_mix.flac
    zap_codec encode album_track.aiff

WICHTIG: Nur verlustfreie Formate werden akzeptiert!
✓ Unterstützt: WAV, FLAC, AIFF
✗ Nicht unterstützt: MP3, OGG, AAC, M4A (lossy Formate)

2. WIEDERGABE (PLAY)
---------------------
Spielt ZAP-Dateien direkt ab.

Syntax:
    zap_codec play <datei.zap>

Beispiel:
    zap_codec play mein_song.zap

Steuerung:
    - Drücken Sie Strg+C zum Stoppen
    - Fortschrittsanzeige zeigt aktuelle Position

3. DEKODIERUNG (DECODE)
------------------------
Konvertiert ZAP-Dateien zurück zu WAV.

Syntax:
    zap_codec decode <datei.zap> [ausgabe.wav]

Beispiele:
    zap_codec decode mein_song.zap
    zap_codec decode mein_song.zap wiederhergestellt.wav

Wenn kein Ausgabename angegeben wird, heißt die Datei "decoded.wav"

===============================================================================
METADATEN HINZUFÜGEN
===============================================================================

Sie können beim Kodieren Metadaten hinzufügen oder überschreiben:

VERFÜGBARE OPTIONEN
-------------------
--title "Songtitel"          Titel des Tracks
--artist "Künstlername"      Name des Künstlers
--album "Albumname"          Name des Albums
--year "2025"                Erscheinungsjahr
--genre "Rock"               Musikgenre
--track 3                    Track-Nummer
--comment "Kommentar"        Zusätzlicher Kommentar

BEISPIEL MIT METADATEN
----------------------
zap_codec encode song.wav --title "Midnight Dreams" --artist "Die Band" 
          --album "Greatest Hits" --year "2025" --genre "Jazz" --track 5

HINWEIS: Wenn Ihre Eingabedatei bereits Metadaten enthält (z.B. in FLAC 
oder MP3-Tags), werden diese automatisch übernommen. Mit den obigen 
Optionen können Sie diese überschreiben.

===============================================================================
WORKFLOW-BEISPIELE
===============================================================================

SZENARIO 1: EINZELNE DATEI KODIEREN
------------------------------------
1. Öffnen Sie ein Terminal/Kommandozeile
2. Navigieren Sie zum ZAP-Ordner
3. Führen Sie aus:
   
   zap_codec encode meine_musik.flac

4. Fertig! Die Datei "meine_musik.zap" wurde erstellt

SZENARIO 2: MIT METADATEN KODIEREN
-----------------------------------
zap_codec encode track.wav --title "Sommerregen" --artist "Max Mustermann"

SZENARIO 3: ANHÖREN UND DANN DEKODIEREN
----------------------------------------
1. Zuerst anhören:
   zap_codec play song.zap

2. Gefällt es? Dann dekodieren:
   zap_codec decode song.zap original.wav

SZENARIO 4: GANZES ALBUM BEARBEITEN
------------------------------------
Für mehrere Dateien können Sie eine Batch-Datei/Shell-Script erstellen:

Windows (batch.bat):
    @echo off
    for %%f in (*.flac) do zap_codec encode "%%f"

Linux/Mac (batch.sh):
    #!/bin/bash
    for file in *.flac; do
        zap_codec encode "$file"
    done

===============================================================================
TECHNISCHE DETAILS
===============================================================================

WAS MACHT ZAP BESONDERS?
-------------------------
✓ Psychoakustische Kodierung - Nutzt menschliche Hörcharakteristik
✓ Intelligentes Mid/Side Stereo - Automatische Optimierung
✓ Transparente Dynamikverarbeitung - Subtile Verbesserung ohne Artefakte
✓ 64-Bit Verarbeitung - Höchste Präzision
✓ Multi-Core Support - Schnelle Kodierung auf modernen CPUs

QUALITÄT
--------
- Zielbitrate: < 280 kbps
- Kompression: 70-85% Größenreduktion
- Fidelity: 93-99% (transparente Qualität)
- Frequenzbereich: 10 Hz - 22 kHz

UNTERSTÜTZTE FORMATE
--------------------
Eingabe (Kodierung):
    - WAV (Waveform Audio File Format)
    - FLAC (Free Lossless Audio Codec)
    - AIFF (Audio Interchange File Format)

Ausgabe (Dekodierung):
    - WAV (16-bit PCM)

===============================================================================
HÄUFIG GESTELLTE FRAGEN (FAQ)
===============================================================================

F: Warum wird meine MP3-Datei nicht akzeptiert?
A: ZAP ist für verlustfreie Quellen optimiert. MP3 ist bereits komprimiert
   und würde zu Qualitätsverlust führen. Verwenden Sie WAV, FLAC oder AIFF.

F: Wie lange dauert die Kodierung?
A: Abhängig von der Dateilänge und CPU-Leistung. Eine 3-Minuten-Datei
   dauert typischerweise 10-30 Sekunden auf modernen Systemen.

F: Ist die Qualität wirklich verlustfrei?
A: ZAP ist ein "transparenter" lossy Codec - optimiert für unhörbare
   Verluste. Für absolute Bit-Perfektion nutzen Sie weiterhin FLAC.

F: Kann ich ZAP für kommerzielle Projekte nutzen?
A: Ja, aber bitte kreditieren Sie das Projekt. Details siehe Lizenz.

F: Wie groß werden die ZAP-Dateien?
A: Typischerweise 15-30% der ursprünglichen WAV-Größe, abhängig vom
   Audiomaterial (komplexe Musik = größer, Sprache = kleiner).

F: Werden Cover-Arts gespeichert?
A: ZAP speichert eine Info, OB ein Cover vorhanden war, aber nicht das
   Bild selbst. Dies wird in zukünftigen Versionen hinzugefügt.

F: Kann ich die Bitrate ändern?
A: Die maximale Bitrate ist auf 280 kbps festgelegt. Für andere Werte
   müssen Sie den Quellcode anpassen (siehe DOCUMENTATION.txt).

===============================================================================
FEHLERBEHEBUNG
===============================================================================

PROBLEM: "Lossy format detected"
LÖSUNG: Ihre Datei ist bereits komprimiert (MP3, OGG, etc.). 
        Konvertieren Sie zuerst zu WAV oder FLAC.

PROBLEM: Wiedergabe stottert
LÖSUNG: - Schließen Sie andere Programme
        - Prüfen Sie CPU-Auslastung
        - Verwenden Sie einen schnelleren Computer

PROBLEM: "File not found"
LÖSUNG: - Prüfen Sie den Dateipfad
        - Nutzen Sie Anführungszeichen bei Leerzeichen: "mein song.wav"
        - Navigieren Sie zum richtigen Ordner

PROBLEM: Metadaten werden nicht gespeichert
LÖSUNG: - Prüfen Sie, ob Eingabedatei Tags enthält
        - Nutzen Sie manuelle Flags (--title, --artist, etc.)

PROBLEM: Ausgabedatei zu groß
LÖSUNG: ZAP ist für Studio-Aufnahmen optimiert. Bei sehr komplexem
        Material können größere Dateien entstehen.

===============================================================================
PERFORMANCE-TIPPS
===============================================================================

FÜR SCHNELLERE KODIERUNG
------------------------
✓ Nutzen Sie einen Multi-Core Prozessor (4+ Kerne)
✓ Schließen Sie andere Programme
✓ Verwenden Sie eine SSD statt HDD
✓ Kodieren Sie mehrere Dateien parallel (separate Terminals)

FÜR BESTE QUALITÄT
------------------
✓ Verwenden Sie hochwertige Quellen (24-bit/96kHz wenn verfügbar)
✓ Nutzen Sie FLAC als Eingabeformat
✓ Vermeiden Sie mehrfache Kodierung (WAV→ZAP→WAV→ZAP)

===============================================================================
PROJEKTINFORMATIONEN
===============================================================================

VERSION: 1.0.0
VERÖFFENTLICHUNG: 2025
ENTWICKLER: Christian Schwarzer
KONTAKT: c-schwarzer@web.de
WEBSITE: https://hdspace.eu

LIZENZ
------
Open-Source (spezifische Lizenz wird noch festgelegt)

Bei Nutzung oder Modifikation bitte kreditieren:
"Powered by ZAP Audio Codec v1.0.0 by Christian Schwarzer"

===============================================================================
WEITERFÜHRENDE DOKUMENTATION
===============================================================================

Für detaillierte technische Informationen, siehe:
- DOCUMENTATION.txt (vollständige technische Spezifikation)
- Source Code (main.rs mit ausführlichen Kommentaren)

Für Fragen, Bugs oder Feature-Requests:
- E-Mail: c-schwarzer@web.de
- Oder nutzen Sie den Thumbs-Down in der HDSpace Interface

===============================================================================
DANKE
===============================================================================

Vielen Dank, dass Sie ZAP nutzen! Dieses Projekt wurde mit Leidenschaft
für hochwertige Audio-Kompression entwickelt.

Wenn Ihnen ZAP gefällt, erzählen Sie anderen davon!

Happy Listening! 🎵

===============================================================================
                              ENDE
===============================================================================