CSV-Track-Import

PlayIt Live kann Tracks aus einer CSV-Datei (Comma-Separated Values) importieren, indem Sie den Assistent zum Hinzufügen Neuer Track verwenden. Dies ist nützlich, wenn Sie Track-Metadaten aus einem anderen Playout-System, einem Musikplanungstool oder einer Tabellenkalkulation migrieren.

Vor dem Start

Der CSV-Importer erwartet Daten in einem bestimmten Format. Wenn Sie Daten aus einem anderen System exportieren, müssen Sie die Daten fast sicher konvertieren und umformatieren, bevor sie in PlayIt Live importiert werden können. Dies erfordert etwas manuelle Arbeit und Kenntnisse in Tabellenkalkulationstools wie Microsoft Excel oder Google Sheets.

Insbesondere müssen alle Werte für Dauer und Cue-Punkte in Dezimalsekunden angegeben sein. Formate wie 3:45 oder 0:08.5 werden nicht akzeptiert, da sie mehrdeutig sind (sie könnten Minuten:Sekunden oder Stunden:Minuten darstellen). Sie müssen diese Werte selbst konvertieren, bevor Sie den Import durchführen. Weitere Informationen finden Sie unter Werteformate weiter unten.

Der beste Ansatz ist, zunächst einige Tracks aus PlayIt Live zu exportieren, indem Sie den CSV-Export in Tracks Verwalten verwenden. So erhalten Sie eine Vorlage mit den genauen Spaltennamen und Werteformaten, die der Importer erwartet.

CSV-Datei erstellen

Die CSV-Datei muss eine Kopfzeile mit Spaltennamen enthalten, gefolgt von einer Zeile pro Track. Sie können die Datei in jeder Tabellenkalkulationsanwendung erstellen und als CSV exportieren oder sie in einem Texteditor schreiben.

Minimales Beispiel

Mindestens benötigt jeder Track einen Dateipfad und eine Dauer:

Path,Artist,Title,Duration
C:\Music\Katrina and the Waves - Walking on Sunshine.mp3,Katrina and the Waves,Walking on Sunshine,239
C:\Music\Journey - Don't Stop Believin'.mp3,Journey,Don't Stop Believin',250.5
C:\Music\Queen - Bohemian Rhapsody.mp3,Queen,Bohemian Rhapsody,354

Vollständiges Beispiel

Eine vollständigere CSV-Datei mit Timing- und Metadatenspalten:

Path,Artist,Title,Duration,Intro,Cue In,Cue Out,Genre,Year,Type
C:\Music\Walking on Sunshine.mp3,Katrina and the Waves,Walking on Sunshine,239,8.5,0,228,Pop,1985,Song
C:\Music\Bohemian Rhapsody.mp3,Queen,Bohemian Rhapsody,354,15,0,340,Rock,1975,Song

Werteformate

Jede Spalte hat ein bestimmtes Werteformat. Die Verwendung eines falschen Formats führt dazu, dass die Zeile beim Import übersprungen wird.

Dezimalsekunden

Alle Spalten für Dauer und Cue-Punkte müssen in Dezimalsekunden mit einem Punkt (.) als Dezimaltrennzeichen angegeben sein.

Korrekt	Falsch
`239`	`3:59`
`8.5`	`0:08.5`
`228.75`	`3:48.75`
`0`	`0:00`

Wenn Ihre Quelldaten das Format Minuten:Sekunden verwenden, müssen Sie diese konvertieren. In einer Tabellenkalkulation können Sie eine Formel wie =MINUTE(A1)*60+SECOND(A1) verwenden, um einen Zeitwert in Zelle A1 in Gesamtsekunden umzurechnen.

Text

Textwerte (Artist, Title, Album usw.) sind einfache Zeichenketten. Wenn ein Wert ein Komma enthält, muss der gesamte Wert in der CSV-Datei in doppelte Anführungszeichen eingeschlossen werden. Die meisten Tabellenkalkulationsanwendungen erledigen dies automatisch beim Export in CSV.

Boolean

Boolesche Spalten (No Fade, Sweeper, Disabled, Ignore Validity Year?, Gain Set Manually?) akzeptieren true oder false (Groß-/Kleinschreibung unbeachtet). Wenn die Spalte fehlt oder leer ist, lautet der Standardwert false.

Datum

Datumsspalten (Valid From, Expires) akzeptieren Standarddatumsformate wie 2026-01-15. Der Zeitanteil wird ignoriert.

Dezimalzahl

Dezimalspalten (Gain DB, Loudness Target LUFS, Tempo Adjust Percentage) verwenden einen Punkt (.) als Dezimaltrennzeichen. Zum Beispiel -3.5 für eine Verstärkungsabsenkung von 3,5 dB.

Spaltenreferenz

Erforderliche Spalten

Nur die Spalten Path und Duration sind für einen gültigen Import erforderlich. Alle anderen Spalten sind optional. Wenn eine Spalte im Header fehlt, bleibt das Feld leer oder wird auf seinen Standardwert gesetzt.

Spalte	Format	Beschreibung
Path	Text	Der vollständige Dateipfad zur Audiodatei auf dem Datenträger. Wird für die Wiedergabe und die Erkennung von Duplikaten verwendet.
Duration oder Duration (seconds)	Dezimalsekunden	Die Gesamtdauer des Tracks (z. B. `239` oder `228.5`).

Track-Informationen

