Solución de Problemas
12. 🔧 Mantenimiento, Soporte y Referencia Final
"El kit de supervivencia del usuario experto. Todo lo que necesitas para que AulaChord sea tan fiable como tu propio instrumento."
En esta sección final, recopilamos los recursos necesarios para mantener tu flujo de trabajo libre de obstáculos técnicos y definimos los términos que te convertirán en un conocedor profundo de la herramienta.
12.1 Solución de Problemas (Troubleshooting) 🛠️
A veces la tecnología se interpone en el camino de la música. Aquí tienes los pasos de emergencia para los problemas más comunes.
🔊 "Toco y no escucho nada"
| Paso | Acción |
|---|---|
| 1 | Volumen del Sistema: Asegúrate de que el ordenador no esté en silencio. |
| 2 | Selector de Salida: En la Barra de Herramientas, comprueba que el menú "Salida de Audio" tenga seleccionado un sintetizador (ej. Microsoft GS Wavetable Synth o VirtualMIDISynth). |
| 3 | Refrescar MIDI: Si los pasos anteriores fallan, ve a Ayuda -> Refrescar MIDI. Es el reinicio suave que soluciona el 90% de los conflictos de sonido. |
🎹 "Mi teclado físico no reacciona"
| Paso | Acción |
|---|---|
| 1 | Conexión Física: Desconecta y vuelve a conectar el cable USB. |
| 2 | Espera 2 segundos: AulaChord escanea automáticamente los puertos MIDI cada 2 segundos. |
| 3 | Selector de Entrada: Verifica en la barra de herramientas que tu dispositivo esté seleccionado en el menú de entrada MIDI. |
| 4 | Interruptor de Monitor: Verifica que el botón de Monitor de Entrada esté activo (color encendido). |
🎵 "Aparecen notas extrañas (Si#, Mi#)"
No es un error, es Ortografía Musical correcta en ciertos contextos. Sin embargo, si la lectura se vuelve difícil:
| Paso | Acción |
|---|---|
| 1 | Usa la tecla Q sobre la nota seleccionada para cambiar su enarmonía (ej. de Si# a Do). |
| 2 | Reset Tonal: Pulsa Ctrl/Cmd + D para devolver la armadura a Do Mayor. |
| 3 | Verifica que la armadura sea correcta para tu pieza (Ctrl/Cmd + ←/→). |
🎨 "Muchas notas aparecen en gris"
No es un error. Tienes activo el modo Resaltar Tonos Guía (Shell) en el menú Ver. Este modo atenúa a gris todas las notas no esenciales (tensiones, extensiones) y deja visibles solo el esqueleto funcional del acorde (Raíz, 3ras y 7mas). Para devolver el color completo a todas las notas, ve a Ver → Resaltar Tonos Guía (Shell) y desactívalo. Ver sección 8.9 para entender para qué sirve este modo.
| Paso | Acción |
|---|---|
| 1 | Modo Armónico: Verifica que el selector de Contexto Armónico tenga el modo correcto (Auto (Tonal), Dórico, etc.). |
| 2 | Armadura: Asegúrate de que la armadura corresponda a la tonalidad de tu pieza. |
| 3 | Ciclo de Análisis (Alternativas): Presiona Ctrl/Cmd + A sobre el acorde para ver interpretaciones alternativas. |
👨🏫 "Las sugerencias del Tutor no aparecen"
| Paso | Acción |
|---|---|
| 1 | Dos acordes necesarios: El Tutor necesita al menos 2 acordes consecutivos para analizar la transición. |
| 2 | Panel abierto: Asegúrate de que el Panel del Tutor esté abierto (Ctrl/Cmd + T). |
| 3 | Modo de conducción: Verifica que no estés en modo Libre (Teclado) si esperas validación estricta. |
🎹 «El teclado suena pero mi DAW no recibe nada»
| Paso | Acción |
|---|---|
| 1 | Windows — loopMIDI: Necesitas un cable virtual. Instala loopMIDI, crea un puerto y seléccionalo como salida en AulaChord y como entrada en tu DAW. Sin este paso, AulaChord y el DAW no pueden comunicarse. |
| 2 | macOS — IAC Driver: No necesitas software externo. Abre Configuración de Audio MIDI (Cmd + Espacio → "Audio MIDI Setup"), selecciona IAC Driver, activa «El dispositivo está conectado» y añade un puerto. Aparece automáticamente en AulaChord y en tu DAW. |
| 3 | Verificar asignación: En AulaChord, confirma que el menú de Salida MIDI apunte al puerto virtual recién creado (loopMIDI o IAC), no al sintetizador interno. |
🎵 «Toco en el teclado pero el sonido llega tarde (audio retrasado)»
La nota se registra en el pentagrama de inmediato — el retraso es solo del audio de salida, no de la escritura. La causa más habitual en Windows es el driver por defecto (Microsoft GS Wavetable Synth), que puede acumular 200–800 ms de latencia. Esto no afecta a la edición con atajos ni al Smart Paste, pero sí rompe el ritmo cuando compones por oído escuchando cada nota al vuelo.
| Paso | Acción |
|---|---|
| 1 | Windows: Instala VirtualMIDISynth (gratuito) y carga una SoundFont (.sf2). Reduce la latencia a 10-30 ms. Ver instrucciones completas en el Módulo 2.2. |
| 2 | macOS: La latencia con Core Audio suele ser baja por defecto. Si persiste, verifica que ninguna otra app monopolice el audio en exclusiva. |
| 3 | Verificar: Cambia el selector de «Salida de Audio» en la barra de herramientas de AulaChord a VirtualMIDISynth y vuelve a tocar. |
📊 «El archivo .aula no abre correctamente»
| Paso | Acción |
|---|---|
| 1 | Reparación Automática: AulaChord detecta archivos corruptos y activa reparación JSON automáticamente. |
| 2 | Mensaje de recuperación: Si ves un mensaje de "archivo reparado", revisa el contenido; es posible que se haya perdido algo. |
| 3 | Backup manual: Para archivos críticos, haz copias .aula frecuentes. |
12.2 Gestión de Preferencias 🔧
Archivo de Configuración: user_settings.json
AulaChord guarda tus preferencias en un archivo JSON dentro de la carpeta de la aplicación.
Se guardan automáticamente:
- Idioma de la interfaz
- Nivel de zoom
- Dispositivos MIDI seleccionados
- Modo de conducción de voces
- Tamaños de paneles
- Posición de ventanas flotantes
Cómo Resetear las Preferencias
Si experimentas comportamientos extraños:
- Cierra AulaChord completamente.
- Localiza y elimina el archivo
user_settings.jsonen la carpeta de la aplicación. - Reinicia AulaChord. Las preferencias volverán a los valores por defecto.
12.3 Glosario Pedagógico de Términos 📚
Para entender AulaChord, es vital hablar su mismo idioma musical.
Conceptos Fundamentales de Armonía
| Término | Definición |
|---|---|
| Acorde | Tres o más notas sonando simultáneamente. La "palabra" básica del lenguaje armónico. |
| Cifrado Americano | Sistema de nombrar acordes con letras (Am7, G7, Cmaj7). El "español" de la música popular y el jazz. |
| Cifrado Romano | Sistema de nombrar acordes con números romanos según su función tonal (I, V7, ii). El "latín" del análisis académico. |
| Conducción de Voces (Voice Leading) | El arte de mover cada nota de un acorde al siguiente de forma suave, evitando saltos bruscos y paralelismos prohibidos. |
| Dominante Secundaria | Acorde dominante que apunta temporalmente a un grado distinto de la tónica principal (por ejemplo, V7/ii). Crea impulso local y sensación de dirección momentánea. |
| Enarmonía / Ortografía Musical | Dos notas pueden sonar igual en el piano pero escribirse distinto según su función (por ejemplo, Fa-sharp vs Sol bemol). Escribir bien la nota mejora la lectura y el análisis. |
| Gravedad Tonal | Principio acústico-pedagógico que clasifica las notas según su estabilidad dentro del acorde y del contexto tonal. Las notas en reposo estructural (núcleo: raíz, 3ra, 5ta) tienden a permanecer estables; las notas con gravedad tonal generan una necesidad perceptible de resolución hacia otro grado. |
| Intercambio Modal (Borrowed Chords) | Recurso de tomar acordes "prestados" del modo paralelo (mayor/menor del mismo centro tonal) para colorear la progresión sin perder su identidad general. |
| Planing | Técnica de jazz/impresionismo en la que todas las voces se mueven en paralelo (5ªs u 8ªs) de forma intencional. AulaChord lo permite en modo Libre (Teclado) y lo marca como error solo en modo SATB Estricto. |
| SATB | Siglas de Soprano-Alto-Tenor-Bajo: las cuatro voces del coro clásico. El modo SATB Estricto aplica sus reglas de espaciado y movimiento más estrictas (basadas en Piston). |
| Sustitución Tritonal (subV7) | Sustitución de un dominante por otro cuya raíz está a distancia de tritono (por ejemplo, Db7 en lugar de G7). Mantiene la tensión-resolución con un color más cromático. |
| Tono Guía (Guide Tone / Shell Voicing) | Nota estructural que define la función del acorde (sobre todo 3ra y 7ma). En práctica, son las notas mínimas que permiten reconocer claramente el acorde al voicingear. |
| Voicing | La disposición específica de las notas de un acorde. Decidir qué nota va arriba y cuál abajo es el arte de "dar voz" a un acorde. |
Conceptos del Motor Harmonia
| Término | Definición |
|---|---|
| Motor Harmonia | El cerebro analítico de AulaChord. Sintetiza las reglas de armonía tradicional (Piston) con la teoría moderna de jazz (Berklee). |
| Salvoconducto | Un patrón armónico tan común (como V7→I) que se considera automáticamente válido, incluso si técnicamente viola alguna regla. |
| Caminos Creativos | Sugerencias alternativas que el Tutor ofrece para mejorar una transición problemática. |
| Nombres Dorados | Lista interna de calidades de acordes pedagógicas (7, m7, Maj7, dim7). AulaChord prioriza estos nombres sobre alternativas confusas. |
| TECNICISMOS_A_EVITAR | Sufijos técnicos (add, no3, no5, dyad) que el sistema evita en favor de nombres más claros. |
Conceptos Técnicos de la Aplicación
| Término | Definición |
|---|---|
| JSON (.aula) | El formato de archivo de AulaChord. A diferencia del MIDI, guarda notas, análisis y metadatos de IA en texto estructurado. |
| Latencia | El retardo entre tu pulsación y el sonido. Mantenerla baja es clave para tocar con fluidez. |
| Smart Split Point | Umbral de altura (C4, MIDI 60) que AulaChord usa para distribuir las notas automáticamente entre el pentagrama de Sol (notas ≥ C4) y el de Fa (notas < C4) en el Gran Pentagrama. |
| SMuFL | Estándar moderno de fuentes musicales. Gracias a esto, el pentagrama tiene aspecto de grabado clásico de alta calidad. |
| ai_metadata | Información educativa de ChatGPT/Gemini que se preserva cuando importas acordes desde una IA. |
| MusicXML | Formato de intercambio estándar para software de notación (Sibelius, MuseScore, Finale). |
Sistema CAGED (Guitarra)
| Término | Definición |
|---|---|
| CAGED | Sistema de 5 formas básicas de acordes (C-A-G-E-D) que se desplazan por el mástil con cejilla. |
| Voicing Canónico | Posiciones predefinidas de acordes que representan las formas más comunes y ergonómicas. |
12.4 Créditos y Vida del Proyecto
AulaChord es un proyecto vivo que se construye sobre el trabajo de grandes comunidades.
Tipografía y Diseño
- Leland: Nuestra fuente musical, inspirada en los grabados clásicos de la editorial Peters.
- Lato/Inter: Fuentes de interfaz diseñadas para una lectura clara y profesional.
Tecnología de Soporte
- Python & PySide6 (Qt): Los motores que mueven la lógica y los gráficos.
- Mido: El lenguaje que nos permite hablar con tus teclados MIDI.
- Ruff: La herramienta que asegura que el código de AulaChord sea limpio, seguro y eficiente.
12.5 Información de Contacto y Soporte
Reportar Problemas
Si encuentras un bug o comportamiento inesperado:
- Describe los pasos exactos para reproducir el problema.
- Indica tu sistema operativo y versión de AulaChord.
- Si es posible, adjunta el archivo
.aulaque causa el problema.
Sugerencias de Mejora
AulaChord evoluciona gracias a la retroalimentación de usuarios como tú. Las sugerencias son bienvenidas, especialmente en áreas como:
- Nuevos modos armónicos
- Mejoras en la guitarra
- Nuevos patrones de salvoconducto
- Traducciones a otros idiomas
12.6 Gestión de Licencia y Activación 🔐
AulaChord utiliza un sistema de licencias inteligente diseñado para ofrecer la máxima seguridad sin interrumpir tu flujo creativo, permitiendo el uso profesional incluso en entornos sin conexión a internet.
Activación y Período de Gracia
- Activación Inicial: Requiere conexión a internet por única vez para validar tu clave de Lemon Squeezy y vincularla a tu hardware.
- Uso Offline: Una vez activada, la aplicación funciona 100% offline. Cada 7 días, AulaChord intentará realizar una validación silenciosa en segundo plano si detecta internet.
- Tolerancia: Si no dispones de conexión tras el séptimo día, se activa un Período de Gracia de 14 días adicionales. Durante este tiempo, la app sigue siendo plenamente operativa.
Seguridad Anti-Tampering
Para proteger la integridad del software, AulaChord incluye protección Anti-Tampering. Cualquier intento de modificar los archivos internos o el binario de la aplicación resultará en la inhabilitación automática y silenciosa de los motores de análisis musical y visualizado, garantizando que solo las copias originales y autorizadas mantengan su potencia pedagógica.
[!TIP]
Cambiar de ordenador: AulaChord incluye un proceso de transferencia de licencia de autoservicio. En el equipo antiguo, abre AulaChord, ve a Ayuda → Gestión de Licencia y haz clic en Desactivar. Esto libera la activación en el servidor de forma inmediata. Luego, en el nuevo equipo, instala AulaChord e ingresa tu misma clave de licencia para reactivar. Si encuentras algún problema durante este proceso, contáctanos a través del Formulario de Soporte.
"La música es el lenguaje de las almas, y AulaChord es solo el papel y el lápiz que te ayudan a escribirlo mejor."