Open Sound Control (OSC)
Steuern Sie DMXDesktop remote mit dem OSC-Protokoll
Was ist OSC?
Open Sound Control (OSC) ist ein Protokoll für die Vernetzung von Klang-Synthesizern, Computern und anderen Multimedia-Geräten für Zwecke wie musikalische Darbietungen oder Showkontrolle. DMXDesktop implementiert OSC, um die Fernsteuerung von verschiedenen Geräten und Anwendungen zu ermöglichen.
So funktioniert es
DMXDesktop betreibt einen OSC-Server, der auf eingehende Nachrichten hört. Diese Nachrichten können verschiedene Aspekte der Software steuern, von grundlegenden Funktionen wie der Steuerung des Hauptdimmers bis hin zu komplexen Effekt-Auslösungen. Der Server unterstützt sowohl UDP- als auch TCP-Protokolle, wobei UDP am häufigsten verwendet wird.
Erste Schritte
- Öffnen Sie DMXDesktop und navigieren Sie zu Einstellungen → Allgemein
- Im OSC-Bereich finden Sie:
- OSC aktivieren/deaktivieren Umschalter
- Netzwerkschnittstellenauswahl (wählen Sie Ihre bevorzugte Netzwerkschnittstelle)
- Portnummer (Standard: 8000)
- Protokollauswahl (UDP/TCP)
- 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 vieler verschiedener Arten 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
Zusätzliche Ressourcen
- Offizielle OSC-Website - Erfahren Sie mehr über das OSC-Protokoll
- TouchOSC-Dokumentation - Detaillierte Anleitung für TouchOSC
- OSC-Protokollspezifikation - Technische Details zum OSC-Protokoll
OSC Eingabebefehle
Send these commands to DMXDesktop to control your lighting. All paths are case-sensitive.
| OSC Pfad | Parameter | Beschreibung |
|---|---|---|
| MASTER CONTROLS | ||
| /master/dimmer | float (0-1) | Steuert die Intensität des Master-Dimmers |
| LIVE EFFECTS | ||
| /live/strobe/{on|off|pulse} | none | Steuert den Strobe-Zustand |
| /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 |
| SPECIAL EFFECTS | ||
| /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 EDITS | ||
| /live/edit/{action}/{name} | action: enable|disable|toggle | Steuert den Live-Edit-Zustand nach Name |
| /live/edit/group/{action}/{name} | action: enable|disable|toggle | Steuert den Live-Edit-Gruppenzustand nach Name |
| /live/edit/disable-all | none | Deaktiviert alle Live-Edits |
| CUE CONTROLS | ||
| /cue/effect/play/{name} | string | Spielt spezifischen Effekt-Cue nach Name |
| /cue/effect/{action} | play|stop|next|prev | Steuert die Navigation der Effekt-Cue-Wiedergabe |
| DJ CONTROLS | ||
| /dj/app/{app} | musicplayer|virtualdj|traktor | Wechselt die spezifische DJ-Anwendung |
| /dj/deck{1|2}/{action} | play|stop|eject | Deck-Transportsteuerungen |
| /dj/deck{1|2}/volume | float (0-1) | Steuert die Deck-Lautstärke |
| /dj/crossfader | float (0-1) | Steuert die Position des Crossfaders |
| DIRECT DMX CONTROL | ||
| /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 |
OSC Ausgabemeldungen
DMXDesktop sendet 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-Steuerungen
/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 value)/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 (energy level)Effect Cues
/dmxdesktop/v1/cue/active string (cue name or "")/dmxdesktop/v1/cue/name string (current 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 (next cue name)Live-Edits & Overrides
/dmxdesktop/v1/liveedit/{id} int 0|1/dmxdesktop/v1/liveedit/group/{id} int 0|1/dmxdesktop/v1/override/color string (palette ID or "")/dmxdesktop/v1/override/position string (preset or "")DJ Mode
/dmxdesktop/v1/dj/enabled int 0|1/dmxdesktop/v1/dj/app string (app name or "")/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 (Artist - Title)/dmxdesktop/v1/dj/deck{1-4}/loaded int 0|1 (track loaded)/dmxdesktop/v1/dj/deck{1-4}/loading int 0|1 (analyzing)/dmxdesktop/v1/dj/deck{1-4}/showready int 0|1 (DMX show ready)/dmxdesktop/v1/dj/deck{1-4}/vu float (VU meter level)QuickShow - Beam Effects
/dmxdesktop/v1/quickshow/beam string (effect name or "")/dmxdesktop/v1/quickshow/beam/speed int (raw slider value)/dmxdesktop/v1/quickshow/beam/phase int (raw slider value)/dmxdesktop/v1/quickshow/beam/background int (raw slider value)/dmxdesktop/v1/quickshow/beam/spread int (raw slider value)/dmxdesktop/v1/quickshow/beam/intensity int (raw slider value)QuickShow - Bewegungseffekte
/dmxdesktop/v1/quickshow/move string (effect name or "")/dmxdesktop/v1/quickshow/move/speed int (raw slider value)/dmxdesktop/v1/quickshow/move/size int (raw slider value)/dmxdesktop/v1/quickshow/move/phase int (raw slider value)/dmxdesktop/v1/quickshow/move/fanning int (raw slider value)/dmxdesktop/v1/quickshow/move/direction int -1|0|1QuickShow - Allgemein
/dmxdesktop/v1/quickshow/theme int (theme ID)/dmxdesktop/v1/quickshow/themecount int (8|16|24|32)/dmxdesktop/v1/quickshow/preset string (preset ID or "")/dmxdesktop/v1/quickshow/groups string (JSON array)/dmxdesktop/v1/quickshow/groups/move string (JSON array)/dmxdesktop/v1/quickshow/stopall int 1 (pulse event)QuickShow - Encoder
/dmxdesktop/v1/quickshow/encoder/beam/{id} int 0-255 (DMX value)/dmxdesktop/v1/quickshow/encoder/move/{id} int 0-255 (DMX value)Encoder-IDs haben das Format: beam_aux_{groupId}_{channelKey} oder move_aux_{groupId}_{channelKey}
Hinweis: OSC-Ausgabe erfordert ein kostenpflichtiges Abonnement und muss in den Einstellungen aktiviert werden. Standardport ist 9000.
Beat-Zeitstempel werden in zwei 32-Bit-Integer (ts_high, ts_low) aufgeteilt, da OSC keine 64-Bit-Werte unterstützt.