VOCAL DNA

VOCAL DNA Manual de uso | Versión 0.2.0 Laboratorio de afinación vocal con análisis de notas, edición de objetivos, formantes, referencia tonal, captura y exportación de audio. macOS 13+, Apple Silicon e Intel. AUv2 y aplicación independiente. Alcance de esta versión Análisis algorítmico YIN/FFT/cromagrama, sin modelo neuronal. Edición y exportación no equivalen a todas las funciones de Melodyne o Auto-Tune. Captura del editor implementado; no es una captura de Logic.

Guía de uso VOCAL DNA 0.2.0 - LABORATORIO DE AFINACIÓN VOCAL Edición experimental funcional para Logic Pro / Mac Universal COMPATIBILIDAD Binario Universal: Apple Silicon (arm64) e Intel (x86_64), macOS 13.0 o posterior. Compilado en Mac M2 Pro con macOS Ventura 13.4.1. Pruebas ejecutadas en arm64 y x86_64 mediante Rosetta 2. No se ha probado en un Mac Intel fisico. Logic Pro instalado en el equipo: 10.7.9. Formato principal: Audio Unit v2 (.component), efecto mono o estéreo. También se incluye una aplicación independiente para explorar la interfaz. ESTADO REAL DE ESTA ENTREGA Es un plugin de audio compilado, con procesamiento, edición y exportación reales. Es una versión experimental inicial, no una equivalencia comercial completa con Melodyne o Auto-Tune Pro. El análisis es algorítmico (YIN, FFT, cromagrama), sin modelo neuronal entrenado. El nombre «inteligente» describe automatización del análisis y la corrección; no implica un modelo de IA que no está incluido. La version 0.1.0 paso auval. La 0.2.0 se cargo y probo directamente como AUv2 en un proceso aislado, sin instalarla: AudioUnitRender, formatos, reinicio, latencia, buffers y recuperacion del estado anterior. Sus registros estan en docs/. El auval de la 0.2.0 queda pendiente hasta instalar con Logic cerrado. La interfaz de esta compilacion se renderizo para su revision. La prueba de escucha con una voz real y el uso dentro de una sesión de Logic siguen pendientes: el servicio de control de pantalla no estuvo disponible. ABRIR EN LOGIC 1. Cierra y vuelve a abrir Logic Pro para que explore los nuevos Audio Units. 2. En una pista de voz mono o estéreo, abre una ranura Audio FX. 3. Busca Audio Units > Vocal DNA Lab > Vocal DNA. 4. Si no aparece, abre Logic Pro > Settings > Plug-in Manager, busca Vocal DNA y utiliza Reset & Rescan Selection. No borres las cachés de otros plugins. LA ACTUALIZACION 0.2.0 NO SE HA INSTALADO. La copia instalada sigue siendo 0.1.0. Antes de ejecutar el .pkg guarda tus proyectos y cierra Logic. El instalador bloquea la operacion si Logic esta abierto o no puede comprobarlo. El paquete permite solo instalacion personal, sin administrador, y guarda la copia anterior en ~/Library/Audio/Plug-Ins/VocalDNA Backups/. El componente tiene firma local ad hoc. El .pkg no tiene firma Developer ID ni notarizacion. No se han desactivado protecciones de macOS. PRIMERA PRUEBA: AFINACIÓN AUTOMÁTICA - Inserta el efecto en una voz aislada, con una sola nota a la vez. - Selecciona raíz y escala: Chromatic, Major, Minor o Custom. - Empieza con Natural Lead, Mix 100%, Formant 0 y Preserve Formants activado. - Reproduce Logic. INPUT indica la nota detectada; CORRECTION muestra el cambio. - Retune pequeño produce una corrección más rápida; Humanize más alto la suaviza. - Usa BYPASS para escuchar el original con la misma latencia. - Vigila el medidor de salida al modificar Output. SEGUIR LA TONALIDAD DE LA PISTA Opción A: importa un instrumental con REFERENCE FILE. Se estima su tonalidad. Pulsa LEARN KEY para copiarla a los controles o activa FOLLOW REFERENCE. Opción B: en el menú Side Chain de Logic, selecciona el bus de tu instrumental. Reproduce varios compases y activa FOLLOW REFERENCE.

