tofucurd/score-sync-video

Video sincronizado con partitura y portadas

A partir de MusicXML/MXL, una partitura PDF original y una grabación real, crea un video continuo sincronizado con la partitura. Utiliza papel de color, la fuente Source Han Serif, un cursor azul fijo, una sola columna de partitura en desplazamiento, resaltado continuo de notas y una navegación de estructura de dos niveles. La información de la obra, la ruta de interpretación, el tiempo, la estructura y los colores son determinados por el proyecto actual; no se incluyen partituras, grabaciones, anclajes o revisiones de proyectos de ninguna obra. Los materiales originales son de solo lectura.

Versión 1.0.1. Consulta la lista de componentes y huellas digitales para los componentes, y registro de validación para el alcance de la validación. Las condiciones de instalación están en el README. El diseño de la partitura es proporcionado por Verovio; las licencias de terceros están en la declaración.

Entorno y punto de entrada

Ejecuta python3 scripts/bootstrap.py y posteriormente usa el Python independiente que genera. scripts/score_sync.py doctor verifica POSIX, Python, Node, FFmpeg/FFprobe, Chromium y la compatibilidad de codificación, sin renderizar. Las rutas de navegador no estándar se especifican con SCORE_SYNC_CHROME.

.runtime/bin/python scripts/score_sync.py init \
  --project /absolute/project/project.json \
  --score /absolute/score.mxl --pdf /absolute/original.pdf \
  --audio /absolute/recording.flac --title "Título de la obra" --composer "Compositor"

Proporciona un score/audio por cada movimiento; el PDF puede ser compartido. El XML de la obra completa se divide primero en copias de trabajo para cada movimiento real. Completa los nombres de los intérpretes, la orquesta, los nombres y números de los movimientos; si no hay número, déjalo en blanco. Consulta la interfaz del proyecto para el formato; no hagas que usuarios sin conocimientos musicales creen índices de compás.

Flujo de trabajo

1. Verifica la fuente de la partitura y la ruta. prepare analiza los eventos y la partitura nativa. Revisa el PDF página por página para verificar notas, silencios, transportes, ritmo, adornos, ligaduras y expresiones; las correcciones basadas en evidencia se escriben en una copia separada. Los signos de repetición/saltos reales se escriben en source_route, sin asumir que se hacen todos o ninguno. Fuente de la partitura y estructura explica las restricciones de identidad y diseño de la partitura.
2. Alinea con la grabación real. Por defecto, align usa una coincidencia multietapa refined, generando candidatos, evidencia de adornos y una auditoría completa de puntos de ataque. Revisa la ruta completa, texturas rápidas, entradas, cambios de tempo, secciones repetidas y codas; complementa las restricciones de identidad de la fuente con evidencia de la grabación, y luego actualiza los mapeos afectados. Algoritmo de alineación proporciona fórmulas y parámetros. coarse es solo un punto de entrada de diagnóstico para candidatos antiguos.
3. Completa la estructura y el diseño visual. Rellena manualmente structure.json de dos niveles, secciones de voces naturales, materials.json, etiquetas y la configuración de la portada. Los materiales compartidos entre instrumentos mantienen el color; las relaciones desconocidas usan el color principal. Todo el contenido de la estructura proviene de la obra actual; los elementos incompletos no pueden incluirse en la vista previa. Consulta Especificaciones visuales para más detalles.
4. Registra revisiones reales. Los archivos pdf-review.json y alignment-review.json correspondientes a la partitura/grabación actual se completan con el trabajo real. preflight verifica los enlaces, los datos de escena y la configuración de la portada, sin iniciar el navegador. Los cambios en la fuente de la partitura, la ruta, la grabación o el recorte invalidan alignment-inputs.json; no se puede simplemente cambiar el hash para fingir una nueva revisión.
5. Crea y revisa la vista previa. Por defecto, los primeros 30 segundos de cada movimiento, además de fotogramas de alta definición reales, portadas en dos proporciones y un PDF de revisión. Verifica secciones rápidas, páginas densas, transiciones y muestras de codificación final real. Tres agentes humanos reales ven cada plan completo de forma independiente y realizan una revisión cruzada; si no es posible la concurrencia, se puede revisar de forma secuencial e independiente, sin falsificar nombres o aprobaciones. Repara y revisa según los problemas encontrados, sin número fijo de iteraciones.
6. Congela y renderiza después de la confirmación. Los proyectos nuevos entregan la vista previa para confirmación por defecto, luego usan approve --statement "Frase de confirmación real" para registrar la autorización y render para renderizar. Para correcciones del mismo usuario en una tarea ya autorizada, se mantiene la autorización original; después de actualizar las vistas previas/revisiones afectadas, se vincula una nueva huella digital con approve --inherit --statement "Instrucción de corrección real". Una vez congelado, concéntrate en el renderizado; no modifiques los elementos artísticos por tu cuenta.
7. Reanudación y entrega. Cuando el usuario pausa, solo se detiene el renderizado de este proyecto, manteniendo los fragmentos completos; resume reanuda el renderizado. Una vez pasadas las comprobaciones necesarias, entrega el video final, las portadas y los capítulos, sin añadir revisiones sin plazo. clean solo lista el caché por defecto; solo aplica clean --apply cuando está autorizado. Especificaciones de entrega explican el audio, los capítulos, la reanudación y la gestión del espacio.

