CSV-track-import

PlayIt Live kan tracks importeren vanuit een CSV-bestand (Comma-Separated Values) via de Wizard Nieuwe Tracks Toevoegen. Dit is handig bij het migreren van track-metadata vanuit een ander playout-systeem, een muziekplanningtool of een spreadsheet.

Voordat u begint

De CSV-importer verwacht gegevens in een specifiek formaat. Als u exporteert vanuit een ander systeem, zult u de gegevens vrijwel zeker moeten converteren en herformatteren voordat ze kunnen worden geïmporteerd in PlayIt Live. Dit vereist enige handmatige inspanning en bekendheid met spreadsheettools zoals Microsoft Excel of Google Sheets.

In het bijzonder moeten alle waarden voor duur en cue-punten in decimale seconden worden opgegeven. Formaten zoals 3:45 of 0:08.5 worden niet geaccepteerd omdat ze dubbelzinnig zijn (ze kunnen minuten:seconden of uren:minuten vertegenwoordigen). U moet deze waarden zelf converteren voordat u importeert. Zie Waardenotaties hieronder voor details.

De beste aanpak is om eerst een aantal tracks te exporteren vanuit PlayIt Live via de CSV-export in Tracks Beheren. Dit geeft u een sjabloon met de exacte kolomnamen en waardenotaties die de importer verwacht.

Een CSV-bestand maken

Het CSV-bestand moet een headerrij hebben met kolomnamen, gevolgd door één rij per track. U kunt het bestand maken in een spreadsheettoepassing en exporteren als CSV, of het schrijven in een teksteditor.

Minimaal voorbeeld

Minimaal heeft elke track een bestandspad en een duur nodig:

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

Volledig voorbeeld

Een vollediger CSV-bestand met timing- en metadatakolommen:

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

Waardenotaties

Elke kolom heeft een specifieke waardenotatie. Het gebruik van een onjuist formaat zorgt ervoor dat de rij tijdens het importeren wordt overgeslagen.

Decimale seconden

Alle kolommen voor duur en cue-punten moeten in decimale seconden zijn, met een punt (.) als decimaal scheidingsteken.

Correct	Onjuist
`239`	`3:59`
`8.5`	`0:08.5`
`228.75`	`3:48.75`
`0`	`0:00`

Als uw brongegevens het formaat minuten:seconden gebruiken, moet u deze converteren. In een spreadsheet kunt u een formule gebruiken zoals =MINUTE(A1)*60+SECOND(A1) om een tijdwaarde in cel A1 te converteren naar totale seconden.

Tekst

Tekstwaarden (Artist, Title, Album, enz.) zijn gewone tekenreeksen. Als een waarde een komma bevat, moet de volledige waarde worden omsloten door dubbele aanhalingstekens in het CSV-bestand. De meeste spreadsheettoepassingen regelen dit automatisch bij het exporteren naar CSV.

Booleaans

Booleaanse kolommen (No Fade, Sweeper, Disabled, Ignore Validity Year?, Gain Set Manually?) accepteren true of false (hoofdletterongevoelig). Als de kolom ontbreekt of leeg is, is de standaardwaarde false.

Datum

Datumkolommen (Valid From, Expires) accepteren standaard datumformaten zoals 2026-01-15. Het tijdgedeelte wordt genegeerd.

Decimaal

Decimale kolommen (Gain DB, Loudness Target LUFS, Tempo Adjust Percentage) gebruiken een punt (.) als decimaal scheidingsteken. Bijvoorbeeld -3.5 voor een gainvermindering van 3,5 dB.

Kolomreferentie

Verplichte kolommen

Alleen de kolommen Path en Duration zijn nodig voor een geldige import. Alle andere kolommen zijn optioneel. Als een kolom ontbreekt in de header, wordt het veld leeg gelaten of ingesteld op de standaardwaarde.

Kolom	Formaat	Beschrijving
Path	Tekst	Het volledige bestandspad naar het audiobestand op de schijf. Wordt gebruikt voor afspelen en detectie van duplicaten.
Duration of Duration (seconds)	Decimale seconden	De totale duur van de track (bijv. `239` of `228.5`).

Trackinformatie

Kolom	Formaat	Beschrijving
Artist	Tekst	De naam van de artiest of uitvoerder.
Title	Tekst	De tracktitel.
Album	Tekst	De naam van het album.
Genre	Tekst	Het genre (bijv. Pop, Rock, Jazz).
Year	Tekst	Het uitbrengjaar.
Type	Tekst	Het tracktype. Moet een van de onderstaande type-identificatoren zijn, of leeg worden gelaten.
Tags	Tekst	Puntkommagescheiden tags (bijv. `upbeat;classic;80s`).
Comments	Tekst	Vrije tekstcommentaren over de track.
Out Cue	Tekst	De Out Cue-tekst (bijv. "and don't it feel good!").
ISRC	Tekst	De International Standard Recording Code.
Record Label	Tekst	De naam van het platenlabel.
Track ID	Tekst	Een aangepaste trackidentificatie.

