Manual de Operación de Cabina · v2.5.15 Oficial

TrackAI v2.5.15
Copiloto Universal de Mezcla en Vivo

Guía integral de ingeniería y flujo de trabajo en cabina para Serato DJ (Pro/Lite 3.x/4.x), Virtual DJ y Rekordbox. Motor armónico Camelot con Live Pitch® Neural, lectura sombra en RAM y carga instantánea a los platos A/B.

Versión Canónica v2.5.15 (Compilación Oficial)

Softwares DJ Serato · Virtual DJ · Rekordbox

Sistemas Soportados macOS (Apple Silicon/Intel) · Win 10/11

Latencia de Lectura < 0.1 ms (Cero Bloqueos)

1. Visión General y Filosofía de Diseño

TrackAI v2.5.15 es un copiloto de inteligencia armónica y predicción musical en tiempo real diseñado específicamente para DJs profesionales. Su objetivo principal es erradicar la fatiga mental de búsqueda de canciones durante sesiones en vivo, garantizando transiciones limpias y fluidas.

+------------------------------------------------------------------------+ | ARQUITECTURA MULTI-SOFTWARE EN VIVO (TRACKAI v2.5.15) | +------------------------------------------------------------------------+ [ Serato DJ Pro/Lite ] [ Virtual DJ ] [ Rekordbox ] │ │ │ ▼ ▼ ▼ ┌──────────────────────────────────────────────────────────────────────┐ │ MOTOR DE DETECCIÓN AUTOMÁTICA EN CALIENTE (Zero-Lag Shadow Sync) │ └──────────────────────────────────────────────────────────────────────┘ │ ┌──────────────────┴──────────────────┐ ▼ ▼ ┌───────────────────────────┐ ┌───────────────────────────┐ │ MOTOR ARMÓNICO CAMELOT │ │ CEREBRO IA (Brain.js) │ │ • Key Match & Live Pitch │ │ • Memoria de Transiciones │ │ • Compatibilidad de BPM │ │ • Anti-repetición 45 días │ └───────────────────────────┘ └───────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────────────────────────────┐ │ INYECCIÓN EN 1-CLIC AL PLATO A / PLATO B (AppleScript / Win32 PS) │ └──────────────────────────────────────────────────────────────────────┘

🔒 Privacidad y Rendimiento 100% Offline-First: TrackAI nunca sube tus archivos de audio ni invade tu privacidad. Analiza exclusivamente las bases de datos de metadatos locales de tu software en memoria RAM con verificación criptográfica instantánea.

2. Conexión en Tiempo Real con Serato DJ (Pro & Lite)

TrackAI incluye un controlador nativo de alto rendimiento para Serato DJ 3.x y 4.x. Funciona leyendo el historial activo y la biblioteca general en modo réplica sin interferir con el motor de reproducción de Serato.

2.1. Tecnología de Lectura Sombra (Shadow DB Sync)

Para evitar colisiones de base de datos tipo database is locked mientras Serato escribe el historial en vivo, TrackAI utiliza una arquitectura de copia en sombra en memoria volátil:

Ruta Original Serato: ~/Library/Application Support/Serato/Library/master.sqlite (macOS) o %LOCALAPPDATA%\Serato\Library\master.sqlite (Windows).
Copia Sombra en RAM: /tmp/trackai-shadow/master.sqlite sincronizada periódicamente y durante el arranque.
Soporte WAL (Write-Ahead Logging): TrackAI procesa automáticamente los archivos master.sqlite-wal y master.sqlite-shm ejecutando checkpoints de truncamiento transparentes.

⚡ Detección de Now Playing en 4 Platos: TrackAI consulta la tabla session y asset de Serato cada 1.5 segundos. Detecta al instante cuál pista acaba de entrar a los platos 1, 2, 3 o 4, extrayendo su BPM, Tonalidad Camelot, Artista, Nombre y Crate de origen.

2.2. Esquema de Extracción de Metadatos de Serato

Campo Serato	Mapeo TrackAI	Propósito en el Motor
`asset.bpm`	`track.bpm`	Cálculo de tolerancia de tempo (±3%, ±6%, saltos de ritmo).
`asset.key`	`track.key / camelot`	Normalización a notación Camelot (1A-12B) para armonía.
`asset.genre / crate`	`track.genre`	Agrupación contextual de continuidad de estilo.
`session.play_time`	`track.playCount`	Penalización inteligente de temas sobre-tocados.

2.3. Checklist para Serato DJ