Restricciones del video final

• Por defecto: 3840×2160, 60fps, HEVC Main44410 MOV, con el audio original sin pérdidas encapsulado. El audio es el único reloj maestro: no se normaliza, no se cambia la velocidad, no se cortan los finales de las notas, no se añade silencio entre movimientos para cuadros completos.
• Sin narración, pausas de clase, repeticiones de fragmentos, pistas MIDI, SRT, subtítulos didácticos, cajas de motivos adicionales o decoraciones abstractas; se mantienen la estructura actual y las etiquetas cortas de los movimientos en la navegación.
• Las notas visibles de la interpretación real tienen enlaces gráficos rastreables e intervalos de resaltado completos. Se mantienen las relaciones de plicas, puntillos y pentagramas; las notas no se deforman.
• Las voces que han sonado en pasajes naturales y las notas que se mantienen a través de secciones se conservan; no se ocultan repetidamente por uno o dos compases de silencio. Los límites de las voces son fijos; el mismo peso de 4 segundos controla la transparencia y el espacio, sin iniciar una segunda expansión.
• La línea azul vertical es fija; la partitura se desplaza horizontalmente. El color principal y los colores de materiales limitados siguen continuamente la relación musical, no solo cambian de color por instrumento.
• La navegación de dos niveles usa navigation.py en su totalidad: título actual, etiqueta de párrafo centrada, sección actual en azul, puntero vertical corto, separador de color de papel de 8px y transiciones de padre/hijo/movimiento. El ancho y el puntero se calculan a partir de la muestra de grabación real.
• La fuente utilizada es solo Source Han Serif incluida; los glifos musicales nativos se conservan. La portada se extrae de la partitura nativa de la obra actual; se seleccionan dos proporciones de forma independiente; el texto de categoría es opcional; no se utilizan partituras de otras obras para decoración.
• Solo se usan engraving_overrides/layout_overrides con identidad, valor antiguo y validación de salida para correcciones de diseño. Cuando cambia la geometría o el ID, se revisa de nuevo; no se mueven coordenadas antiguas a ciegas.

El MOV final incrusta los nombres y los puntos de inicio de los movimientos; también se entregan B站章节.txt y chapters.json. Los límites provienen de las muestras PCM acumuladas reales de la unión; no se pueden sustituir con la velocidad de la partitura, duración estimada o número de fotogramas.

Límites de aplicación

La alineación automática es candidata. El tempo libre, las texturas repetitivas, las notas débiles y los adornos enmascarados requieren revisión de evidencia; no se puede afirmar que se obtengan valores reales de ataque físico por instrumento de una sola vez automáticamente. La corrección editorial, la estructura y la combinación de colores tampoco están automatizadas.

Acepta MusicXML/MXL partwise; timewise, microtonos, obras principalmente sin tono fijo y modificaciones complejas deben adaptarse primero. Las tasas de muestreo mixtas y los límites attacca se especifican en las especificaciones de entrega. Solo cuando se revisa código/datos, no se llama a preview, covers, render ni a la salida PDF.

La interfaz general de instantáneas de referencia locales puede restaurar datos ya revisados que el usuario posee. El repositorio público no incluye instantáneas de obras específicas; las instantáneas no se pueden aplicar a diferentes grabaciones ni otorgan aprobación a nuevos usuarios.