Importación de pistas en CSV
PlayIt Live puede importar pistas desde un archivo CSV (valores separados por comas) usando el Asistente para Agregar Nuevas Pistas. Esto es útil cuando migras metadatos de pistas desde otro sistema de playout, una herramienta de programación musical o una hoja de cálculo.
Antes de comenzar
El importador de CSV espera los datos en un formato específico. Si estás exportando desde otro sistema, casi con total seguridad necesitarás convertir y reformatear los datos antes de poder importarlos en PlayIt Live. Esto requiere algo de esfuerzo manual y familiaridad con herramientas de hoja de cálculo como Microsoft Excel o Google Sheets.
En particular, todos los valores de duración y puntos de cue deben estar en segundos decimales. Los formatos como 3:45 o 0:08.5 no son aceptados porque son ambiguos (podrían representar minutos:segundos u horas:minutos). Necesitarás convertir estos valores tú mismo antes de importar. Consulta Formatos de valores a continuación para más detalles.
El mejor enfoque es exportar primero algunas pistas de PlayIt Live usando la exportación CSV en Administrar Pistas. Esto te proporciona una plantilla con los nombres de columna exactos y los formatos de valores que el importador espera.
Creación de un archivo CSV
El archivo CSV debe tener una fila de encabezado con los nombres de las columnas, seguida de una fila por pista. Puedes crear el archivo en cualquier aplicación de hoja de cálculo y exportarlo como CSV, o escribirlo en un editor de texto.
Ejemplo mínimo
Como mínimo, cada pista necesita una ruta de archivo y una duración:
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,354Ejemplo completo
Un archivo CSV más completo con columnas de temporización y metadatos:
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 columna tiene un formato de valor específico. Usar el formato incorrecto hará que la fila sea omitida durante la importación.
Segundos decimales
Todas las columnas de duración y puntos de cue deben estar en segundos decimales usando un punto (.) como separador decimal.
| Correcto | Incorrecto |
|---|---|
239 | 3:59 |
8.5 | 0:08.5 |
228.75 | 3:48.75 |
0 | 0:00 |
Si tus datos de origen usan el formato minutos:segundos, necesitarás convertirlos. En una hoja de cálculo, puedes usar una fórmula como =MINUTE(A1)*60+SECOND(A1) para convertir un valor de tiempo en la celda A1 a segundos totales.
Texto
Los valores de texto (Artist, Title, Album, etc.) son cadenas de texto simples. Si un valor contiene una coma, el valor completo debe estar entre comillas dobles en el archivo CSV. La mayoría de las aplicaciones de hoja de cálculo manejan esto automáticamente al exportar a CSV.
Booleano
Las columnas booleanas (No Fade, Sweeper, Disabled, Ignore Validity Year?, Gain Set Manually?) aceptan true o false (sin distinción entre mayúsculas y minúsculas). Si la columna falta o está vacía, el valor predeterminado es false.
Fecha
Las columnas de fecha (Valid From, Expires) aceptan formatos de fecha estándar como 2026-01-15. La parte de la hora se ignora.
Decimal
Las columnas decimales (Gain DB, Loudness Target LUFS, Tempo Adjust Percentage) usan un punto (.) como separador decimal. Por ejemplo, -3.5 para una reducción de ganancia de 3,5 dB.
Referencia de columnas
Columnas obligatorias
Solo las columnas Path y Duration son necesarias para una importación válida. Todas las demás columnas son opcionales. Si una columna falta en el encabezado, el campo se deja vacío o se establece en su valor predeterminado.
| Columna | Formato | Descripción |
|---|---|---|
| Path | Texto | La ruta completa al archivo de audio en el disco. Se utiliza para la reproducción y la detección de duplicados. |
| Duration o Duration (seconds) | Segundos decimales | La duración total de la pista (p. ej., 239 o 228.5). |
Información de la pista
| Columna | Formato | Descripción |
|---|---|---|
| Artist | Texto | El nombre del artista o intérprete. |
| Title | Texto | El título de la pista. |
| Album | Texto | El nombre del álbum. |
| Genre | Texto | El género (p. ej., Pop, Rock, Jazz). |
| Year | Texto | El año de lanzamiento. |
| Type | Texto | El tipo de pista. Debe ser uno de los identificadores de tipo indicados a continuación, o dejarse vacío. |
| Tags | Texto | Etiquetas separadas por punto y coma (p. ej., upbeat;classic;80s). |
| Comments | Texto | Comentarios de texto libre sobre la pista. |
| Out Cue | Texto | El texto del Out Cue (p. ej., "and don't it feel good!"). |
| ISRC | Texto | El código ISRC (International Standard Recording Code). |
| Record Label | Texto | El nombre del sello discográfico. |
| Track ID | Texto | Un identificador de pista personalizado. |
Valores de tipo de pista
La columna Type debe usar uno de los siguientes valores exactamente como se muestra a continuación.
| Valor | Descripción |
|---|---|
Song | Una pista musical. |
Station ID | Un jingle de identificación de emisora. |
Promo | Un anuncio promocional. |
Commercial | Un spot comercial o publicitario. |
News | Un boletín informativo o clip de noticias. |
Bed | Una cama de música de fondo. |
Station ID + Bed | Una identificación de emisora combinada con una cama de fondo. |
Si la columna Type se deja vacía, el tipo se inferirá automáticamente.
Puntos de cue y temporización
| Columna | Formato | Predeterminado | Descripción |
|---|---|---|---|
| Intro | Segundos decimales | No establecido | La duración del Intro. El punto en el que comienzan las voces o el contenido principal. |
| Cue In | Segundos decimales | 0 | El punto de Cue In. La reproducción comienza desde este punto. |
| Cue Out | Segundos decimales | Igual que Duration | El punto de Cue Out. La siguiente pista comienza en este punto. |
| Early Out | Segundos decimales | No establecido | El punto de Early Out. Se usa para reproducir un Sweeper con anticipación. |
| Hook Start | Segundos decimales | No establecido | El inicio de la sección Hook de la pista. |
| Hook End | Segundos decimales | No establecido | El final de la sección Hook de la pista. |
Control de reproducción
| Columna | Formato | Predeterminado | Descripción |
|---|---|---|---|
| No Fade | Booleano | false | Establece en true para deshabilitar el Fade de salida en el punto de Cue Out de la pista. |
| Sweeper | Booleano | false | Establece en true para marcar la pista como Sweeper y permitir que se reproduzca sobre otras pistas. |
| Disabled | Booleano | false | Establece en true para deshabilitar la pista de ser programada. |
| Valid From | Fecha | No establecido | La fecha a medianoche a partir de la cual la pista está disponible (p. ej., 2026-01-15). |
| Expires | Fecha | No establecido | La fecha a medianoche después de la cual la pista ya no está disponible (p. ej., 2026-02-15). |
| Ignore Validity Year? | Booleano | false | Establece en true para ignorar la parte del año de Valid From y Expires, de modo que la pista se repita cada año entre esas fechas. Solo tiene efecto cuando están configurados tanto Valid From como Expires. |
Procesamiento de audio
| Columna | Formato | Predeterminado | Descripción |
|---|---|---|---|
| Gain DB | Decimal | No establecido | Ajuste de ganancia de audio en decibelios (p. ej., -3.5). |
| Gain Set Manually? | Booleano | false | Establece en true si el valor de ganancia fue configurado manualmente en lugar de ser detectado automáticamente por el Análisis de Loudness. |
| Loudness Target LUFS | Decimal | No establecido | El objetivo de normalización de loudness en LUFS almacenado por la función de Análisis de Loudness. |
| Tempo Adjust Percentage | Decimal | No establecido | Ajuste porcentual al tempo de reproducción. |
Programación
| Columna | Formato | Descripción |
|---|---|---|
| Dayparting | Texto | Controla cuándo se permite reproducir la pista. El valor comienza con Y (habilitado) o N (deshabilitado), seguido de pares de día y hora separados por punto y coma usando el formato DayCode|Hour. Los códigos de día son Mo, Tu, We, Th, Fr, Sa, Su. Las horas van de 0 a 23. Por ejemplo, Y;Mo|09;Mo|10;Fr|14 habilita la pista los lunes a las 9 y 10 de la mañana, y los viernes a las 2 de la tarde. |
Manejo de errores
- Si una fila contiene un valor con formato incorrecto (p. ej., texto en una columna numérica), esa fila se omite y el error se registra. El resto de la importación continúa.
- Las columnas pueden aparecer en cualquier orden en el archivo CSV.
- Las columnas adicionales no reconocidas por PlayIt Live son ignoradas.
- Si un valor contiene una coma, enciérralo entre comillas dobles (p. ej.,
"Earth, Wind & Fire").