Hilfe & Dokumentation

Vollständiges Benutzerhandbuch für DMX TimeCode Player

📖 Inhaltsverzeichnis

🚀 Erste Schritte

DMX TimeCode Player ist ein professioneller Medienplayer für Lichtdesigner. Er sendet SMPTE Timecode über Art-Net während der Wiedergabe von Audio- oder Videodateien und ermöglicht so eine framegenaue Synchronisation mit Ihrem Lichtpult.

Schnellstart

  1. Laden Sie den DMX TimeCode Player herunter und installieren Sie ihn
  2. Starten Sie die Anwendung
  3. Ziehen Sie Ihre Mediendateien per Drag & Drop in die Playlist
  4. Konfigurieren Sie die Art-Net-Einstellungen (Universe, Subnet, Net)
  5. Drücken Sie Play — Timecode wird automatisch gesendet

💡 Tipp: Stellen Sie sicher, dass sich Ihr Lichtpult und der DMX TimeCode Player im selben Netzwerk befinden, um Timecode zu empfangen.

💻 Systemanforderungen

📦 Installation

  1. Laden Sie die DMG-Datei von der Website herunter
  2. Öffnen Sie die DMG-Datei
  3. Ziehen Sie "DMX TimeCode Player" in Ihren Programme-Ordner
  4. Beim ersten Start: Rechtsklick auf die App und "Öffnen" wählen (erforderlich für nicht signierte Apps)
  5. Falls aufgefordert, gehen Sie zu Systemeinstellungen → Datenschutz & Sicherheit und klicken Sie auf "Dennoch öffnen"

⚠️ Wichtig: Die App ist nicht notarisiert. macOS zeigt möglicherweise eine Warnung beim ersten Start. Dies ist normal für Indie-Software.

🖥️ Benutzeroberfläche

Das Hauptfenster ist in mehrere Bereiche unterteilt:

Player-Steuerung

Timecode-Anzeige

Zeigt die aktuelle Position im Format HH:MM:SS:FF (Stunden:Minuten:Sekunden:Frames). Die Framerate kann in den Einstellungen auf 24, 25 oder 30 fps eingestellt werden.

Playlist

⏱️ Art-Net Timecode

Die Anwendung sendet SMPTE Timecode über das Art-Net-Protokoll. Dies ermöglicht Ihrem Lichtpult, Cues zu präzisen Zeitpunkten während der Wiedergabe auszulösen.

Konfiguration

Pult-Einrichtung

An Ihrem Lichtpult:

  1. Aktivieren Sie den Art-Net Timecode Eingang
  2. Stellen Sie dieselbe Framerate wie im DMX TimeCode Player ein
  3. Erstellen Sie Timecode-Trigger für Ihre Cues

💡 Unterstützte Pulte: grandMA, Onyx, Hog, Chamsys, ETC Eos und jedes Pult mit Art-Net Timecode Unterstützung.

🎛️ DMX-Steuerung

Steuern Sie den Player von Ihrem Lichtpult über Art-Net oder sACN DMX-Eingang.

DMX-Modi

Protokoll-Einstellungen

📋 DMX-Kanalbelegung

Dieser Abschnitt bietet detaillierte DMX-Kanalinformationen für alle drei Betriebsmodi. Wählen Sie den Modus, der Ihren Anforderungen am besten entspricht.

📥 Geräteprofile für Ihr Lichtpult herunterladen:

Kompatibel mit Obsidian Onyx und anderen Pulten, die .Fixture-Dateien unterstützen.

🟢 Standard Mode (1 Kanal)

Grundlegende Wiedergabesteuerung mit Trackauswahl. Steuern Sie die Wiedergabe und wechseln Sie zwischen Tracks mit einem einzigen DMX-Kanal.

Kanal Funktion Wertebereich Beschreibung
1 Wiedergabesteuerung 0–255 0–5: Stopp (zum Anfang zurücksetzen)
6–10: Pause (aktuelle Position halten)
11–20: Spiele Track 1
21–30: Spiele Track 2
31–40: Spiele Track 3
...weiter in 10er Schritten...
231–240: Spiele Track 23
241–245: Spiele Track 24
246–255: Stopp

💡 Track Formel: Track-Nummer = floor((DMX-Wert - 11) / 10) + 1. Beispiel: DMX 25 spielt Track 2.