Spalte	Format	Beschreibung
Artist	Text	Der Name des Interpreten.
Title	Text	Der Titel des Tracks.
Album	Text	Der Albumname.
Genre	Text	Das Genre (z. B. Pop, Rock, Jazz).
Year	Text	Das Erscheinungsjahr.
Type	Text	Der Track-Typ. Muss einer der unten aufgeführten Typ-Bezeichner sein oder leer gelassen werden.
Tags	Text	Durch Semikolon getrennte Tags (z. B. `upbeat;classic;80s`).
Comments	Text	Freitextkommentare zum Track.
Out Cue	Text	Der Out-Cue-Text (z. B. „and don't it feel good!").
ISRC	Text	Der International Standard Recording Code.
Record Label	Text	Der Name des Plattenlabels.
Track ID	Text	Eine benutzerdefinierte Track-Kennung.

Werte für den Track-Typ

Die Spalte „Type" muss einen der folgenden Werte genau wie unten gezeigt verwenden.

Wert	Beschreibung
`Song`	Ein Musik-Track.
`Station ID`	Ein Jingle zur Senderkennung.
`Promo`	Eine Werbedurchsage.
`Commercial`	Ein Werbespot.
`News`	Eine Nachrichtensendung oder ein Clip.
`Bed`	Ein Hintergrundmusik-Bett.
`Station ID + Bed`	Eine kombinierte Sender-ID mit einem Hintergrundbett.

Wenn die Spalte „Type" leer gelassen wird, wird der Typ automatisch ermittelt.

Cue-Punkte und Timing

Spalte	Format	Standard	Beschreibung
Intro	Dezimalsekunden	Nicht gesetzt	Die Intro-Dauer. Der Punkt, an dem der Gesang oder der Hauptinhalt beginnt.
Cue In	Dezimalsekunden	0	Der Cue-In-Punkt. Die Wiedergabe beginnt ab diesem Punkt.
Cue Out	Dezimalsekunden	Gleich wie Duration	Der Cue-Out-Punkt. Der nächste Track beginnt an diesem Punkt.
Early Out	Dezimalsekunden	Nicht gesetzt	Der Early-Out-Punkt. Wird verwendet, um einen Sweeper frühzeitig abzuspielen.
Hook Start	Dezimalsekunden	Nicht gesetzt	Der Beginn des Hook-Abschnitts des Tracks.
Hook End	Dezimalsekunden	Nicht gesetzt	Das Ende des Hook-Abschnitts des Tracks.

Wiedergabesteuerung

Spalte	Format	Standard	Beschreibung
No Fade	Boolean	false	Auf `true` setzen, um das Ausblenden am Cue-Out-Punkt des Tracks zu deaktivieren.
Sweeper	Boolean	false	Auf `true` setzen, um den Track als Sweeper zu markieren und es ihm zu ermöglichen, über andere Tracks abzuspielen.
Disabled	Boolean	false	Auf `true` setzen, um den Track von der Planung auszuschließen.
Valid From	Datum	Nicht gesetzt	Das Datum um Mitternacht, ab dem der Track verfügbar wird (z. B. `2026-01-15`).
Expires	Datum	Nicht gesetzt	Das Datum um Mitternacht, nach dem der Track nicht mehr verfügbar ist (z. B. `2026-02-15`).
Ignore Validity Year?	Boolean	false	Auf `true` setzen, um den Jahresteil von Valid From und Expires zu ignorieren, sodass der Track jedes Jahr zwischen diesen Daten wiederkehrt. Gilt nur, wenn sowohl Valid From als auch Expires gesetzt sind.

Audioverarbeitung

Spalte	Format	Standard	Beschreibung
Gain DB	Dezimalzahl	Nicht gesetzt	Audioverstärkungsanpassung in Dezibel (z. B. `-3.5`).
Gain Set Manually?	Boolean	false	Auf `true` setzen, wenn der Verstärkungswert manuell konfiguriert und nicht automatisch durch die Lautheitsanalyse erkannt wurde.
Loudness Target LUFS	Dezimalzahl	Nicht gesetzt	Der von der Lautheitsanalyse-Funktion gespeicherte Lautheits-Normalisierungszielwert in LUFS.
Tempo Adjust Percentage	Dezimalzahl	Nicht gesetzt	Prozentuale Anpassung des Wiedergabetempos.

Planung

Spalte	Format	Beschreibung
Dayparting	Text	Steuert, wann der Track gespielt werden darf. Der Wert beginnt mit `Y` (aktiviert) oder `N` (deaktiviert), gefolgt von durch Semikolon getrennten Tag- und Stundenpaaren im Format `DayCode\|Hour`. Tagcodes sind `Mo`, `Tu`, `We`, `Th`, `Fr`, `Sa`, `Su`. Stunden sind 0 bis 23. Zum Beispiel aktiviert `Y;Mo\|09;Mo\|10;Fr\|14` den Track montags um 9 und 10 Uhr sowie freitags um 14 Uhr.

Fehlerbehandlung

Wenn eine Zeile einen fehlerhaften Wert enthält (z. B. Text in einer numerischen Spalte), wird diese Zeile übersprungen und der Fehler wird protokolliert. Der Rest des Imports wird fortgesetzt.
Spalten können in der CSV-Datei in beliebiger Reihenfolge erscheinen.
Zusätzliche Spalten, die von PlayIt Live nicht erkannt werden, werden ignoriert.
Wenn ein Wert ein Komma enthält, schließen Sie ihn in doppelte Anführungszeichen ein (z. B. "Earth, Wind & Fire").