Importação de faixas por CSV

PlayIt Live pode importar faixas de um arquivo CSV (Comma-Separated Values) usando o Assistente de Adicionar Novas Faixas. Isso é útil ao migrar metadados de faixas de outro sistema de playout, uma ferramenta de programação musical ou uma planilha.

Antes de começar

O importador de CSV espera dados em um formato específico. Se você estiver exportando de outro sistema, quase certamente precisará converter e reformatar os dados antes de importá-los no PlayIt Live. Isso requer algum esforço manual e familiaridade com ferramentas de planilha como Microsoft Excel ou Google Sheets.

Em particular, todos os valores de duração e pontos de cue devem estar em segundos decimais. Formatos como 3:45 ou 0:08.5 não são aceitos porque são ambíguos (podem representar minutos:segundos ou horas:minutos). Você precisará converter esses valores antes de importar. Consulte Formatos de valores abaixo para mais detalhes.

A melhor abordagem é exportar primeiro algumas faixas do PlayIt Live usando a exportação CSV em Gerenciar Faixas. Isso fornece um modelo com os nomes de colunas exatos e os formatos de valores que o importador espera.

Criando um arquivo CSV

O arquivo CSV deve ter uma linha de cabeçalho com nomes de colunas, seguida de uma linha por faixa. Você pode criar o arquivo em qualquer aplicativo de planilha e exportá-lo como CSV, ou escrevê-lo em um editor de texto.

Exemplo mínimo

No mínimo, cada faixa precisa de um caminho de arquivo e uma duração:

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

Exemplo completo

Um arquivo CSV mais completo com colunas de temporização e metadados:

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

Formatos de valores

Cada coluna tem um formato de valor específico. Usar o formato errado fará com que a linha seja ignorada durante a importação.

Segundos decimais

Todas as colunas de duração e pontos de cue devem estar em segundos decimais usando um ponto (.) como separador decimal.

Correto	Incorreto
`239`	`3:59`
`8.5`	`0:08.5`
`228.75`	`3:48.75`
`0`	`0:00`

Se os seus dados de origem usarem o formato minutos:segundos, você precisará convertê-los. Em uma planilha, você pode usar uma fórmula como =MINUTE(A1)*60+SECOND(A1) para converter um valor de tempo na célula A1 em segundos totais.

Texto

Valores de texto (Artist, Title, Album, etc.) são strings simples. Se um valor contiver uma vírgula, o valor inteiro deve ser delimitado por aspas duplas no arquivo CSV. A maioria dos aplicativos de planilha faz isso automaticamente ao exportar para CSV.

Booleano

Colunas booleanas (No Fade, Sweeper, Disabled, Ignore Validity Year?, Gain Set Manually?) aceitam true ou false (sem distinção de maiúsculas e minúsculas). Se a coluna estiver ausente ou vazia, o valor padrão é false.

Data

Colunas de data (Valid From, Expires) aceitam formatos de data padrão como 2026-01-15. A parte de hora é ignorada.

Decimal

Colunas decimais (Gain DB, Loudness Target LUFS, Tempo Adjust Percentage) usam um ponto (.) como separador decimal. Por exemplo, -3.5 para uma redução de ganho de 3,5 dB.

Referência de colunas

Colunas obrigatórias

Apenas as colunas Path e Duration são necessárias para uma importação válida. Todas as outras colunas são opcionais. Se uma coluna estiver ausente do cabeçalho, o campo ficará vazio ou será definido como seu valor padrão.

Coluna	Formato	Descrição
Path	Texto	O caminho completo do arquivo de áudio no disco. Usado para reprodução e detecção de duplicatas.
Duration ou Duration (seconds)	Segundos decimais	A duração total da faixa (ex.: `239` ou `228.5`).

Informações da faixa

Coluna	Formato	Descrição
Artist	Texto	O nome do artista ou intérprete.
Title	Texto	O título da faixa.
Album	Texto	O nome do álbum.
Genre	Texto	O gênero (ex.: Pop, Rock, Jazz).
Year	Texto	O ano de lançamento.
Type	Texto	O tipo de faixa. Deve ser um dos identificadores de tipo listados abaixo ou deixado vazio.
Tags	Texto	Tags separadas por ponto e vírgula (ex.: `upbeat;classic;80s`).
Comments	Texto	Comentários em texto livre sobre a faixa.
Out Cue	Texto	O texto do Out Cue (ex.: "and don't it feel good!").
ISRC	Texto	O código ISRC (International Standard Recording Code).
Record Label	Texto	O nome da gravadora.
Track ID	Texto	Um identificador de faixa personalizado.