🟡 Loop Mode (2 Kanäle)

Fügt Loop-Zähler-Steuerung hinzu. Legen Sie fest, wie oft ein Track wiederholt werden soll, bevor er stoppt.

Kanal Funktion Wertebereich Beschreibung
1 Wiedergabesteuerung 0–255 0–5: Stopp
6–10: Pause
11–245: Spiele Track N (alle 10 Werte = nächster Track)
246–255: Stopp
2 Loop-Anzahl 0–255 0–9: Programmeinstellungen verwenden (kein DMX-Override)
10–19: Spiele 1×
20–29: Spiele 2×
30–39: Spiele 3×
...weiter in 10er Schritten...
100–109: Spiele 10×
110–255: Unendliche Schleife

💡 Loop Formel: Wiederholungsanzahl = floor((DMX-Wert - 10) / 10) + 1. Beispiel: DMX 45 spielt 4 mal.

🔴 Extended Mode (18 Kanäle)

Volle Kontrolle über alle Player-Funktionen einschließlich visueller Muster und Videoeffekte. Alle Effektkanäle verwenden Zonen: 0-4 = Kein Override, 5-9 = Reset auf Standard, 10-255 = Aktive Steuerung.

Kanal Funktion Werte Beschreibung
1 Wiedergabesteuerung 0–255 0–5: Stopp, 6–10: Pause
11–245: Spiele Track N, 246–255: Stopp
2 Loop-Anzahl 0–255 0–9: Programm verwenden, 10–109: 1×–10×, 110–255: Unendlich
3 Visuelles Muster 0–255 5–9: Schwarz (Standard), 10–255: Wähle Muster (alle 25 = nächstes Muster)
4 Muster-Geschwindigkeit 0–255 5–9: 1× (Standard), 10–255: 0.1× bis 3.0× Animationsgeschwindigkeit
5 Helligkeit 0–255 5–9: Normal (0), 10: -100%, 128: 0%, 255: +100%
6 Sättigung 0–255 5–9: 100% (Standard), 10: 0% (Graustufen), 255: 200%
7 Alpha (Deckkraft) 0–255 5–9: 100% (Standard), 10: 0% (transparent), 255: 100%
8 Wiedergabegeschwindigkeit 0–255 5–9: 1× (Standard), 10: 0.5×, 255: 2× Geschwindigkeit
9 RGB Ein/Aus 0–255 5–9: Alle an, 10+: Bit-Flags (R=1, G=2, B=4), 17+ = Alle an
10 Rot Zeitversatz 0–255 5–9: 0 Frames, 10–255: 0–25 Frames Verzögerung
11 Grün Zeitversatz 0–255 5–9: 0 Frames, 10–255: 0–25 Frames Verzögerung
12 Blau Zeitversatz 0–255 5–9: 0 Frames, 10–255: 0–25 Frames Verzögerung
13 Rot Horizontaler Versatz 0–255 5–9: Mitte, 10: -50px, 132: 0, 255: +50px
14 Rot Vertikaler Versatz 0–255 5–9: Mitte, 10–255: -50px bis +50px
15 Grün Horizontaler Versatz 0–255 5–9: Mitte, 10–255: -50px bis +50px
16 Grün Vertikaler Versatz 0–255 5–9: Mitte, 10–255: -50px bis +50px
17 Blau Horizontaler Versatz 0–255 5–9: Mitte, 10–255: -50px bis +50px
18 Blau Vertikaler Versatz 0–255 5–9: Mitte, 10–255: -50px bis +50px

⚠️ Hinweis: Videoeffekte (Kanäle 3–18) gelten nur, wenn die Videoausgabe aktiviert ist. Für reine Audiowiedergabe haben diese Kanäle keinen sichtbaren Effekt.

💡 3D-Effekt: Verwenden Sie RGB-Zeitversatz und Positionsversatz-Kanäle, um chromatische Aberration und Retro-3D-Anaglyphen-Effekte zu erzeugen!

📁 Geräteprofile

Laden Sie fertige Geräteprofile für Ihr Lichtpult herunter. Diese Profile ermöglichen es Ihnen, den DMX TimeCode Player wie ein Gerät zu patchen und direkt von Ihrem Pult aus zu steuern.

Verfügbare Profile