El indicador de confianza es una medida relativa, no una probabilidad calibrada. Escucha y confirma la tonalidad: las modulaciones, notas de paso y acordes ambiguos pueden producir otra lectura. El plugin sigue una tonalidad mayor/menor; no transcribe ni copia la melodía de una mezcla completa, ni separa sus fuentes. EDICIÓN MANUAL 1. Reproduce tu voz en Logic y pulsa TRANSFER; pulsa STOP TRANSFER al terminar. Se capturan hasta 120 segundos por operación. También puedes usar IMPORT VOCAL con WAV, AIFF, FLAC o MP3 compatible. 2. La pantalla muestra el audio, sus notas detectadas y la curva de tono original. 3. Pulsa SNAP NOTES para fijar las notas a la escala seleccionada. 4. Arrastra una nota verticalmente o usa NOTE PITCH para ajustes en semitonos con resolución de 0,01. Activa USE NOTE EDITS para escuchar los objetivos. 5. Alt + arrastrar mueve una nota en el tiempo; Shift + arrastrar cambia su duración. 6. Clic derecho permite dividir una nota, restaurarla o quitar su corrección. 7. NOTE GAIN cambia el volumen de la nota seleccionada en el WAV exportado. 8. TIMING 1/16 ajusta posición y duración a semicorcheas según el tempo de Logic. 9. UNDO / REDO recuperan hasta 32 pasos de edición de notas. 10. PLAY CLIP reproduce el audio transferido/importado a través del efecto. STOP detiene esta reproducción. Logic debe mantener activo el audio de la pista. La inserción en vivo y PLAY CLIP aplican los cambios de tono a las posiciones originales de la voz. Los cambios de TIEMPO, DURACIÓN y GANANCIA POR NOTA se escuchan en EXPORT WAV; no reescriben las regiones de Logic automáticamente. La edición destructiva de una región de Logic y ARA no están implementadas. Importa el WAV exportado a una pista para escuchar todos los cambios juntos. CONTROLES EXACTOS Doble clic sobre una perilla: escribir valor. Shift + arrastrar: ajuste fino. Los campos aceptan unidades y coma decimal; rechazan texto, valores no finitos y valores fuera del rango, conservando el ajuste anterior. NAVEGACIÓN Rueda: desplazar el registro del piano. Cmd + rueda: cambiar el zoom temporal. Shift + rueda: desplazar la vista temporal. VIEW: segundos visibles. Flechas arriba/abajo: mover nota seleccionada. Delete: quitar la corrección de la nota. Cmd+Z / Cmd+Shift+Z: deshacer/rehacer. Los botones C...B de Custom representan intervalos relativos a la raíz. EXPORTACIÓN Y GUARDADO EXPORT WAV escribe estéreo PCM de 24 bits a la frecuencia del archivo original. Compensa los 2048 samples de latencia y aplica afinación, notas, tiempo, volumen, formantes, transposición, mezcla y salida. Se escribe primero un archivo temporal. Los cambios extremos de duración o tono pueden producir artefactos. Logic guarda parámetros, origen temporal, ruta del audio y ediciones de notas. Las transferencias se guardan además como WAV en: ~/Library/Application Support/VocalDNA/Captures/ Los archivos importados se enlazan por su ruta original. Conserva esos archivos. El audio no se incrusta dentro del archivo del proyecto Logic. Para mover una sesión a otro Mac, conserva el WAV original/transferido y expórtalo junto al proyecto. Si falta la fuente, IMPORT VOCAL vuelve a adjuntarla conservando las notas restauradas. Asegúrate de elegir exactamente la misma toma original. A/B compara configuraciones de parámetros; no crea dos versiones de la edición de notas. Los cuatro presets ajustan Retune, Humanize, Drift y Vibrato sin cambiar la tonalidad ni el resto de tus controles. Sus valores son automatizables en Logic.

LATENCIA Y LÍMITES Latencia declarada y medida: 2048 muestras (42,67 ms a 48 kHz; 46,44 ms a 44,1 kHz). Para grabar monitorizando la voz, esta latencia puede resultar perceptible. Está orientado a la edición y reproducción de voces ya grabadas. Detector monofónico: aproximadamente 55-1100 Hz. No afina acordes ni coros polifónicos en una sola pista. Usa una instancia por voz aislada. Corrección total del motor limitada a ±12 semitonos. Objetivos más lejanos, transposición sumada o cambios fuertes de duración pueden llegar a ese límite. Máximo 120 s por captura/importación y 2048 notas por clip. Formantes: compensación espectral aproximada, no reconstrucción vocal neuronal. ARCHIVOS Source/: motor DSP, procesador Audio Unit e interfaz. Tests/: pruebas de frecuencia, latencia, captura, edicion, exportacion, sidechain, Audio Unit nativo y protecciones del instalador. Fixtures contiene un estado real de la 0.1.0 para comprobar que sus 16 IDs de parametros siguen siendo los mismos. Packaging/: fuentes del .pkg y utilidades de desinstalacion/restauracion. third_party/: JUCE 8.0.12 y sus avisos de licencia. Build.command: compilar AU y aplicacion Universal, y pruebas con CMake 3.22+ y Apple Command Line Tools. El código de JUCE se extrae automáticamente del archivo incluido. docs/: funciones, validación y capturas de la interfaz real. DESINSTALAR / VOLVER ATRAS Con Logic cerrado, ejecuta Desinstalar Vocal DNA.command del paquete completo. Retira solo este componente a una carpeta recuperable; no elimina audio, proyectos ni capturas. El recibo de Installer puede permanecer. Restaurar version anterior.command recupera la copia de seguridad mas reciente, conservando tambien la version que sustituye. No se ejecuta automaticamente. LICENCIA DE ESTA ENTREGA Código entregado bajo AGPLv3, con el texto en LICENSE.txt. JUCE incluye también una modalidad comercial alternativa descrita en third_party/JUCE-LICENSE.md. Este paquete contiene el código correspondiente a la compilación entregada.