Manual de Usuario AulaChord: Índice Maestro

"Domina la herramienta, libera tu creatividad. Guía exhaustiva de cada función del software."

0. El Manifiesto: ¿Qué es esto y por qué debería importarme?

Sección para el músico que aterrizó aquí por accidente o curiosidad.

• 0.0 El Viaje del Músico: Del Problema a la Promesa
  • Acto I: La Parálisis ante el Pentagrama — La brecha entre lo que escuchas y lo que puedes escribir.
  • Acto II: La Revelación (El Eslabón Perdido) — AulaChord como traductor en tiempo real.
  • Lógica Determinista, No "Cajas Negras" — Certeza matemática vs. predicción de IA.
  • Acto III: La Promesa — Música como Geometría Visual — Ver la armonía como arquitectura viva.
• 0.1 Para Quiénes Creamos AulaChord (Historias Reales, No Estadísticas):
  • María: La pianista gospel que toca de oído.
  • Carlos: El estudiante de conservatorio en examen final.
  • Ana: La profesora que enseña online a 40 estudiantes.
  • Javier: El arreglista profesional contra reloj.
  • Pablo: El YouTuber que crea tutoriales de piano.
• 0.2 Por Qué AulaChord es Diferente (Características Únicas Verificadas):
  • Motor Harmonia (análisis funcional en tiempo real).
  • Sistema Unificado de Nombrado (Nombres Dorados, Filtros Pedagógicos).
  • Motor de Conducción (validador de conducción de voces en el pentagrama).
  • Panel del Tutor (sugerencias de caminos creativos, Ctrl/Cmd + T).
  • Control enarmónico preciso (QWERTY de 3 filas).
  • Compatibilidad sin límites (MIDI Bluetooth, Auto-escaneo, MusicXML).
  • Puente profesional con IA (AI Assistant, Importación Inteligente, Persistencia Educativa).
• 0.3 Tu Primer Contacto: 7 Minutos para Cambiar Tu Forma de Ver la Música:
  • Checkpoint 1: Tu primer acorde (30 segundos).
  • Checkpoint 2: El Motor de Conducción en Acción (1 minuto).
  • Checkpoint 3: Visualiza los errores de conducción (30 segundos).
  • Checkpoint 4: Solicita ayuda al Tutor (1 minuto).
  • Checkpoint 5: Smart Paste — La magia que acelera todo (1 minuto).
  • Checkpoint 6: Explora el diapasón de guitarra (1 minuto).
  • Checkpoint 7: Modo Intérprete para clase/stream (1 minuto).
  • Checkpoint 8: Consulta al AI Assistant (1 minuto).
• 0.4 Preguntas Frecuentes del Recién Llegado:
  • ¿Qué es AulaChord exactamente? Un laboratorio de armonía en tiempo real.
  • ¿Reemplaza mi software actual? No, lo potencia (exporta a MusicXML).
  • ¿Tengo que saber solfeo o leer partitura? No es obligatorio.
  • ¿Puedo usarlo si solo toco guitarra? Absolutamente sí.
  • ¿Necesito equipo caro o piano MIDI? No (funciona con QWERTY).
  • ¿Funciona sin conexión a internet? Sí, 100% offline.
  • ¿Qué modos armónicos soporta? Análisis Auto (Tonal) y 6 modos griegos complementarios.
  • ¿Puedo transcribir canciones rápidamente? Sí, con Smart Paste.
  • ¿Esto sustituye a mi profesor? Nunca. Es un asistente complementario.
  • ¿Qué gano usándolo 10 minutos al día? Comprensión visual profunda de la música.

1. Anatomía de la Interfaz (El Mapa Visual)

Entiende cada elemento de la pantalla.

• 1.1 La Barra de Herramientas: Tu Puesto de Mando:
  • Semáforo de Entrada (Botón ON/OFF): Verde (ON), Rojo (OFF).
  • Selectores de Instrumento (Iconos Piano/Guitarra).
  • Armadura de Clave: Atajos Ctrl/Cmd + → (sostenido), Ctrl/Cmd + ← (bemol), Ctrl/Cmd + D (reset).
  • Selector de Duración: Teclas 5 (negra), 6 (blanca), 7 (redonda), . (puntillo).
  • Modo de Conducción de Voces: SATB Estricto, Teclado Estricto, Libre (Teclado).
  • Contexto Armónico: Modalidad (Auto (Tonal), Dórico, Frigio, Lidio, Mixolidio, Eólico, Locrio).
  • Selectores MIDI: Input/Output con detección automática.