Profil Kanäle Beschreibung Download
V2 - Standard 1 Ch Grundlegende Wiedergabesteuerung (Play/Pause/Stopp) Download
V3.1 - Loop 2 Ch Wiedergabesteuerung + Loop-Zähler Download
V4.1 - Extended 18 Ch Volle Kontrolle mit Trackauswahl, Lautstärke und Videoeffekten Download

Installationsanleitung

Obsidian Onyx

  1. Laden Sie die .Fixture-Datei herunter
  2. Öffnen Sie Onyx und gehen Sie zu Patch → Add Fixtures
  3. Klicken Sie auf Import Fixture
  4. Wählen Sie die heruntergeladene .Fixture-Datei aus
  5. Patchen Sie das Gerät auf das gewünschte Universum und die Adresse

Andere Pulte

Das .Fixture-Format ist mit verschiedenen Lichtsoftwares kompatibel. Wenn Ihr Pult dieses Format nicht unterstützt, verwenden Sie die obigen DMX-Kanalbelegungen, um manuell ein Profil zu erstellen.

💡 Tipp: Stellen Sie sicher, dass der DMX-Modus in der Anwendung mit Ihrem Geräteprofil übereinstimmt. Gehen Sie zu Einstellungen → DMX → Modus und wählen Sie den entsprechenden Modus.

📱 Web-Interface

Steuern Sie den Player von jedem Gerät in Ihrem Netzwerk über einen Webbrowser.

Zugriff auf das Web-Interface

  1. Prüfen Sie die Web-Server-IP-Adresse im Einstellungsfenster
  2. Öffnen Sie einen Browser auf Ihrem Telefon, Tablet oder Computer
  3. Navigieren Sie zu http://[IP-ADRESSE]:8080

Verfügbare Funktionen

📺 Video-Ausgabe

Geben Sie Video auf einem zweiten Display im Vollbildmodus mit Echtzeiteffekten aus.

Einrichtung

  1. Schließen Sie ein zweites Display an Ihren Mac an
  2. Wählen Sie in den Einstellungen das Ausgabedisplay
  3. Aktivieren Sie "Video Output"
  4. Das Video erscheint im Vollbild auf dem gewählten Display

Videoeffekte

🔗 CITP Integration

Native Unterstützung für CITP (Controller Interface Transport Protocol) zur Integration mit unterstützten Lichtpulten.

Unterstützte Pulte

Funktionen

🔧 Fehlerbehebung

Pult empfängt keinen Timecode

Keine DMX-Steuerung

Video spielt nicht auf dem zweiten Display

App zeigt "beschädigt" beim ersten Start

Führen Sie diesen Befehl im Terminal aus:

xattr -cr "/Applications/DMX TimeCode Player.app"

🎭 Anwendungsfälle & Workflows

DMX TimeCode Player ist flexibel konzipiert. Hier sind die häufigsten Szenarien für die Integration des Players in Ihren Licht-Workflow.

🎧 Szenario 1: Manuelle Wiedergabe (DJ/Operator Steuerung)

Ideal für: Live-Events, bei denen ein DJ oder dedizierter Operator die Musik steuert.

Wie es funktioniert:

  • Das MacBook mit DMX TimeCode Player befindet sich am DJ-Pult oder beim Tontechniker
  • Aktivieren Sie "Manual Mode" (DMX-Eingang deaktivieren) in den Einstellungen
  • Der Operator wählt Tracks manuell aus und spielt sie ab
  • Wenn ein Track spielt, wird Timecode automatisch an das Lichtpult gesendet
  • Die Timecode-Cuelist des Lichtpults löst vorprogrammierte Cues aus

💡 Hauptmerkmal: Jeder Track beginnt mit einem eindeutigen Timecode-Offset (Track 1 = 00:00:00:00, Track 2 = 01:00:00:00, usw.). Das bedeutet, Ihr Lichtpult weiß automatisch, welcher Song gerade läuft und löst die richtige Show aus!

Einrichtungsschritte:

  1. Laden Sie alle Tracks in die Playlist (maximal 24 Tracks)
  2. Programmieren Sie Ihre Lichtcues auf spezifische Timecodes auf Ihrem Pult
  3. Deaktivieren Sie den DMX-Eingang in Einstellungen → "Manual Mode" aktivieren
  4. Aktivieren Sie "Auto-Play Next", wenn Sie eine durchgehende Wiedergabe wünschen
  5. Der DJ spielt einen beliebigen Track → das Licht folgt automatisch

