--- title: "Open Sound Control (OSC) für DMXDesktop" lang: en source: /de/open-sound-control --- # 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 1. Öffnen Sie DMXDesktop und navigieren Sie zu **Einstellungen → Allgemein** 2. 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) 3. 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.* 1. Laden Sie TouchOSC auf Ihr Gerät herunter und installieren Sie es: - iOS: App Store - Android: [Google Play](https://play.google.com/store/apps/details?id=net.hexler.lex&hl=en) - Desktop: Desktop 2. Ö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) 3. Verwenden Sie die Entdeckungsfunktion in TouchOSC, um DMXDesktop automatisch in Ihrem Netzwerk zu finden 4. 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 Sie diese Befehle an DMXDesktop, um Ihre Beleuchtung zu steuern. Alle Pfade sind groß- und kleinschreibungsempfindlich. | OSC Pfad | Parameter | Beschreibung | | --- | --- | --- | | MASTER STEUERUNGEN | | | | /master/dimmer | float (0-1) | Steuert die Intensität des Master-Dimmers | | LEBENDE EFFEKTE | | | | /live/strobe/{on|off|pulse} | keine | Steuert den Zustand des Stroboskoplichts | | /live/blackout/{on|off|pulse} | keine | Steuert den Zustand des Blackouts | | /live/blinder/{on|off|pulse} | keine | Steuert den Zustand des Blinders | | /live/freeze/{on|off|pulse} | keine | Steuert den Zustand des Freeze | | /live/fog/{on|off|pulse} | keine | Steuert den Zustand der Nebelmaschine | | SPEZIAL EFFEKTE | | | | /effects/{effect}/start | keine | Startet den angegebenen Effekt (Welle, Paparazzi, Farbenwechsel, Donner, Puls, Funkeln, Zufall) | | /effects/{effect}/stop | keine | Stoppt den angegebenen Spezialeffekt | | /effects/stop | keine | Stoppt alle aktuell laufenden Spezialeffekte | | /effects/bpm | float (0-1) | Setzt BPM für die Zeitsteuerung der Spezialeffekte (ordnet 0-1 auf 60-200 BPM zu) | | LIVE BEARBEITUNGEN | | | | /live/edit/{action}/{name} | action: enable|disable|toggle | Steuert den Zustand der Live-Bearbeitung nach Name | | /live/edit/group/{action}/{name} | action: enable|disable|toggle | Steuert den Zustand der Live-Bearbeitungsgruppe nach Name | | /live/edit/disable-all | keine | Deaktiviert alle Live-Bearbeitungen | | CUE STEUERUNGEN | | | | /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 STEUERUNGEN | | | | /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 | | DIREKTE DMX STEUERUNG | | | | /dmx/{universe}/{channel} | float (0-1) | Setzt den DMX-Kanalwert (ordnet 0-1 auf 0-255 zu) | | /dmx/{universe}/{channel}/clear | keine | Löscht die DMX-Kanal-Übersteuerung | | /dmx/clear | keine | Löscht ALLE DMX-Kanal-Übersteuerungen | | STACK STEUERUNGEN | | | | /stack/{id}/go | keine | Feuert den nächsten Cue im angegebenen Stack | | /stack/{id}/back | keine | Geht zurück zum vorherigen Cue | | /stack/{id}/halt | keine | Stoppt den aktuellen Crossfade mitten im Übergang | | /stack/{id}/stop | keine | Stoppt die Wiedergabe im angegebenen Stack | | /stack/{id}/level | float (0-1) | Setzt die Master-Ebene des Stacks | | EXECUTE GRID | | | | /execute/{row}/{col} | keine | 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|1 ### Live-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|1 ### QuickShow - 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. ## Bereit, Ihre Lichter aus der Ferne zu steuern? DMXDesktop herunterladen