• 1.2 El Espacio de Trabajo (Workspace):
  • Pentagrama Dinámico (Grand Staff).
  • Cifrado Americano Flotante: Cicla posición con tecla , (coma).
  • Cifrado Romano Flotante: Cicla visualización con tecla , (coma).
  • El Splitter Vertical: Redimensionable entre pentagrama e instrumentos.
• 1.3 El Panel Inferior: Toca con lo que Tengas a Mano:
  • Zona de Piano Virtual:
    • 88 notas interactivas (A0-C8).
    • Código de Colores del Teclado: Amarillo (acorde activo), Azul (selección), Rojo (infracciones). En Modo Digitación: Cian y Rosa.
    • Modo de Digitación.
    • Indicador de Octava.
  • Zona de Diapasón de Guitarra:
    • Botón Construir Acorde.
    • Flecha hacia Arriba (Commit).
    • Botón Guías: Muestra nombres de notas diatónicas según tonalidad.
• 1.4 Los Paneles Flotantes: Tus Colegas Silenciosos:
  • Panel de Análisis Armónico (Ctrl/Cmd + 3): Ventana flotante con bloques de cifrado americano, romano y contexto didáctico.
  • Panel del Tutor (Ctrl/Cmd + T): Ventana flotante con validación y sugerencias creativas.
  • Laboratorio de Voicings (Ctrl/Cmd + 4): Taller interactivo documental para orquestar voces, aplicar Drops e Inversiones en bloque.
  • Ventana del Intérprete (M): Modo de proyección en vivo para clases y presentaciones.
  • AI Assistant (Ctrl/Cmd + Shift + A): Generador de prompts para ChatGPT, Gemini, Claude.
  • Captura de Pentagrama (Ctrl/Cmd + Shift + I): Copia capturas de alta resolución al portapapeles.
  • Exportación a MusicXML (Menú Archivo): Exporta a MusicXML 4.0 para MuseScore, Sibelius, Finale.
  • Panel de Atajos de Teclado (Menú Ayuda): Referencia completa de comandos y atajos.
• 1.5 La Barra de Estado (Footer): El Susurrador:
  • Indicador de Octava: Registro actual para entrada QWERTY.
  • Monitor de Mensajes: Alertas, confirmaciones, estado del sistema.
• 1.6 Funciones de Copia de Análisis (Menú Edición):
  • Copiar Cifrado Americano (Ctrl/Cmd + Shift + C).
  • Copiar Cifrado Romano (Ctrl/Cmd + Shift + R).

2. Configuración Técnica y Entorno

Prepara tu estudio virtual para el éxito.

• 2.1 ¿Por qué no suena? (El concepto clave):
  • AulaChord como motor MIDI puro: envía señales al exterior.
  • Libertad total para conectar el sintetizador o DAW de tu elección.
• 2.2 Instalación y Primer Inicio:
  • Compatibilidad con Windows 10/11 y macOS (Intel y Silicon M1/M2/M3).
  • Configuración silenciosa: user_settings.json generado automáticamente.
  • Consejo de recuperación: eliminar user_settings.json para resetear preferencias.
• 2.3 Guía de Sonido para Windows:
  • Opción A — Librerías de sonidos recomendadas + loopMIDI: Spitfire Audio LABS, Splice Instrument.
  • Opción B — Tu DAW (Ableton, FL Studio, Reaper...): loopMIDI como cable virtual.
  • Consejo de latencia: driver gratuito ASIO4ALL.
• 2.4 Guía de Sonido para macOS:
  • Opción A — Librerías de sonidos recomendadas + IAC Driver: configuración en Audio MIDI Setup.
  • Compatibilidad con GarageBand, Logic Pro, Ableton, MainStage.
• 2.5 Conectando tu Teclado (Entradas MIDI):
  • Plug & Play USB: escaneo automático cada 2 segundos.
  • Refrescar MIDI manual (Ayuda → Refrescar MIDI).
  • MIDI Bluetooth compatible.
  • Seguridad Anti-Bucles (Loopback): bloqueo automático.
• 2.6 Gestión de Archivos y Preferencias:
  • Formato .aula: JSON plano con eventos, armadura, modo armónico y metadatos IA.
  • Exportación a MusicXML (MuseScore, Sibelius, Finale, Dorico).
  • Reparación automática de archivos corruptos (JSON Repair).
  • Persistencia de configuración en user_settings.json.

3. Entradas QWERTY, MIDI y otras

Detalle técnico de cómo entra la música al sistema.