Valores do tipo de faixa

A coluna Type deve usar um dos seguintes valores exatamente como mostrado abaixo.

Valor	Descrição
`Song`	Uma faixa musical.
`Station ID`	Um jingle de identificação da rádio.
`Promo`	Um anúncio promocional.
`Commercial`	Um comercial ou anúncio publicitário.
`News`	Um boletim de notícias ou clipe.
`Bed`	Uma base musical de fundo.
`Station ID + Bed`	Uma identificação de rádio combinada com uma base musical de fundo.

Se a coluna Type for deixada vazia, o tipo será inferido automaticamente.

Pontos de cue e temporização

Coluna	Formato	Padrão	Descrição
Intro	Segundos decimais	Não definido	A duração do Intro. O ponto em que as vozes ou o conteúdo principal começa.
Cue In	Segundos decimais	0	O ponto de Cue In. A reprodução começa a partir desse ponto.
Cue Out	Segundos decimais	Igual a Duration	O ponto de Cue Out. A próxima faixa começa nesse ponto.
Early Out	Segundos decimais	Não definido	O ponto de Early Out. Usado para reproduzir um Sweeper antecipadamente.
Hook Start	Segundos decimais	Não definido	O início da seção Hook da faixa.
Hook End	Segundos decimais	Não definido	O fim da seção Hook da faixa.

Controle de reprodução

Coluna	Formato	Padrão	Descrição
No Fade	Booleano	false	Definir como `true` para desativar o Fade de saída no ponto de Cue Out da faixa.
Sweeper	Booleano	false	Definir como `true` para marcar a faixa como Sweeper e permitir que ela toque sobre outras faixas.
Disabled	Booleano	false	Definir como `true` para desativar a faixa do agendamento.
Valid From	Data	Não definido	A data à meia-noite a partir da qual a faixa fica disponível (ex.: `2026-01-15`).
Expires	Data	Não definido	A data à meia-noite após a qual a faixa não está mais disponível (ex.: `2026-02-15`).
Ignore Validity Year?	Booleano	false	Definir como `true` para ignorar a parte do ano de Valid From e Expires, de modo que a faixa se repita todos os anos entre essas datas. Só tem efeito quando Valid From e Expires estão ambos definidos.

Processamento de áudio

Coluna	Formato	Padrão	Descrição
Gain DB	Decimal	Não definido	Ajuste de ganho de áudio em decibéis (ex.: `-3.5`).
Gain Set Manually?	Booleano	false	Definir como `true` se o valor de ganho foi configurado manualmente em vez de detectado automaticamente pela Análise de Loudness.
Loudness Target LUFS	Decimal	Não definido	O alvo de normalização de loudness em LUFS armazenado pelo recurso de Análise de Loudness.
Tempo Adjust Percentage	Decimal	Não definido	Ajuste percentual no tempo de reprodução.

Programação

Coluna	Formato	Descrição
Dayparting	Texto	Controla quando a faixa pode ser reproduzida. O valor começa com `Y` (habilitado) ou `N` (desabilitado), seguido de pares de dia e hora separados por ponto e vírgula no formato `DayCode\|Hour`. Os códigos de dia são `Mo`, `Tu`, `We`, `Th`, `Fr`, `Sa`, `Su`. As horas vão de 0 a 23. Por exemplo, `Y;Mo\|09;Mo\|10;Fr\|14` habilita a faixa às segundas-feiras às 9h e 10h, e às sextas-feiras às 14h.

Tratamento de erros

Se uma linha contiver um valor malformado (ex.: texto em uma coluna numérica), essa linha será ignorada e o erro será registrado. O restante da importação continua.
As colunas podem aparecer em qualquer ordem no arquivo CSV.
Colunas extras não reconhecidas pelo PlayIt Live são ignoradas.
Se um valor contiver uma vírgula, coloque-o entre aspas duplas (ex.: "Earth, Wind & Fire").