CSV-track-import
PlayIt VoiceTrack kan tracks importeren vanuit een CSV-bestand (Comma-Separated Values) via de Wizard Nieuwe Tracks Toevoegen. Dit is handig wanneer u trackmetadata migreert vanuit een ander playout-systeem, een muziekplanningsprogramma of een spreadsheet.
Voordat u begint
De CSV-importeur verwacht gegevens in een specifiek formaat. Als u exporteert vanuit een ander systeem, zult u de gegevens vrijwel zeker moeten converteren en herformatteren voordat u ze kunt importeren in PlayIt VoiceTrack. Dit vereist enige handmatige inspanning en kennis van spreadsheettools zoals Microsoft Excel of Google Sheets.
In het bijzonder moeten alle duur- en Cue Point-waarden in decimale seconden zijn. Formaten zoals 3:45 of 0:08.5 worden niet geaccepteerd omdat ze dubbelzinnig zijn (ze kunnen minuten:seconden of uren:minuten vertegenwoordigen). U dient deze waarden zelf te converteren vóór het importeren. Zie Waardeformaten hieronder voor meer informatie.
De beste aanpak is om eerst enkele tracks te exporteren vanuit PlayIt VoiceTrack via de CSV-export in Tracks Beheren. Dit geeft u een sjabloon met de exacte kolomnamen en waardeformaten die de importeur verwacht.
Een CSV-bestand aanmaken
Het CSV-bestand moet een headerrij hebben met kolomnamen, gevolgd door één rij per track. U kunt het bestand aanmaken in een willekeurige spreadsheetapplicatie en het exporteren als CSV, of het schrijven in een teksteditor.
Minimaal voorbeeld
Elke track heeft minimaal 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,354Volledig voorbeeld
Een uitgebreider 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,SongWaardeformaten
Elke kolom heeft een specifiek waardeformaat. Het gebruik van een verkeerd formaat zorgt ervoor dat de rij wordt overgeslagen tijdens de import.
Decimale seconden
Alle duur- en Cue Point-kolommen moeten in decimale seconden zijn met een punt (.) als decimaalteken.
| 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, dient u deze te converteren. In een spreadsheet kunt u een formule gebruiken zoals =MINUTE(A1)*60+SECOND(A1) om een tijdwaarde in cel A1 om te zetten 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 spreadsheetapplicaties doen dit automatisch bij het exporteren naar CSV.
Booleaans
Booleaanse kolommen (No Fade, Sweeper, Disabled, Gain Set Manually?) accepteren true of false (hoofdletterongevoelig). Als de kolom ontbreekt of leeg is, wordt de waarde standaard ingesteld op false.
Datum
Datumkolommen (Valid From, Expires) accepteren standaarddatumformaten zoals 2026-01-15. Het tijdgedeelte wordt genegeerd.
Decimaal
Decimale kolommen (Gain DB, Loudness Target LUFS, Tempo Adjust Percentage) gebruiken een punt (.) als decimaalteken. Bijvoorbeeld -3.5 voor een gainreductie van 3,5 dB.
Kolomreferentie
Vereiste 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 schijf. Gebruikt voor afspelen en duplicaatdetectie. |
| 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 albumnaam. |
| Genre | Tekst | Het genre (bijv. Pop, Rock, Jazz). |
| Year | Tekst | Het uitgebrachte jaar. |
| Type | Tekst | Het tracktype. Moet een van de hieronder vermelde type-id's zijn, of leeg worden gelaten. |
| Tags | Tekst | Door puntkomma's gescheiden tags (bijv. upbeat;classic;80s). |
| Comments | Tekst | Vrije tekstopmerkingen 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 track-id. |
Tracktype-waarden
De kolom Type moet een van de volgende waarden gebruiken precies zoals hieronder weergegeven.
| Waarde | Beschrijving |
|---|---|
Song | Een muziektrack. |
Station ID | Een station-identificatiejingle. |
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 Points en timing
| Kolom | Formaat | Standaard | Beschrijving |
|---|---|---|---|
| Intro | Decimale seconden | 0 | De Intro-duur. Het punt waarop de zang of de hoofdinhoud begint. |
| Cue In | Decimale seconden | 0 | Het Cue In-punt. Afspelen start vanaf dit punt. |
| Cue Out | Decimale seconden | Gelijk aan Duration | Het Cue Out-punt. De track wordt als beëindigd beschouwd op dit punt. |
| Early Out | Decimale seconden | Niet ingesteld | Het Early Out-punt. Geeft aan waar de track bijna klaar is. |
| Hook Start | Decimale seconden | Niet ingesteld | Het begin van het Hook-gedeelte van de track. Hooks worden alleen gebruikt door PlayIt Live en worden genegeerd door PlayIt VoiceTrack. |
| Hook End | Decimale seconden | Niet ingesteld | Het einde van het Hook-gedeelte van de track. Hooks worden alleen gebruikt door PlayIt Live en worden genegeerd door PlayIt VoiceTrack. |
Afspeelbesturing
| Kolom | Formaat | Standaard | Beschrijving |
|---|---|---|---|
| No Fade | Booleaans | false | Instellen op true om het uitfaden aan het einde van de track uit te schakelen. |
| Sweeper | Booleaans | false | Instellen op true om de track te markeren als Sweeper of jingle. |
| Disabled | Booleaans | false | Instellen op true om de track uit te schakelen van planning of afspelen. |
| Valid From | Datum | Niet ingesteld | De datum vanaf wanneer de track beschikbaar wordt (bijv. 2026-01-15). |
| Expires | Datum | Niet ingesteld | De datum waarna de track niet meer beschikbaar is. |
Audioverwerking
| Kolom | Formaat | Standaard | Beschrijving |
|---|---|---|---|
| Gain DB | Decimaal | Niet ingesteld | Audiogainaanpassing in decibel (bijv. -3.5). |
| Gain Set Manually? | Booleaans | false | Instellen op true als de gainwaarde handmatig is geconfigureerd in plaats van automatisch gedetecteerd. |
| Loudness Target LUFS | Decimaal | Niet ingesteld | Het doelniveau voor volumenormalisatie in LUFS. |
| Tempo Adjust Percentage | Decimaal | Niet ingesteld | Procentuele aanpassing van het afspeeltempo. |
Foutafhandeling
- Als een rij een onjuist geformatteerde waarde bevat (bijv. tekst in een numerieke kolom), wordt die rij overgeslagen en wordt de fout geregistreerd. De rest van de import gaat verder.
- Kolommen kunnen in elke volgorde voorkomen in het CSV-bestand.
- Extra kolommen die niet worden herkend door PlayIt VoiceTrack worden genegeerd.
- Als een waarde een komma bevat, sluit deze in tussen dubbele aanhalingstekens (bijv.
"Earth, Wind & Fire").