Open Sound Control (OSC)
Senden Sie Befehle an DMXDesktop und empfangen Sie Statusübertragungen über OSC
Was ist OSC?
Open Sound Control (OSC) ist ein Protokoll zur Vernetzung von Klangsynthetisierern, Computern und anderen Multimedia-Geräten für Zwecke wie musikalische Darbietungen oder Showkontrolle. DMXDesktop implementiert OSC für die bidirektionale Kommunikation – empfangen Sie Befehle von externen Controllern und übertragen Sie Statusänderungen an andere Anwendungen.
So funktioniert es
DMXDesktop unterstützt sowohl OSC-Eingang als auch -Ausgang. Der OSC Input Server lauscht auf eingehende Nachrichten, um verschiedene Aspekte der Software zu steuern. OSC Output überträgt Statusänderungen und Ereignisse an externe Anwendungen, was eine Echtzeitsynchronisation mit Videosoftware, Visualisierern und benutzerdefinierten Integrationen ermöglicht. Beide unterstützen das UDP-Protokoll für eine latenzarme Kommunikation.
Erste Schritte
- Öffnen Sie DMXDesktop und navigieren Sie zu Einstellungen → Allgemein
- Im OSC-Bereich finden Sie:
- Aktivieren/Deaktivieren des OSC Input-Buttons
- Auswahl der Netzwerk-Schnittstelle
- Portnummer für den Eingang (Standard: 8000)
- Protokollauswahl (UDP/TCP)
- Aktivieren/Deaktivieren des OSC Output-Buttons
- Ausgabe-Host und Port (Standard: 127.0.0.1:9000)
- Der Entdeckungsdienst läuft auf Port 9000 und ermöglicht es kompatiblen Apps, DMXDesktop automatisch im Netzwerk zu finden
Verbindung mit TouchOSC
TouchOSC ist ein beliebtes Tool zur Steuerung einer Vielzahl von Anwendungen und kann verwendet werden, um DMXDesktop über das OSC-Protokoll zu steuern.
Bitte beachten Sie: TouchOSC ist kostenpflichtige Software, bitte besuchen Sie die offizielle Website für Details.
- Laden Sie TouchOSC auf Ihr Gerät herunter und installieren Sie es:
- iOS: App Store
- Android: Google Play
- Desktop: Desktop
- Öffnen Sie TouchOSC und erstellen Sie eine neue Verbindung:
- Protokoll: OSC
- Host: Die IP-Adresse Ihres Computers (angezeigt in den DMXDesktop-Einstellungen)
- Sendepot: 8000 (Standard)
- Empfangsport: 9000 (für den Entdeckungsdienst)
- Verwenden Sie die Entdeckungsfunktion in TouchOSC, um DMXDesktop automatisch in Ihrem Netzwerk zu finden
- Erstellen Sie Ihr Layout mit den OSC-Pfaden, die in der Tabelle unten aufgeführt sind
Netzwerktipps
- Stellen Sie sicher, dass Ihr Gerät und Computer im selben Netzwerk sind
- Wenn Sie eine Firewall verwenden, erlauben Sie eingehende Verbindungen auf den Ports 8000 und 9000
- Für optimale Leistung verwenden Sie ein dediziertes Netzwerk oder eine 5GHz-WLAN-Verbindung
- Für OSC Output konfigurieren Sie die Ziel-Host-IP und den Port in den Einstellungen
Zusätzliche Ressourcen
- Offizielle OSC-Website - Erfahren Sie mehr über das OSC-Protokoll
- TouchOSC-Dokumentation - Detaillierte Anleitung für TouchOSC
- OSC-Protokollspezifikation - Technische Details des OSC-Protokolls
OSC-Eingabebefehle
Send these commands to DMXDesktop to control your lighting. All paths are case-sensitive.
| OSC-Pfad | Parameter | Beschreibung |
|---|---|---|
| MASTER-KONTROLLEN | ||
| /master/dimmer | float (0-1) | Steuert die Intensität des Master-Dimmers |
| LIVE-EFFEKTE | ||
| /live/strobe/{on|off|pulse} | none | Steuert den Stroboskopzustand |
| /live/blackout/{on|off|pulse} | none | Steuert den Blackout-Zustand |
| /live/blinder/{on|off|pulse} | none | Steuert den Blinder-Zustand |
| /live/freeze/{on|off|pulse} | none | Steuert den Freeze-Zustand |
| /live/fog/{on|off|pulse} | none | Steuert den Zustand der Nebelmaschine |
| SPEZIAL-EFFEKTE | ||
| /effects/{effect}/start | none | Startet den angegebenen Effekt (wave, paparazzi, colorsweep, thunder, pulse, sparkle, random) |
| /effects/{effect}/stop | none | Stoppt den angegebenen Spezialeffekt |
| /effects/stop | none | Stoppt alle derzeit laufenden Spezialeffekte |
| /effects/bpm | float (0-1) | Setzt BPM für die Zeitsteuerung der Spezialeffekte (mappt 0-1 auf 60-200 BPM) |
| LIVE-ÄNDERUNGEN | ||
| /live/edit/{action}/{name} | action: enable|disable|toggle | Steuert den Zustand der Live-Änderung nach Name |
| /live/edit/group/{action}/{name} | action: enable|disable|toggle | Steuert den Zustand der Live-Änderungsgruppe nach Name |
| /live/edit/disable-all | none | Deaktiviert alle Live-Änderungen |
| CUE-KONTROLLEN | ||
| /cue/effect/play/{name} | string | Spielt den spezifischen Effekt-Cue nach Name |
| /cue/effect/{action} | play|stop|next|prev | Steuert die Wiedergabenavigation des Effekt-Cues |
| DJ-KONTROLLEN | ||
| /dj/app/{app} | musicplayer|virtualdj|traktor | Wechselt die spezifische DJ-Anwendung |
| /dj/deck{1|2}/{action} | play|stop|eject | Deck-Transportkontrollen |
| /dj/deck{1|2}/volume | float (0-1) | Steuert die Deck-Lautstärke |
| /dj/crossfader | float (0-1) | Steuert die Position des Crossfaders |
| DIREKTE DMX-KONTROLLE | ||
| /dmx/{universe}/{channel} | float (0-1) | Setzt den DMX-Kanalwert (mappt 0-1 auf 0-255) |
| /dmx/{universe}/{channel}/clear | none | Löscht die DMX-Kanalübersteuerung |
| /dmx/clear | none | Löscht ALLE DMX-Kanalübersteuerungen |
| STACK-KONTROLLEN | ||
| /stack/{id}/go | none | Feuert den nächsten Cue im angegebenen Stack |
| /stack/{id}/back | none | Geht zurück zum vorherigen Cue |
| /stack/{id}/halt | none | Hält den aktuellen Crossfade während des Übergangs an |
| /stack/{id}/stop | none | Stoppt die Wiedergabe im angegebenen Stack |
| /stack/{id}/level | float (0-1) | Setzt das Stack-Master-Level |
| EXECUTE GRID | ||
| /execute/{row}/{col} | none | Auslösen des Execute-Grid-Buttons an der angegebenen Position |
OSC-Ausgabemeldungen
DMXDesktop überträgt Status und Ereignisse an externe Anwendungen über OSC. Konfigurieren Sie den Zielhost und den Port in den Einstellungen. Verfügbar ab v1.0.46
Live-Kontrollen
/dmxdesktop/v1/master float 0-1 (0-100%)/dmxdesktop/v1/blackout int 0|1/dmxdesktop/v1/strobe int 0|1/dmxdesktop/v1/blinder int 0|1/dmxdesktop/v1/freeze int 0|1/dmxdesktop/v1/fog int 0|1/dmxdesktop/v1/effect int 0|1/dmxdesktop/v1/specialeffect/{name} int 0|1 (wave, thunder, etc.)Audio & BPM
/dmxdesktop/v1/bpm float (BPM-Wert)/dmxdesktop/v1/beat float, int, int, float (bpm, ts_high, ts_low, confidence)/dmxdesktop/v1/audio/level float 0-1 (RMS-Level)/dmxdesktop/v1/audio/energy float 0-1 (Energielevel)Effect Cues
/dmxdesktop/v1/cue/active string (Cue-Name oder "")/dmxdesktop/v1/cue/name string (aktueller Cue)/dmxdesktop/v1/cue/action string (play|stop)/dmxdesktop/v1/cue/lifecycle string (fadeIn/OutStarted/Finished)/dmxdesktop/v1/cue/lifecycle/duration int (ms)/dmxdesktop/v1/cue/lifecycle/newCue string (nächster Cue-Name)Cue-Stapel
/dmxdesktop/v1/stack/{id}/step int (Schrittindex)/dmxdesktop/v1/stack/{id}/fading int 0|1/dmxdesktop/v1/stack/{id}/paused int 0|1Live-Bearbeitungen & Überschreibungen
/dmxdesktop/v1/liveedit/{id} int 0|1/dmxdesktop/v1/liveedit/group/{id} int 0|1/dmxdesktop/v1/override/color string (Palette-ID oder "")/dmxdesktop/v1/override/position string (Preset oder "")DJ Mode
/dmxdesktop/v1/dj/enabled int 0|1/dmxdesktop/v1/dj/app string (App-Name oder "")/dmxdesktop/v1/dj/master int 1-4 (Master-Deck)/dmxdesktop/v1/dj/crossfader float 0-1/dmxdesktop/v1/dj/deck{1-4}/playing int 0|1/dmxdesktop/v1/dj/deck{1-4}/paused int 0|1/dmxdesktop/v1/dj/deck{1-4}/track string (Künstler - Titel)/dmxdesktop/v1/dj/deck{1-4}/loaded int 0|1 (Track geladen)/dmxdesktop/v1/dj/deck{1-4}/loading int 0|1 (analysiere)/dmxdesktop/v1/dj/deck{1-4}/showready int 0|1 (DMX-Show bereit)/dmxdesktop/v1/dj/deck{1-4}/vu float (VU-Meter-Level)QuickShow - Beam Effects
/dmxdesktop/v1/quickshow/beam string (Effektname oder "")/dmxdesktop/v1/quickshow/beam/speed int (roher Schiebereglerwert)/dmxdesktop/v1/quickshow/beam/phase int (roher Schiebereglerwert)/dmxdesktop/v1/quickshow/beam/background int (roher Schiebereglerwert)/dmxdesktop/v1/quickshow/beam/spread int (roher Schiebereglerwert)/dmxdesktop/v1/quickshow/beam/intensity int (roher Schiebereglerwert)QuickShow - Bewegungseffekte
/dmxdesktop/v1/quickshow/move string (Effektname oder "")/dmxdesktop/v1/quickshow/move/speed int (roher Schiebereglerwert)/dmxdesktop/v1/quickshow/move/size int (roher Schiebereglerwert)/dmxdesktop/v1/quickshow/move/phase int (roher Schiebereglerwert)/dmxdesktop/v1/quickshow/move/fanning int (roher Schiebereglerwert)/dmxdesktop/v1/quickshow/move/direction int -1|0|1QuickShow - Allgemein
/dmxdesktop/v1/quickshow/theme int (Thema-ID)/dmxdesktop/v1/quickshow/themecount int (8|16|24|32)/dmxdesktop/v1/quickshow/preset string (Preset-ID oder "")/dmxdesktop/v1/quickshow/groups string (JSON-Array)/dmxdesktop/v1/quickshow/groups/move string (JSON-Array)/dmxdesktop/v1/quickshow/stopall int 1 (Pulse-Ereignis)QuickShow - Encoder
/dmxdesktop/v1/quickshow/encoder/beam/{id} int 0-255 (DMX-Wert)/dmxdesktop/v1/quickshow/encoder/move/{id} int 0-255 (DMX-Wert)Encoder-IDs haben das Format: beam_aux_{groupId}_{channelKey} oder move_aux_{groupId}_{channelKey}
Hinweis: OSC Output erfordert ein kostenpflichtiges Abonnement und muss in den Einstellungen aktiviert werden. Der Standardport ist 9000.
Beat-Zeitstempel werden in zwei 32-Bit-Ganzzahlen (ts_high, ts_low) aufgeteilt, da OSC keine 64-Bit-Werte unterstützt.