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 bekommst du auf Anfrage per E-Mail — kurze Nachricht an info@nyxlightwork.com
NYX installieren
macOS
- Öffne die heruntergeladene
.dmg-Datei - Ziehe NYX in den Programme-Ordner
- Beim ersten Start: Rechtsklick → Öffnen → „Trotzdem öffnen"
Windows
- Führe
NYX Setup.exeaus - Folge dem Installer (einfach „Weiter" klicken)
- NYX ü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
Tab Projekt → Neue Datenbank anlegen → Speicherort und Name wählen (z. B. Tournee2026.db). Das Projekt ist sofort aktiv. NYX fragt dabei gleich nach der Austauschdatei aus Schritt 05 — mit Später trägst du sie nachträglich im Setup ein.
Bestehende Fixture-Listen lassen sich im selben Tab auch aus einer CSV- oder MVR-Datei importieren.
Vectorworks verbinden — über die Austauschdatei (empfohlen)
Vectorworks kann selbst eine Austauschdatei neben die Zeichnung legen, ursprünglich für Lightwright gedacht. NYX liest und schreibt diese Datei — ganz ohne Plug-in, und mit jedem Feld, das du in Vectorworks zum Export auswählst.
- In Vectorworks: Dokument-Einstellungen ▸ Spotlight ▸ Lightwright → „Automatischen Datenaustausch mit Lightwright verwenden“ einschalten und die Felder wählen, die NYX sehen soll
- Für DMX-Adressen müssen Universum, DMX-Adresse, Universum/Adresse und Absolute Adresse dabei sein — „Eigen Adresse“ und „Eigen U Adresse“ dürfen es nicht
- Einen vollständigen Export von Hand auslösen, unter Spotlight-Einstellungen ▸ Lightwright
- In NYX: Tab Setup → Reiter Vectorworks → VW-Austauschdatei wählen → Prüfen → Übernehmen
Die Austauschdatei gehört zum Projekt: jedes Projekt merkt sich seine eigene, beim Projektwechsel wechselt der Abgleich mit. Was NYX nach Vectorworks schreibt, übernimmt Vectorworks, sobald du das nächste Mal in das Programm wechselst.
VW Plug-in einrichten (optional)
Der ältere Weg: Sync und Write-Back als Befehle im Vectorworks-Menü. Nötig ist er nur noch, wenn du ihn gewohnt bist oder Geräte abgleichen willst, die keine Scheinwerfer sind — die Austauschdatei kennt nur Scheinwerfer.
- NYX → Tab Setup → Reiter Vectorworks → 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
- Einlesen: Klick auf den goldenen Punkt VW-Sync oben rechts — NYX zeigt, was sich ändert, und liest nach Übernehmen ein. Mit Plug-in: in Vectorworks Menü → NYX → NYX Sync to DB
- Bearbeiten: Datapool für die Fixture-Übersicht, Power für Distro, Dimmer und Phasenlast, DMX für Liste, Patch, System und Fixture-Typen, dazu LaKa, Dimmercity, Rigging, Live und Briefing
- Zurückschreiben: Übernehmen im DMX Patch und → Nach Vectorworks im Distro und Dimmer schreiben direkt in die Austauschdatei; geänderte Datapool-Felder schickt zurückschreiben unter Setup → VW-Austauschdatei los. Mit Plug-in: Menü → NYX → NYX Write-Back
Änderungen werden automatisch gespeichert. PDF-Export und Etikettendruck funktionieren auch ohne laufendes Vectorworks.
Wer nicht von Hand einlesen will, schaltet im Setup den Live-Sync ein Experimentell: NYX liest und schreibt die Austauschdatei dann von selbst, solange der Punkt VW-Sync grün pulsiert. Einen vollständigen Export übernimmt er nie selbsttätig. Die Funktion ist neu — Rückmeldungen dazu sind besonders willkommen.
Updates
NYX prüft selbst, ob eine neue Version vorliegt, und meldet sich mit einer Übersicht der Änderungen. Ein Klick lädt und installiert sie — dein Lizenzschlüssel und alle Projekte bleiben unverändert.
Bringt ein Update auch eine neue Fassung der Vectorworks-Plugins mit, weisen die Versionshinweise darauf hin. Dann Schritt 06 einmal wiederholen.
VW-Datenaustausch — Felder im Überblick
Über die Austauschdatei sieht NYX jedes Feld, das du in Vectorworks zum Export auswählst — rund 75 je Scheinwerfer. Diese hier braucht NYX für seine eigenen Tabs; das Plug-in liest genau sie.
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-Kennung des Fixtures (wird beim Write-Back gesetzt) |
| GDTF Fixture Mode | Mode aus GDTF (alternativ zu User Field 1) |
NYX schreibt zurück in Vectorworks
| VW-Feld | Was NYX einträgt |
|---|---|
| Circuit Name | Plugbox aus der Zuweisung |
| Circuit Number | Plugplatz aus der Zuweisung |
| Breaker ID | Sicherungsnummer, von NYX berechnet |
| User Field 5 | NYX-Kennung (wird beim ersten Write-Back angelegt) |
| User Field 6 | Kabelstrecke zum Nullpunkt in Metern |
| Universe / DMX Address | DMX-Adresse aus dem DMX Patch — nur über die Austauschdatei, mit Universum/Adresse und Absoluter Adresse |
| Channel, Focus, User Field 1–6 | Was du im Datapool änderst — nur über die Austauschdatei und nur, wenn im Setup freigegeben |
| weitere Felder | Zusatzfelder aus der Exportauswahl, die du im Setup auf „zurückschreiben“ stellst — nur über die Austauschdatei |
Alle übrigen Felder lässt NYX unangetastet. Den DMX-Mode schreibt NYX nie zurück — Vectorworks übernimmt ihn aus der Austauschdatei nicht. Welche VW-Felder für DMX-Mode, DMX-Linie und Kennung genutzt werden, lässt sich im Setup umstellen.
Probleme?
| Problem | Lösung |
|---|---|
| Keine Daten in NYX | Erst einlesen: Austauschdatei im Setup wählen und Prüfen → Übernehmen, oder mit Plug-in den Sync in VW ausführen |
| DMX-Adressen kommen in Vectorworks nicht an | Exportauswahl in Vectorworks prüfen: Universum, DMX-Adresse, Universum/Adresse und Absolute Adresse müssen drin sein (Schritt 05). Vectorworks übernimmt erst, wenn du in das Programm wechselst |
| Setup zeigt ein rotes Band, NYX schreibt nichts zurück | Das Dokument exportiert „Eigen Adresse“ oder „Eigen U Adresse“. Vectorworks würde damit DMX-Adressen löschen — beide Felder unter Spotlight-Einstellungen ▸ Lightwright ▸ Export Fields abwählen, neu exportieren, neu einlesen. Vorgemerkte Änderungen bleiben stehen |
| „Vectorworks hat gerade in die Datei geschrieben. Bitte noch einmal.“ | Vectorworks schrieb im selben Moment. Ein zweiter Klick genügt |
| VW-Skript zeigt keinen Datei-Dialog | Der Pfad zum aktiven Projekt wird automatisch ermittelt — ein Dialog ist nicht nötig |
VW-Skript: AttributeError: vs has no attribute GetFPathname |
Bekanntes VW-2025-Problem — sicherstellen, dass die aktuelle Fassung der NYX-Plugins installiert ist (Schritt 06) |
| macOS: „App kann nicht geöffnet werden" | Rechtsklick auf NYX → Öffnen → „Trotzdem öffnen" |
| Windows: Eingabefelder nehmen keine Tastatureingabe mehr an | Einmal in ein Eingabefeld klicken — der Zustand behebt sich damit, ein Neustart ist nicht nötig |
Weitere Fragen? Ein Blick in die FAQ oder eine Mail an info@nyxlightwork.com