🎛️ Szenario 2: Volle DMX-Automatisierung (One-Person Show)

Ideal für: Tournee-Shows, Installationen oder Events, die von einem einzigen Lichtoperator gesteuert werden.

Wie es funktioniert:

  • Das Lichtpult sendet DMX-Befehle an den DMX TimeCode Player
  • Der Lichtoperator triggert Tracks direkt vom Pult aus
  • Keine separate Person für die Wiedergabesteuerung erforderlich
  • Perfekte Synchronisation zwischen Audio/Video und Licht

💡 Vorteil: Eine Person steuert alles! Fügen Sie den Player als Fixture in Ihrem Pult hinzu und triggern Sie Tracks aus Ihrer Cuelist wie jeden anderen Lichtbefehl.

Einrichtungsschritte:

  1. Patchen Sie den DMX TimeCode Player als Fixture in Ihrem Pult
  2. Laden und importieren Sie das Geräteprofil für Ihr Pult
  3. Konfigurieren Sie den DMX-Modus (Standard 1Ch, Loop 2Ch oder Extended 18Ch)
  4. Stellen Sie Universe/Subnet/Net passend zu Ihrem Pultausgang ein
  5. Fügen Sie Track-Trigger zu Ihrer Cuelist hinzu (DMX-Wert 11-20 = Track 1, 21-30 = Track 2, usw.)

Beispiel Cuelist:

Cue Aktion DMX-Wert
1 Show Start — Spiele Track 1 15
2 Übergang — Spiele Track 2 25
3 Finale — Spiele Track 3 35
4 Show Ende — Stopp 0

📱 Szenario 3: Fernsteuerung via Web-Interface

Ideal für: Situationen, in denen eine dritte Person (Stage Manager, Produzent) Steuerung benötigt, ohne Zugriff auf das Pult oder den Laptop zu haben.

Wie es funktioniert:

  • DMX TimeCode Player betreibt einen integrierten Webserver
  • Jeder im selben Netzwerk kann die Wiedergabe von Smartphone oder Tablet steuern
  • Keine App-Installation erforderlich — einfach Browser öffnen
  • Mehrere Personen können gleichzeitig Zugriff haben

💡 Perfekt für: Stage Manager, die Musik starten müssen, Bandleader, die Backing-Tracks steuern, oder Firmenpräsentationen, bei denen jemand anderes den Audio-Teil steuert.

Einrichtungsschritte:

  1. Stellen Sie sicher, dass alle Geräte im selben WLAN sind
  2. Finden Sie die IP-Adresse in Einstellungen → Web Server
  3. Browser auf dem Smartphone öffnen: http://[IP]:8080
  4. Verwenden Sie das Web-Interface für Play/Pause/Stopp/Track-Auswahl

⚠️ Sicherheitshinweis: Das Web-Interface hat keinen Passwortschutz. Teilen Sie die IP nur mit vertrauenswürdigen Teammitgliedern in Ihrem lokalen Netzwerk.

⚠️ Maximal 24 Tracks: Die Playlist unterstützt bis zu 24 Tracks aufgrund des DMX-Wertebereichs (11-245 unterteilt in 10er-Segmente). Jeder Track erhält ein eindeutiges 1-Stunden-Timecode-Fenster (00:00:00:00 bis 23:59:59:24).

❓ Häufig gestellte Fragen (FAQ)

Ist diese Software kostenlos?

Ja! DMX TimeCode Player ist komplett kostenlos ohne Abonnements oder Einschränkungen. Spenden sind willkommen, aber nicht erforderlich.

Welche Audioformate werden unterstützt?

MP3, WAV, FLAC, AAC, M4A und die meisten gängigen Audioformate.

Welche Videoformate werden unterstützt?

MP4, MOV, M4V und die meisten von AVFoundation unterstützten Formate.

Kann ich mehrere Instanzen ausführen?

Derzeit wird nur eine Instanz unterstützt. Mehrere Instanzen können Portkonflikte verursachen.

Gibt es eine Windows-Version?

Aktuell wird nur macOS unterstützt. Eine Windows-Version wird möglicherweise in Zukunft basierend auf der Nachfrage entwickelt.

Wie melde ich Fehler oder fordere Funktionen an?

Kontaktieren Sie den Entwickler per E-Mail (siehe Fußzeile) oder über Instagram.