• 3.1 Teclado MIDI Externo:
  • Sincronización Note On/Off.
  • Detección automática y MIDI Bluetooth.
• 3.2 Teclado QWERTY (Las 3 Filas):
  • Fila Superior (W-I): Sostenidos (Do#, Re#, Fa#, Sol#, La#…).
  • Fila Media (A-K): Notas blancas (Do, Re, Mi, Fa, Sol, La, Si…).
  • Fila Inferior (Z-N): Bemoles (Reb, Mib, Solb, Lab, Sib…).
  • Control de Octavas: ↓ (bajar), ↑ (subir).
  • Agrupación automática de acordes de bloque.
• 3.3 Piano Virtual en Pantalla:
  • Interacción con ratón y multitouch.
  • Código de colores: Amarillo (notas activas), Azul (nota seleccionada), Rojo (infracciones de conducción).
  • Modo de Digitación.
• 3.4 Diapasón de Guitarra:
  • Construcción punto a punto.
  • Commit con Enter o flecha arriba.
  • Botón Guías para colores didácticos.
• 3.5 Pegar desde Portapapeles (Ctrl/Cmd + V):
  • Reconocimiento de texto con acordes.
  • Extracción de acordes desde letras (ignora palabras no musicales).
  • Parsing de JSON de ChatGPT/Gemini.
  • Integración con AI Assistant.
  • 3.5.1 Copia Interna (Voicing Exacto): Ctrl/Cmd + C dentro de AulaChord clona la disposición exacta de voces sin reinterpretación.
• 3.6 Control del Flujo de Trabajo:
  • Monitor (OFF) vs Escritura (ON).
  • Override Manual: Ctrl/Cmd + ↑/↓ (semitono), Ctrl/Cmd + Alt + ↑/↓ (octava), Q (enarmonía).

4. 🎹 El Piano: Arquitectura y Conducción

Lógica profunda del panel de teclado.

• 4.1 Lógica de Escritura Automática:
  • Smart Split Point (regla de brecha de 7 semitonos).
  • Corrección manual de distribución (Ctrl/Cmd + ↑/↓ semitono, Ctrl/Cmd + Alt + ↑/↓ octava).
• 4.2 Modos de Conducción:
  • SATB Estricto: máxima vigilancia académica.
  • Teclado Estricto: balance entre rigor y libertad.
  • Libre (Teclado): permiso de paralelismos.
• 4.3 Control de Visualización:
  • Zoom (+/-).
  • Splitter vertical.
  • Scroll horizontal del piano (88 teclas).
  • Ocultar/Mostrar el panel de piano.
• 4.4 Asistentes de Ejecución y Didáctica:
  • Semáforo de Errores Visuales: notas rojas, líneas de conducción paralela, diagnóstico al clic en Barra de Estado, Panel del Tutor para análisis extendido.
• 4.5 Digitación de Piano: Tu Partitura de Interpretación 🖐️:
  • Colores Dinámicos por Clave: Cian (Clave de Sol → Mano Derecha) · Rosa (Clave de Fa → Mano Izquierda).
  • Clic izquierdo en tecla vacía: añade dígito con mano auto-detectada por clave del pentagrama.
  • Auto-Detección de Mano: notas en Clave de Sol → mano derecha (1→2→3…); notas en Clave de Fa → mano izquierda (5→4→3…). Sin menús, sin configuración previa.
  • Clic izquierdo en dígito existente: selecciona (primer clic) o borra (segundo clic).
  • Clic derecho en dígito existente: alterna mano al instante (cian ↔ rosa) sin menú contextual.
  • Tecla 1-5 con dígito seleccionado: cambia el número de dedo y recalibra el contador automáticamente.
  • Persistencia Automática: la digitación viaja con el acorde; navegar ← → por el pentagrama restaura los dígitos exactos del acorde seleccionado. No hay botón "Guardar".
  • Limpiar: borra todos los dígitos del acorde activo (también limpia el registro guardado).

5. 🎸 La Guitarra: El Laboratorio del Mástil

Herramientas para dominar las 6 cuerdas.

• 5.1 Diseño de Acordes:
  • Selectores de Tónica (C, C-sharp, Db, D...), tipo de acorde e inversiones.
• 5.2 Exploración de Voicings (Sistema CAGED):
  • Botón "Cambiar Posición" para recorrer voicings por todo el mástil.
• 5.3 Modo Construcción (Edición Manual):
  • Clic en trastes punto a punto; cuerdas al aire y muteadas desde la cejuela.
  • Commit al pentagrama: botón ↑ o tecla Enter.
• 5.4 Guías Diatónicas:
  • Checkbox "Guías": notas de la escala activa resaltadas sobre el mástil.
  • Actualización automática al cambiar armadura de clave.
• 5.5 Filtros de Inteligencia y Ergonomía:
  • Restricciones de span (>4 trastes = rechazado).
  • Priorización de acordes abiertos; Filtro Anti-Muddy en graves.
  • Selector de Posición Adaptada vs. Posición Exacta.
• 5.6 Interacción con el Pentagrama:
  • Selección en pentagrama → visualización automática en diapasón.
  • Commit desde diapasón → análisis armónico y cifrado en pentagrama.
• 5.7 Modo Digitación de Guitarra:
  • Detección automática de cejillas y distribución anatómica de dedos.
  • Corrección manual: clic → seleccionar + tecla 1-4; 2.º clic → borrar.
  • Recalculación automática al cambiar posición con "Cambiar Posición".

6. 📝 El Intérprete: Tu Pantalla de Directo

La herramienta definitiva para clases, streams y directos.

• 6.1 Activación y Configuración:
  • Atajo M para abrir/cerrar.
  • Persistencia de posición y tamaño.
• 6.2 Visibilidad Máxima:
  • Pentagrama de alto contraste.
  • Cifrados de gran tamaño.
  • Ventana Always-on-Top.
• 6.3 Flujo de Trabajo en Tiempo Real:
  • Visualización del evento "live".
  • Entrada QWERTY activa desde el Intérprete.
• 6.4 El Panel Didáctico:
  • Nombre del acorde y cifrado romano.
  • Intervalos del acorde.
  • Escalas compatibles para improvisación.
• 6.5 Sincronización con Ventana Principal:
  • Eventos confirmados, armadura, modo armónico.
• 6.6 Casos de Uso Ideales:
  • Streamers, práctica personal, ensayos de banda.

7. 🧠 Inteligencia Artificial y Datos

Intercambio de datos, prompts de IA y exportación avanzada.

• 7.1 El Ciclo de Consultas IA:
  • AI Assistant (Ctrl/Cmd + Shift + A).
  • Generador de prompts profesionales.
  • Persistencia de metadatos educativos (ai_metadata).
• 7.2 Importación Inteligente (Smart Paste):
  • Formatos: texto con barras, comas, JSON estructurado.
  • Re-análisis automático con Motor Harmonia.
• 7.3 Exportación:
  • Copiar Cifrado Americano (Ctrl/Cmd + Shift + C).
  • Copiar Cifrado Romano (Ctrl/Cmd + Shift + R).
  • Exportar MusicXML.
  • Reparación JSON automática.
• 7.4 Captura Visual:
  • Captura de pentagrama (Ctrl/Cmd + Shift + I).
  • Transparencia inteligente.
• 7.5 Flujo de Trabajo con ChatGPT/Gemini:
  • Ejemplos prácticos de rearmonización y escalas.

8. 🎓 Teoría Avanzada (Motor Harmonia)

El cerebro analítico del software.

• 8.1 Modos Armónicos Disponibles:
  • Tabla resumen del análisis Auto (Tonal) y los 6 modos complementarios.
• 8.2 Análisis Modal en Detalle:
  • Dórico, Mixolidio, Lidio, Frigio con ejemplos.
• 8.3 Armonía Moderna:
  • Borrowed chords (bVI, bVII, iv).
  • Dominantes secundarias (V7/V, V7/ii, etc.).
  • Sustitución tritonal (subV7).
• 8.4 Reinterpretación Funcional (Slash Chords):
  • IV/V → V11, bVII/I → V9sus, iiø/V → V7alt.
• 8.5 Inteligencia de Tensiones:
  • Tabla de tensiones disponibles por tipo de acorde.
  • Avoid notes y rol del Tutor.
• 8.6 Consistencia del Nombrado:
  • NOMBRES_DORADOS y TECNICISMOS_A_EVITAR.
• 8.7 Motor Harmonia y Tutor:
  • Flujo de información y Caminos Creativos.
• 8.8 Interacción con el Análisis (Alternativas y Ortografía):
  • Ciclo de Análisis (Alternativas) (Ctrl/Cmd + A): cicla interpretaciones teóricamente válidas del mismo set de notas.
  • Rotación de Enarmonía (Q): alterna ortografía enarmónica de la nota seleccionada.
• 8.9 Shell Voicings — Ver el Esqueleto del Acorde:
  • Qué son los Tonos Guía (3ra, 7ma y extensiones condicionales).
  • Tabla de reglas Berklee: 8 intervalos clasificados como Shell o Gris.
  • Nota Jazz clave: el tritono solo es shell en acordes con 3ª menor (dim/m7b5); en acordes con 3ª mayor es #11 y va a gris.
  • Ejemplo práctico completo con Cmaj9#11.
  • Jerarquía visual con Gravedad Tonal activa simultáneamente.

9. 🛡️ El Tutor: Tu Mentor Armónico

Sistemas que trabajan en segundo plano.

• 9.1 Activación y Uso:
  • Atajo Ctrl/Cmd + T.
  • Análisis de transiciones entre acordes.
• 9.2 Salvoconductos:
  • Patrones armónicos reconocidos (V7→I, ii→V, etc.).
• 9.3 Validación de Reglas:
  • Errores de movimiento (quintas, octavas paralelas).
  • Errores de resolución (séptima, sensible).
  • Visualización interactiva con notas y líneas rojas, más diagnósticos al clic.
• 9.4 Caminos Creativos:
  • Regla geométrica (3ras y 6tas).
  • Tipos de sugerencias: inversiones, extensiones, alternativos.
• 9.5 Anatomía del Panel:
  • Encabezado, estado, diagnóstico, sugerencias, tip.
• 9.6 Modos de Conducción y el Motor:
  • Strict SATB, Strict Keyboard, Free Jazz.
• 9.7 Casos de Uso:
  • Estudiantes, compositores, improvisadores.
• 9.8 El Laboratorio de Voicings:
  • Taller de orquestación (Posición Cerrada, Drop 2, 3, 2&4, 2&3), anclaje (bajo/melodía), expansiones diatónicas (Inversiones Reales) y manipulación de registro (Rotar Octava).

10. ⚡ Referencia de Menús y Comandos

Desglose total de cada acción disponible.

• 10.1 Menú Archivo: Nuevo, Abrir, Guardar, Exportar MusicXML.
• 10.2 Menú Editar: Deshacer, Copiar/Pegar, Smart Paste, Captura, AI Assistant, Ciclo Enarmónico (Q), Ciclo Análisis (Ctrl/Cmd + A), Switch Staff (Ctrl/Cmd + F).
• 10.3 Menú Ver: Zoom, Cifrado, Mostrar Líneas de Conducción, Líneas Divisorias de Compás (L / O), Gravedad Tonal, Resaltar Tonos Guía (Shell), Paneles, Intérprete (M).
• 10.4 Menú Configuración: Armaduras (Ctrl/Cmd + ←/→), Modos, MIDI I/O.
• 10.5 Atajos QWERTY: ↓/↑ (octava), Space (avanzar), 3 filas de notas (Superior W-I: sostenidos; Media A-K: blancas; Inferior Z-N: bemoles).
• 10.6 Atajos de Construcción: Intervalos (Shift + 2..9).
• 10.7 Tabla Resumen de Atajos: Referencia rápida consolidada.

11. 🎼 Guías de Solución de Problemas (Playbooks)

Estrategias paso a paso para roles específicos.

• 11.1 Profesor Online: Pizarra visual, Modo Intérprete.
• 11.2 Estudiante de Armonía: Modo Strict, visualización de errores y Tutor.
• 11.3 Arreglista/Compositor: Filtro de higiene, exportar MusicXML.
• 11.4 Guitarrista Creativo: Sistema CAGED, exploración de voicings.
• 11.5 Youtuber/Streamer: Modo Intérprete, captura PNG.
• 11.6 Músico Jazz/Neo-Soul: Modo Free, tensiones Berklee.
• 11.7 Transcriptor de Canciones: Smart Paste desde internet.
• 11.8 Integración con IA: Flujo completo ChatGPT/Gemini.

12. 🔧 Mantenimiento y Referencia Final

Kit de supervivencia.

• 12.1 Troubleshooting:
  • Audio, MIDI, enarmonías, análisis romano, Tutor, archivos corruptos.
• 12.2 Gestión de Preferencias:
  • user_settings.json y cómo resetear.
• 12.3 Glosario de Términos:
  • Conceptos fundamentales, Motor Harmonia, técnicos, CAGED.
• 12.4 Créditos y Vida del Proyecto:
  • Fuentes (Leland, Inter), tecnología (Python, PySide6, Mido).
• 12.5 Información de Contacto y Soporte.
• 12.6 Gestión de Licencia y Activación.

13. 🛒 Opciones de Compra y Acceso

Adquiere tu licencia para la experiencia completa.