Abre Serato DJ Pro o Lite y asegúrate de que tu biblioteca esté analizada (BPM y Key visibles).
Abre TrackAI: el indicador superior se iluminará en verde: SERATO DJ ACTIVO.
Arrastra una canción al plato en Serato: en menos de 0.1s TrackAI te mostrará las 5 mejores opciones recomendadas.

3. Integración Multi-Software (Virtual DJ y Rekordbox)

TrackAI no está atado a una sola marca. Si trabajas con Virtual DJ o Rekordbox, la app detecta automáticamente el proceso en ejecución y conmuta el motor de análisis en tiempo real.

🎛️ Virtual DJ 2021 / 2023 / 2024

Lectura ultrarrápida del archivo central database.xml ubicado en Documentos de VirtualDJ.

Parser SAX Zero-Allocation: Lee bibliotecas de más de 50.000 canciones sin saturar la memoria RAM.
Detección de Decks A y B: Monitorea cambios de etiquetas <Song> y <Tags Flag="Played">.
Sincronización de Tags: Lectura de BPM decimales y notas musicales (Camelot, OpenKey o Clásicas).

📀 Rekordbox (v6 y v7)

Sincronización híbrida de colección local mediante exportación XML o base de datos SQLite de Pioneer DJ.

Análisis Armónico Nativo: Reconoce el cálculo de tono dinámico y grid de Rekordbox.
Historial de Sesión en Vivo: Captura la lista de reproducción histórica HISTORY del set.
Carga por Clipboard Focus: Asistencia rápida por atajo para cargar a la cubierta seleccionada.

3.1. Conmutación en Caliente (Auto-Detect Hot Switch)

¿Tienes instalado Serato y Virtual DJ en la misma computadora? No necesitas configurar nada ni reiniciar la aplicación:

1. Si Serato está abierto ──────────► TrackAI activa el motor master.sqlite 2. Si cierras Serato y abres VDJ ──► TrackAI conmuta a database.xml en 1.5s 3. Si ambos están abiertos ────────► Prioriza el software que tenga audio activo

💡 Modo Híbrido Streaming (TIDAL, SoundCloud, Beatport): Si reproduces pistas desde servicios de streaming en Serato o Virtual DJ, TrackAI analiza la pista en reproducción actual y busca los matches armónicos en toda tu biblioteca local offline.

4. El Motor Armónico Camelot y Algoritmo de Mezcla

El corazón de TrackAI es un motor de armonía matemática basado en la Rueda Camelot. Cada tonalidad musical se asigna a un número del 1 al 12 y una letra (A para tonalidades Menores, B para tonalidades Mayores).

4.1. Reglas de Transición Armónica y Puntuación

Tipo de Salto	Ejemplo de Tonalidad	Efecto Psicoacústico en la Pista	Score Base
Match Directo (Identidad)	`8A ➔ 8A` (La menor)	Mezcla perfecta, fusión total de frecuencias e intros.	100 pts
Energy Boost (+1 Hora)	`8A ➔ 9A` (Mi menor)	Eleva sutilmente la energía y emoción del público.	90 pts
Descompresión (-1 Hora)	`8A ➔ 7A` (Re menor)	Baja la tensión suavemente; ideal para transicionar a coros.	85 pts
Cambio Relativo (A ⟷ B)	`8A ➔ 8B` (Do mayor)	Mantiene la misma escala raíz pero cambia de oscuro a brillante.	80 pts
Energy Jump (+2 Horas)	`8A ➔ 10A` (Si menor)	Impacto eufórico; salto armónico potente para momentos clímax.	75 pts

4.2. Live Pitch® Neural (Compensación Armónica de Pitch)

Cuando alteras la velocidad de un track en el pitch fader de tu consola, la tonalidad original puede subir o bajar si no tienes activado el Master Tempo / Key Lock.

🧠 Algoritmo de Compensación de BPM: TrackAI calcula la compatibilidad armónica ponderada por la diferencia de BPM: $$Score_{Total} = Score_{Camelot} \times \left(1 - \frac{|\Delta BPM|}{BPM_{Max}}\right) + Bonus_{Crate}$$ Si una pista requiere un ajuste menor al 3%, TrackAI le otorgará la máxima prioridad en el listado.

5. Los Modos de Recomendación y el Cerebro IA (Brain.js)

TrackAI ofrece tres modos de recomendación dinámica en cabina para responder exactamente a lo que el público necesita en cada etapa del set.

📚 Modo Continuidad (Misma Carpeta)

Ideal para mantener la vibra actual (ej. sesión de Tech House, Reggaeton Old School, Afrobeat).

