CSV-Track-Import
PlayIt VoiceTrack kann Tracks aus einer CSV-Datei (Comma-Separated Values) importieren, indem der Assistent zum Hinzufügen Neuer Track verwendet wird. Dies ist nützlich, wenn Track-Metadaten aus einem anderen Playout-System, einem Musikplanungsprogramm oder einer Tabellenkalkulation migriert werden.
Vorbereitung
Der CSV-Importer erwartet Daten in einem bestimmten Format. Wenn Sie aus einem anderen System exportieren, müssen Sie die Daten mit hoher Wahrscheinlichkeit konvertieren und neu formatieren, bevor sie in PlayIt VoiceTrack importiert werden können. Dies erfordert einigen manuellen Aufwand und Kenntnisse mit Tabellenkalkulationsprogrammen wie Microsoft Excel oder Google Sheets.
Insbesondere müssen alle Dauer- und Cue-Point-Werte in Dezimalsekunden angegeben werden. 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 vor dem Import selbst konvertieren. Weitere Informationen finden Sie unten unter Wertformate.
Die beste Vorgehensweise ist, zunächst einige Tracks aus PlayIt VoiceTrack mit dem CSV-Export in Tracks Verwalten zu exportieren. So erhalten Sie eine Vorlage mit den genauen Spaltennamen und Wertformaten, die der Importer erwartet.
Eine CSV-Datei erstellen
Die CSV-Datei muss eine Kopfzeile mit Spaltennamen haben, gefolgt von einer Zeile pro Track. Sie können die Datei in einer beliebigen Tabellenkalkulationsanwendung erstellen und als CSV exportieren oder sie in einem Texteditor schreiben.
Minimalbeispiel
Jeder Track benötigt mindestens 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,354Vollstä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,SongWertformate
Jede Spalte hat ein bestimmtes Wertformat. Die Verwendung eines falschen Formats führt dazu, dass die Zeile beim Import übersprungen wird.
Dezimalsekunden
Alle Dauer- und Cue-Point-Spalten müssen in Dezimalsekunden mit einem Punkt (.) als Dezimaltrennzeichen angegeben werden.
| 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 beim CSV-Export automatisch.
Boolean
Boolesche Spalten (No Fade, Sweeper, Disabled, Gain Set Manually?) akzeptieren true oder false (Groß-/Kleinschreibung wird ignoriert). Wenn die Spalte fehlt oder leer ist, wird der Wert standardmäßig auf false gesetzt.
Datum
Datumsspalten (Valid From, Expires) akzeptieren Standard-Datumsformate wie 2026-01-15. Der Zeitanteil wird ignoriert.
Dezimalzahl
Dezimale Spalten (Gain DB, Loudness Target LUFS, Tempo Adjust Percentage) verwenden einen Punkt (.) als Dezimaltrennzeichen. Beispielsweise -3.5 für eine Gain-Reduzierung 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 in der Kopfzeile fehlt, wird das Feld leer gelassen oder 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 Duplikaterkennung verwendet. |
| Duration oder Duration (seconds) | Dezimalsekunden | Die Gesamtdauer des Tracks (z. B. 239 oder 228.5). |
Track-Informationen
| Spalte | Format | Beschreibung |
|---|---|---|
| Artist | Text | Der Interpretenname. |
| Title | Text | Der Track-Titel. |
| 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 Typbezeichner 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. |
Track-Typ-Werte
Die Spalte Type muss einen der folgenden Werte genau wie angegeben verwenden.
| Wert | Beschreibung |
|---|---|
Song | Ein Musiktrack. |
Station ID | Ein Senderkennung-Jingle. |
Promo | Eine Werbeankündigung. |
Commercial | Ein Werbespot. |
News | Ein Nachrichtenbeitrag oder -clip. |
Bed | Ein Hintergrundmusik-Bed. |
Station ID + Bed | Eine kombinierte Senderkennung mit einem Hintergrund-Bed. |
Wenn die Spalte Type leer gelassen wird, wird der Typ automatisch erkannt.
Cue Points und Timing
| Spalte | Format | Standard | Beschreibung |
|---|---|---|---|
| Intro | Dezimalsekunden | 0 | Die Intro-Dauer. Der Punkt, ab 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 Track gilt ab diesem Punkt als beendet. |
| Early Out | Dezimalsekunden | Nicht gesetzt | Der Early-Out-Punkt. Markiert den Punkt, an dem der Track fast beendet ist. |
| Hook Start | Dezimalsekunden | Nicht gesetzt | Der Beginn des Hook-Abschnitts des Tracks. Hooks werden nur von PlayIt Live verwendet und von PlayIt VoiceTrack ignoriert. |
| Hook End | Dezimalsekunden | Nicht gesetzt | Das Ende des Hook-Abschnitts des Tracks. Hooks werden nur von PlayIt Live verwendet und von PlayIt VoiceTrack ignoriert. |
Wiedergabesteuerung
| Spalte | Format | Standard | Beschreibung |
|---|---|---|---|
| No Fade | Boolean | false | Auf true setzen, um das Ausblenden am Ende des Tracks zu deaktivieren. |
| Sweeper | Boolean | false | Auf true setzen, um den Track als Sweeper oder Jingle zu markieren. |
| Disabled | Boolean | false | Auf true setzen, um den Track von der Planung oder Wiedergabe auszuschließen. |
| Valid From | Datum | Nicht gesetzt | Das Datum, ab dem der Track verfügbar wird (z. B. 2026-01-15). |
| Expires | Datum | Nicht gesetzt | Das Datum, nach dem der Track nicht mehr verfügbar ist. |
Audioverarbeitung
| Spalte | Format | Standard | Beschreibung |
|---|---|---|---|
| Gain DB | Dezimalzahl | Nicht gesetzt | Audiopegel-Anpassung in Dezibel (z. B. -3.5). |
| Gain Set Manually? | Boolean | false | Auf true setzen, wenn der Gain-Wert manuell konfiguriert wurde und nicht automatisch erkannt wurde. |
| Loudness Target LUFS | Dezimalzahl | Nicht gesetzt | Das Lautstärkenormalisierungsziel in LUFS. |
| Tempo Adjust Percentage | Dezimalzahl | Nicht gesetzt | Prozentuale Anpassung des Wiedergabetempos. |
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 restliche Import wird fortgesetzt.
- Spalten können in beliebiger Reihenfolge in der CSV-Datei erscheinen.
- Zusätzliche Spalten, die von PlayIt VoiceTrack 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").