Erste Schritte
Kein Terminal, kein Python, kein Server nötig — NYX ist in wenigen Minuten einsatzbereit.
Was du brauchst
- Vectorworks 2025 oder 2026 mit Spotlight-Lizenz
- NYX Installer (
.dmgfür macOS /Setup.exefür Windows) - NYX Lizenzschlüssel
Installer und Lizenzschlüssel werden in der Beta-Phase per E-Mail zugestellt — Anfrage an lightinch@me.com
NYX Launcher installieren
macOS
- Öffne die heruntergeladene
.dmg-Datei - Ziehe NYX Launcher in den Programme-Ordner
- Beim ersten Start: Rechtsklick → Öffnen → „Trotzdem öffnen"
Windows
- Führe
NYX Setup.exeaus - Folge dem Installer (einfach „Weiter" klicken)
- NYX Launcher über Desktop-Icon oder Startmenü starten
Lizenz aktivieren
Beim ersten Start erscheint ein Aktivierungsdialog. Lizenzschlüssel einfügen → Aktivieren. Der Schlüssel wird lokal gespeichert und muss nicht erneut eingegeben werden.
Erstes Projekt anlegen
Im Launcher: Tab Projekt → Neue Datenbank anlegen → Speicherort und Name wählen (z. B. Tournee2026.db). Die Datenbank ist sofort aktiv.
VW Plugin einrichten (einmalig, empfohlen)
Das Plugin ermöglicht Sync und Write-Back direkt aus dem Vectorworks-Menü — Installation dauert ca. eine Minute.
- NYX Launcher → Tab Setup → Plugin-Paket speichern → Speicherort wählen (z. B. Desktop)
- In Vectorworks: Extras → Plug-ins → Plug-in-Manager
- Tab „Plug-ins von Drittherstellern" → gespeicherte
NYX_VW_Plugins.zipauswählen → OK - Vectorworks neu starten — die NYX-Menübefehle sind danach verfügbar
Tägliche Nutzung
- Sync: In Vectorworks Menü → NYX → NYX Sync to DB ausführen — NYX lädt die Daten automatisch
- Bearbeiten: Fixtures-Tab (Übersicht), FS-Tab (Distro-Zuweisung, Phasen), Setup → Distro Builder (Verteilertypen)
- Write-Back: Menü → NYX → NYX Write-Back — schreibt Plugbox, Plugplatz, Abstand zum Nullpunkt zurück in VW
Änderungen werden automatisch gespeichert. PDF-Export und Etikettendruck funktionieren auch ohne laufendes Vectorworks.
VW-Datenaustausch — Felder im Überblick
NYX liest beim Sync direkt aus Vectorworks-Spotlight-Objekten und schreibt beim Write-Back gezielt zurück.
NYX liest aus Vectorworks
| VW-Feld | Bedeutung |
|---|---|
| Inst Type | Gerätetyp / Scheinwerferbezeichnung |
| Channel | Fix ID (Pultkanal) |
| Position | Hängeposition |
| Circuit Name | Plugbox (z. B. A1) |
| Circuit Number | Plugplatz (z. B. /3) |
| Wattage | Leistung in Watt (für Phasenlast) |
| Universe / DMX Address / Num Channels | DMX-Patch |
| User Field 1 | DMX Mode (frei belegbar in VW) |
| User Field 2 | DMX Linie |
| User Field 5 | NYX-interne UUID (Merge-Key, wird beim Write-Back gesetzt) |
| GDTF Fixture Mode | Mode aus GDTF-Import (alternativ zu User Field 1) |
NYX schreibt zurück in Vectorworks
| VW-Feld | Was NYX einträgt |
|---|---|
| Circuit Name | Plugbox aus der Distro-Zuweisung |
| Circuit Number | Plugplatz aus der Distro-Zuweisung |
| User Field 5 | NYX UUID (Self-Healing — wird beim ersten Write-Back angelegt) |
| User Field 6 | Kabelstrecke zum Nullpunkt in Metern (Bem_Kordm) |
Felder die NYX nicht kennt (z. B. User Field 3–4) werden beim Write-Back nicht verändert.
Probleme?
| Problem | Lösung |
|---|---|
| Keine Daten im NYX Launcher | Erst Sync in VW ausführen — das Frontend lädt danach automatisch neu |
| VW-Skript zeigt keinen Datei-Dialog | Pfad wird automatisch aus ~/.lpm_active_db.json gelesen — kein Dialog nötig |
VW-Skript: AttributeError: vs has no attribute GetFPathname |
Bekanntes VW 2025-Problem — sicherstellen dass die aktuellen .py-Dateien installiert sind |
| macOS: „App kann nicht geöffnet werden" | Rechtsklick auf NYX Launcher → Öffnen → „Trotzdem öffnen" |
Weitere Fragen? lightinch@me.com