Filtra estrictamente dentro del mismo Crate, carpeta o género.
Tolerancia estricta de BPM: ±4%.
Garantiza que el set suene cohesivo y consistente.

⚡ Modo Cambio de Ritmo / Energía

Diseñado para girar la noche o transicionar entre géneros musicales diferentes.

Permite saltos de tempo calculados (ej. de 95 BPM a 128 BPM mediante mezclas puente).
Explora Crates secundarios con alta afinidad armónica.
Evita baches de sonido o silencios abruptos.

5.1. El Cerebro IA (Memoria Colectiva & Red de Transiciones)

El motor brain.js de TrackAI actúa como una memoria artificial de mezclas que evoluciona contigo:

Memoria de Éxito: Si en un show mezclas la Canción A seguida de la Canción B y la dejas sonar más de 90 segundos, el Cerebro IA registra la conexión como una transición dorada y la priorizará en tus próximas presentaciones.
Regla Anti-Repetición (45 Días): Para evitar que toques mecánicamente la misma secuencia cada fin de semana, TrackAI aplica un factor de enfriamiento temporal a las parejas de canciones ejecutadas recientemente.
Rescate de Gemas Olvidadas: Pistas de tu biblioteca con coincidencia armónica perfecta que llevan meses sin sonar reciben un bonus de sugerencia.

6. Carga Instantánea al Plato (A/B) y Atajos de Teclado

Olvídate de teclear en el buscador de Serato o arrastrar con el mouse en medio del show. Con TrackAI, cargar cualquier recomendación toma exactamente un toque de teclado.

6.1. Protocolo de Inyección Nativa Multiplataforma

En macOS: Utiliza eventos de AppleScript ultrarrápidos con asignación directa al proceso de Serato DJ o Virtual DJ.
En Windows (Win32): Inyección con PowerShell optimizado y SetForegroundWindow. Regla de Oro: Nunca envía la tecla ESC (la cual cerraría el buscador y deseleccionaría la biblioteca en Serato).
Smart Clipboard Fallback: Si faltan permisos del sistema operativo, TrackAI copia automáticamente el nombre exacto de la pista al portapapeles para que baste con presionar Cmd+V o Ctrl+V.

6.2. Mapa Completo de Atajos de Cabina

Atajo de Teclado	Acción Inmediata en Cabina
1 o A	Cargar la canción seleccionada al Plato Izquierdo (Deck A / Plato 1).
2 o B	Cargar la canción seleccionada al Plato Derecho (Deck B / Plato 2).
↑ / ↓ (Flechas)	Navegar hacia arriba o abajo entre la lista de recomendaciones.
Espacio	Preescucha rápida o alternar vista de tarjeta expandida.
R	Forzar Refresco: Relee la biblioteca en disco de inmediato.
F	Poner foco en el buscador asistido de TrackAI.

7. Licenciamiento Offline-First y Resolución de Problemas

7.1. Sistema de Licencia Criptográfica Local (ECDSA P-256)

TrackAI no depende de servidores externos para tocar en vivo. Tu llave de licencia PRO es un token criptográfico firmado que se valida localmente en memoria RAM en 6 milisegundos.

Sin Conexión a Internet Requerida: Puedes tocar en discotecas subterráneas, festivales en zonas rurales o cabinas sin WiFi. TrackAI no se bloqueará ni mostrará pantallas de carga.
Revalidación Inteligente: Solo consulta la red si la licencia expiró o al activar una nueva llave explícitamente.

7.2. Exportación de Sesión y Análisis Web 3D

Al finalizar tu set, TrackAI guarda un reporte estadístico en ~/Documents/TrackAI-Sets/ con el historial completo de la noche: gráfico de evolución de BPM, tonalidades exploradas y duración de cada mezcla.

7.3. Guía de Solución de Problemas (Troubleshooting)

🍎 Solución en macOS:

Si aparece "App dañada", ejecuta en Terminal:
xattr -cr /Applications/TrackAI.app
Concede permisos en Ajustes del Sistema ➔ Privacidad y Seguridad ➔ Accesibilidad & Automatización.

🪟 Solución en Windows:

Si aparece SmartScreen ("Windows protegió su PC"), haz clic en Más información ➔ Ejecutar de todas formas.
Ejecuta TrackAI como usuario normal (no requiere modo Administrador).

🎧 Soporte Técnico y Comunidad DJ: Para asistencia directa o consultas sobre compatibilidad con tu controladora/consola, escríbenos a contacto@tusitioya.cl o ingresa a trackai.tusitioya.cl.