Importação de faixas CSV
PlayIt VoiceTrack 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 planejamento musical ou uma planilha.
Antes de começar
O importador 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 VoiceTrack. 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 Cue Point 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. Veja Formatos de valores abaixo para mais detalhes.
A melhor abordagem é primeiro exportar algumas faixas do PlayIt VoiceTrack usando a exportação CSV em Gerenciar Faixas. Isso fornece um modelo mostrando os nomes de coluna 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 os nomes das 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,354Exemplo 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,SongFormatos 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 Cue Point 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 seus dados de origem usam 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 para segundos totais.
Texto
Os valores de texto (Artist, Title, Album, etc.) são strings simples. Se um valor contiver uma vírgula, o valor inteiro deverá ser colocado entre aspas duplas no arquivo CSV. A maioria dos aplicativos de planilha faz isso automaticamente ao exportar para CSV.
Booleano
As colunas booleanas (No Fade, Sweeper, Disabled, Gain Set Manually?) aceitam true ou false (sem distinção entre maiúsculas e minúsculas). Se a coluna estiver ausente ou vazia, o valor padrão é false.
Data
As colunas de data (Valid From, Expires) aceitam formatos de data padrão como 2026-01-15. A parte de horário é ignorada.
Decimal
As 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
Somente as colunas Path e Duration são necessárias para uma importação válida. Todas as demais colunas são opcionais. Se uma coluna estiver ausente do cabeçalho, o campo é deixado vazio ou definido com 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 (p. 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 (p. 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 (p. ex., upbeat;classic;80s). |
| Comments | Texto | Comentários em texto livre sobre a faixa. |
| Out Cue | Texto | O texto do out cue (p. ex., "and don't it feel good!"). |
| ISRC | Texto | O 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 de emissora. |
Promo | Um anúncio promocional. |
Commercial | Um comercial ou anúncio. |
News | Um boletim de notícias ou clipe. |
Bed | Uma música de fundo. |
Station ID + Bed | Uma identificação de emissora combinada com uma música de fundo. |
Se a coluna Type for deixada vazia, o tipo será inferido automaticamente.
Cue Points e temporização
| Coluna | Formato | Padrão | Descrição |
|---|---|---|---|
| Intro | Segundos decimais | 0 | 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 Cue In. A reprodução começa a partir deste ponto. |
| Cue Out | Segundos decimais | Igual à Duration | O ponto Cue Out. A faixa é considerada concluída neste ponto. |
| Early Out | Segundos decimais | Não definido | O ponto Early Out. Marca onde a faixa está quase concluída. |
| Hook Start | Segundos decimais | Não definido | O início da seção Hook da faixa. Os Hooks são usados apenas pelo PlayIt Live e são ignorados pelo PlayIt VoiceTrack. |
| Hook End | Segundos decimais | Não definido | O fim da seção Hook da faixa. Os Hooks são usados apenas pelo PlayIt Live e são ignorados pelo PlayIt VoiceTrack. |
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 final da faixa. |
| Sweeper | Booleano | false | Definir como true para marcar a faixa como Sweeper ou jingle. |
| Disabled | Booleano | false | Definir como true para desativar a faixa de ser programada ou reproduzida. |
| Valid From | Data | Não definido | A data a partir da qual a faixa fica disponível (p. ex., 2026-01-15). |
| Expires | Data | Não definido | A data após a qual a faixa não está mais disponível. |
Processamento de áudio
| Coluna | Formato | Padrão | Descrição |
|---|---|---|---|
| Gain DB | Decimal | Não definido | Ajuste de ganho de áudio em decibéis (p. ex., -3.5). |
| Gain Set Manually? | Booleano | false | Definir como true se o valor de ganho foi configurado manualmente em vez de detectado automaticamente. |
| Loudness Target LUFS | Decimal | Não definido | O alvo de normalização de volume em LUFS. |
| Tempo Adjust Percentage | Decimal | Não definido | Ajuste percentual ao tempo de reprodução. |
Tratamento de erros
- Se uma linha contiver um valor malformado (p. ex., texto em uma coluna numérica), essa linha é ignorada e o erro é registrado. O restante da importação continua.
- As colunas podem aparecer em qualquer ordem no arquivo CSV.
- Colunas extras não reconhecidas pelo PlayIt VoiceTrack são ignoradas.
- Se um valor contiver uma vírgula, coloque-o entre aspas duplas (p. ex.,
"Earth, Wind & Fire").