# ABSOLUTION Ω — v0.9 · Unified Studio Workspace **Ein Projekt. Eine eindeutig benannte Quelldatei. Alle echten Werkzeuge an einem Ort.** ## Neue Bedienoberfläche Die frühere Navigation mit separaten Seiten (Import, Arrangement, Bass, Noise, Stems, Forensik) wurde durch **ein einziges Studio** ersetzt: - **Links: Projektbibliothek.** Projekte anhand Namen oder Quelldatei suchen, wechseln, umbenennen und neue Projekte durch Dateiimport erzeugen. Beim Import wird keine Quelldatei in einem anderen Projekt überschrieben. - **Oben: aktive Quelle.** Dateiname, Hash-Ausschnitt, Dauer, Abtastrate, Anzahl aktiver Stems und Original-Wiedergabe bleiben immer sichtbar. - **Mitte: Master-Übersicht und Stereo-Mixer.** Farbige Wellenformen für die tatsächlichen Stems, Transport/Seek, Gain, Mute, Solo, Panorama, Effekt-Racks und Render-Vorschau. - **Rechts: kontextabhängiger Inspector.** Workflow, KI-Trennplan, BASS-CORE, NOISE-CORE und Export/Diagnostik. Keine Funktions-Unterseiten. - **Unten: ein gemeinsamer Jobstatus.** Separations-, Bass-, Noise-, OMNISTEM- und Mix-Jobs melden Fortschritt im selben Studio. Die gesamte Oberfläche ist in `app/static/index.html`, `studio.css`, `studio.js` implementiert. Alte, nicht mehr verwendete JavaScript-/CSS-Frontends wurden entfernt. Kein CDN, keine Telemetrie und keine automatischen Cloud-Uploads. ## Schnellstart Python 3.11+ und unterstützte System-Audio-Codecs bereitstellen: ```bash python -m venv .venv source .venv/bin/activate # Windows: .venv\\Scripts\\Activate.ps1 python -m pip install -e ".[dev]" python -m pytest -q python -m uvicorn app.server:app --host 127.0.0.1 --port 8000 ``` Alternativ `start_windows.bat` bzw. `bash start.sh`; Browser: **http://127.0.0.1:8000** 1. **Audio importieren**: Neues Projekt erzeugt; Quelle steht immer oben. 2. **Workflow**: Mini-KI-Vorinventur optional, Basis-Separation mit HPSS. Demucs nur bei vorhandenen vertrauenswürdigen lokalen Gewichten. 3. **KI-Plan**: Hypothesen umbenennen, prüfen und technisch mögliche Proxy-Spuren ausführen. Nicht unterstützte Instrumente bleiben blockiert. 4. **Bass**: Kick/Bassline als additive Stems plus einstellbare Bassbearbeitung. Optionaler separater FFmpeg-Virtual-Bass-2.1-Export. 5. **Störung**: Scan ohne Änderungen; auffällige Klickstellen bewusst auswählen und reparieren. Die Differenz wird als **NOISE**-Stem sichtbar und bleibt im neutralen Mix zunächst hörbar. 6. **Spur-Mixer**: Gain, Mute/Solo, Panorama, Filter, Sättigung, Breite, optional Tempo/Pitch (FFmpeg/Rubber Band), dann **Mix rendern**. 7. **Export**: Original, Stems-ZIP, Mix-WAV, Bass/Noise-Pakete im gleichen Inspector. Einstellungen wirken nur auf einen neu berechneten Mix. ### Datei- und Projektsicherheit Jedes Projekt besitzt derzeit **genau eine Quell-Audiodatei**. Die neue durchsuchbare lokale Bibliothek (`GET /api/v1/projects`) listet alle verfügbaren Projekte und zeigt die zugeordnete Datei. Projektumbenennung erfolgt über `PATCH /api/v1/projects/{id}`. Die Quelldatei bleibt unverändert. Projekt- und Jobverwaltung sind lokal und nicht als öffentlicher Mehrbenutzerdienst abgesichert. Vor öffentlichem Deployment sind Authentifizierung, Autorisierung und Upload-/Speicherhärtung erforderlich. ### Wahrheits- und Klangschutz - HPSS liefert spektrale Harmonic/Percussive/Residual-Anteile, **keine** garantiert instrumentreinen Stems. - OMEGA-TAG Mini ist auf synthetischen Signalen feinjustiert; Empfehlungen sind **unsichere Vorinventur**, keine verlässliche Instrumentenerkennung. - BASS-CORE und OMNISTEM-DSP-Proxies sind Näherungen. - NOISE-CORE repariert nur freigegebene Kandidaten. Keine automatische Breitband-Entrauschung und keine Behauptung absoluter Verlustfreiheit. - Der neutrale additive Stem-Graph rekonstruiert die Quelle innerhalb dokumentierter numerischer Toleranz; das beweist **nicht** Quellenreinheit. - Alle Audioeffekte werden erst beim expliziten Render verarbeitet. Nach Reglereingriffen wird ein alter Mix als veraltet markiert. ### Technische Prüfungen Tests: `python -m pytest -q` (API, DSP/Audio, Projektbibliothek, Mix, Bass, Noise, OMNISTEM, Oberfläche/Static-Verteilung). Syntax: `node --check app/static/studio.js`. Browsersimulation: isolierte UI-Prüfung mit echten Demo-Stem-Waveforms und kontrollierten API-Antworten. Der Testbrowser konnte nicht direkt zu localhost navigieren; ein vollständiger produktionsnaher Browser-End-to-End-Test ist damit **nicht** abgedeckt.