Waarden voor het tracktype

De kolom Type moet een van de volgende waarden gebruiken, exact zoals hieronder weergegeven.

Waarde	Beschrijving
`Song`	Een muziektrack.
`Station ID`	Een station-identificatie jingle.
`Promo`	Een promotionele aankondiging.
`Commercial`	Een commercial of reclamespot.
`News`	Een nieuwsbulletin of -clip.
`Bed`	Een achtergrondmuziekbed.
`Station ID + Bed`	Een gecombineerde station-ID met een achtergrondbed.

Als de kolom Type leeg wordt gelaten, wordt het type automatisch afgeleid.

Cue-punten en timing

Kolom	Formaat	Standaard	Beschrijving
Intro	Decimale seconden	Niet ingesteld	De introduur. Het punt waarop de zang of de hoofdinhoud begint.
Cue In	Decimale seconden	0	Het Cue In-punt. Afspelen begint vanaf dit punt.
Cue Out	Decimale seconden	Gelijk aan Duration	Het Cue Out-punt. De volgende track begint op dit punt.
Early Out	Decimale seconden	Niet ingesteld	Het Early Out-punt. Wordt gebruikt om een Sweeper vroegtijdig af te spelen.
Hook Start	Decimale seconden	Niet ingesteld	Het begin van het Hook-gedeelte van de track.
Hook End	Decimale seconden	Niet ingesteld	Het einde van het Hook-gedeelte van de track.

Afspeelbeheer

Kolom	Formaat	Standaard	Beschrijving
No Fade	Booleaans	false	Stel in op `true` om het uitfaden op het Cue Out-punt van de track uit te schakelen.
Sweeper	Booleaans	false	Stel in op `true` om de track als Sweeper te markeren en toe te staan dat deze over andere tracks wordt afgespeeld.
Disabled	Booleaans	false	Stel in op `true` om de track uit te sluiten van planning.
Valid From	Datum	Niet ingesteld	De datum om middernacht vanaf welke de track beschikbaar wordt (bijv. `2026-01-15`).
Expires	Datum	Niet ingesteld	De datum om middernacht waarna de track niet meer beschikbaar is (bijv. `2026-02-15`).
Ignore Validity Year?	Booleaans	false	Stel in op `true` om het jaardeel van Valid From en Expires te negeren, zodat de track elk jaar tussen die datums wordt herhaald. Heeft alleen effect wanneer zowel Valid From als Expires zijn ingesteld.

Audioverwerking

Kolom	Formaat	Standaard	Beschrijving
Gain DB	Decimaal	Niet ingesteld	Gainaanpassing van het audio in decibel (bijv. `-3.5`).
Gain Set Manually?	Booleaans	false	Stel in op `true` als de gainwaarde handmatig is geconfigureerd in plaats van automatisch gedetecteerd door Loudness-analyse.
Loudness Target LUFS	Decimaal	Niet ingesteld	Het loudness-normalisatiedoel in LUFS opgeslagen door de functie Loudness-analyse.
Tempo Adjust Percentage	Decimaal	Niet ingesteld	Procentuele aanpassing van het afspeeltempo.

Schema

Kolom	Formaat	Beschrijving
Dayparting	Tekst	Bepaalt wanneer de track mag worden afgespeeld. De waarde begint met `Y` (ingeschakeld) of `N` (uitgeschakeld), gevolgd door puntkommagescheiden dag-uur-paren in het formaat `DayCode\|Hour`. Dagcodes zijn `Mo`, `Tu`, `We`, `Th`, `Fr`, `Sa`, `Su`. Uren lopen van 0 tot 23. Bijvoorbeeld: `Y;Mo\|09;Mo\|10;Fr\|14` schakelt de track in op maandag om 9 en 10 uur, en op vrijdag om 14 uur.

Foutafhandeling

Als een rij een onjuiste waarde bevat (bijv. tekst in een numerieke kolom), wordt die rij overgeslagen en wordt de fout geregistreerd. De rest van de import gaat door.
Kolommen kunnen in willekeurige volgorde in het CSV-bestand verschijnen.
Extra kolommen die niet worden herkend door PlayIt Live worden genegeerd.
Als een waarde een komma bevat, sluit deze dan in tussen dubbele aanhalingstekens (bijv. "Earth, Wind & Fire").