# Musubi

**NDI rein. Bild, Ton und Stimme raus.**

Musubi (結び, japanisch: das Knüpfen, Verbinden) ist eine macOS-App von Zielke Studio für kleine Live-Übertragungen. Sie macht MacBook und Mac mini zu den fehlenden Bausteinen einer Regie:

- NDI-Quellen im Vollbild auf beliebige Bildschirme
- NDI-Ton (auch ohne Bild) gezielt auf einzelne Kanäle eines Audio-Interfaces
- Talkback per Sprechtaste
- Intercom, PGM-Vorschau und Tally fürs Handy im Browser
- Szenen, die Regie-Mac und Bühnen-Mac auf einen Klick einrichten

Erster Einsatz: OP-Liveübertragung (ATEM im OP, Regie im Saal, eine Netzwerkleitung dazwischen).

## Status

Planung abgeschlossen, Entwicklung startet mit Meilenstein 0. Siehe [docs/04-fahrplan.md](docs/04-fahrplan.md).

## Dokumente

| Datei | Inhalt |
|---|---|
| [CLAUDE.md](CLAUDE.md) | Arbeitsanweisungen für Claude Code |
| [START.md](START.md) | Startbefehl für Claude Code |
| [docs/01-konzept.md](docs/01-konzept.md) | Idee, Rollen, Funktionsumfang |
| [docs/02-architektur.md](docs/02-architektur.md) | Module, Frameworks, Datenflüsse |
| [docs/03-design.md](docs/03-design.md) | Designsystem, Farben, Typografie, Texte |
| [docs/04-fahrplan.md](docs/04-fahrplan.md) | Meilensteine mit Abnahmetests |
| [docs/05-testplan-hardware.md](docs/05-testplan-hardware.md) | Tests, sobald die Hardware da ist |
| [docs/06-netzwerk.md](docs/06-netzwerk.md) | IP-Plan, Schnittstellen, Relay als Plan B |

## Bauen

```bash
brew install xcodegen          # einmalig
xcodegen                       # erzeugt Musubi.xcodeproj aus project.yml
open Musubi.xcodeproj
```

Das `.xcodeproj` ist generiert und nicht im Repo. Nach Änderungen an `project.yml` erneut `xcodegen` ausführen.
Ohne NDI SDK in `Vendor/NDI/` bricht der Build mit einem Hinweis ab. Tests: im Schema `Musubi` (⌘U) oder `cd Packages/MusubiKit && swift test` – beides braucht das SDK, weil alle Module mitgebaut werden.

## Struktur

| Pfad | Inhalt |
|---|---|
| `App/` | App-Target: Einstieg, Hauptfenster, String Catalog |
| `Packages/MusubiKit/` | Module `MusubiCore`, `NDIKit` (+ `CNDI`-Modulemap), `VideoOutput`, `AudioMatrix`, `DesignSystem` |
| `design/Theme.swift` | Design-Tokens; im Package als Symlink eingebunden |
| `project.yml` | XcodeGen-Projektdefinition |

## Voraussetzungen

- Xcode (aktuell), macOS auf Apple Silicon zum Entwickeln
- NDI SDK für macOS (nicht im Repo, siehe [Vendor/README.md](Vendor/README.md))
- Zielgeräte: MacBook (Apple Silicon) und Mac mini 2018 (Intel, macOS 15) → Universal Build

© Zielke Studio