2. Configuración Técnica y Entorno 🛠️

"Prepara tu estudio virtual para una experiencia sin interrupciones. Una buena configuración es el cimiento de una sesión creativa fluida."

Para que AulaChord funcione como una extensión real de tu creatividad, la comunicación entre tu hardware (teclados) y el software debe ser instantánea y fiable. Aquí te guiamos para dejar tu entorno a punto desde el primer segundo.

2.1 Instalación y Requisitos del Sistema

AulaChord es una aplicación nativa diseñada para ofrecer el máximo rendimiento en diversas plataformas, adaptándose a la tecnología que ya tengas en tu estudio.

Compatibilidad de Sistema

• Windows 11 (Recomendado): Es nuestra plataforma principal, donde los drivers MIDI ofrecen la respuesta más estable.
• macOS Totalmente compatible. En el caso de Apple, soporta tanto arquitecturas Intel como los modernos procesadores Silicon M1/M2/M3. (macOS 15 (Sequoia); macOS 14 (Sonoma); macOS 13 (Ventura); macOS 12 (Monterey))

Tu Primer Inicio (Configuración Silenciosa)

Al abrir la aplicación por primera vez, AulaChord genera automáticamente un archivo de configuración llamado user_settings.json en el mismo directorio de la aplicación. No te preocupes por volver a elegir el zoom, el idioma o tus dispositivos MIDI cada vez que abras el programa; la aplicación recordará tus preferencias para que puedas empezar a tocar de inmediato.

Consejo de recuperación: ¿Algo salió mal con tus preferencias? Cierra la app, elimina el archivo user_settings.json y vuelvela a abrir. AulaChord se reiniciará con valores por defecto.

2.2 Gestión de Audio y MIDI (I/O)

Reconocer tus instrumentos es el primer paso para que la música empiece a sonar.

La Batalla contra la Latencia (El Retardo) 🛡️

Es el enemigo invisible: pulsas una tecla y el sonido llega medio segundo después. En Windows, esto suele deberse al driver por defecto (Microsoft GS Wavetable Synth).

• La Solución Definitiva (VirtualMIDISynth): Te recomendamos encarecidamente instalar esta herramienta gratuita. Te permite cargar "SoundFonts" (.sf2) de alta calidad (pianos reales, cuerdas) y reduce la latencia a niveles imperceptibles (10-20ms). Tú tocas, AulaChord responde al instante.
• Conexión con otros programas (loopMIDI): Si quieres que la inteligencia de AulaChord alimente a instrumentos profesionales en un DAW como Ableton, Logic o Cubase, usa loopMIDI para crear un "cable virtual" entre ambos mundos.

Ejemplos de uso:

• VirtualMIDISynth (Free): Install VirtualMIDISynth + a SoundFont (.sf2) for ~10-30ms latency and better sound quality.
• loopMIDI + VST (Professional): Use loopMIDI with a VST synthesizer (e.g., Surge, Dexed) for ~5-20ms latency.
• Spitfire LABS (Free, High Quality): Download LABS + loopMIDI for professional-quality orchestra, piano, and synth sounds

Conexión en Caliente y Seguridad

• Detección Automática: AulaChord escanea los puertos MIDI automáticamente cada 2 segundos. Si conectas tu piano USB mientras la app está abierta, aparecerá en la lista sin que hagas nada.
• Refrescar MIDI (Manual): ¿No aparece tu dispositivo? Ve a Ayuda -> Refrescar MIDI para forzar un escaneo inmediato.
• Prevención de Bucles (Loopback): El sistema incluye una protección inteligente. Si intentas seleccionar el mismo dispositivo para Entrada y Salida, AulaChord te avisará para evitar un eco de notas infinito que podría bloquear tu ordenador.
• MIDI Bluetooth: ¿Usas un teclado inalámbrico? AulaChord es compatible con dispositivos MIDI Bluetooth. Simplemente vincula tu teclado desde la configuración de tu sistema operativo y aparecerá en la lista de dispositivos MIDI.

2.3 El Sistema de Archivos (.aula) 💾

Tus proyectos no son simples partituras; son fragmentos de inteligencia musical guardados en un formato JSON enriquecido.

Anatomía del Formato .aula

A diferencia de un archivo MIDI estándar, el formato .aula protege toda la riqueza de tu sesión:

• Eventos Musicales: Duración y altura exacta de cada nota.
• Metadatos de Análisis: Los grados y funciones que ya habías validado.
• Metadatos de Inteligencia Artificial: Si consultaste al Asistente IA, las explicaciones de sus sugerencias armónicas se guardan de manera permanente como material educativo en tu archivo.
• Armadura de Clave: El número de sostenidos o bemoles que define tu tonalidad.
• Modo Armónico: Si estabas trabajando en modo Dórico, Mixolidio, etc., se conserva.
• Índice de Análisis Activo: Si un acorde tenía múltiples interpretaciones posibles, recuerda cuál elegiste.

Exportación a MusicXML

¿Necesitas abrir tu trabajo en MuseScore, Sibelius, Finale o Dorico? Usa Archivo -> Exportar MusicXML. Este formato universal conserva las notas, ritmos y armadura, permitiendo la interoperabilidad con prácticamente cualquier software de notación profesional.

Seguridad y Recuperación (JSON Repair) 🛡️

Sabemos lo frustrante que es perder trabajo por un error inesperado o un corte de luz. AulaChord incluye un algoritmo de JSON Repair. Si detecta que un archivo se guardó de forma incompleta, el sistema analiza la estructura, balancea automáticamente las llaves {} perdidas y rescata la mayor cantidad de música posible para que tu sesión no se pierda.

Gestión de Biblioteca

Usa los comandos estándar Ctrl (⌘)/Cmd (⌘)+N (Nuevo), Ctrl (⌘)/Cmd (⌘)+O (Abrir) y Ctrl (⌘)/Cmd (⌘)+S (Guardar) para organizar tus progresiones y ejercicios con la misma facilidad que cualquier otro documento profesional.

2.4 Persistencia de Preferencias ⚙️

AulaChord recuerda tus preferencias entre sesiones. Esto es lo que se guarda automáticamente en user_settings.json:

• Tema de Interfaz (Modo Oscuro / Claro): Disponible desde el menú Ver, puedes alternar entre un tema oscuro (ideal para sesiones nocturnas) y un tema claro (ideal para proyectar en aulas). Esta configuración se recuerda y aplica automáticamente al iniciar.
• Idioma de la interfaz: Español o Inglés.
• Nivel de Zoom: El tamaño de visualización del pentagrama.
• Dispositivo MIDI Preferido: Si siempre usas el mismo teclado, no tendrás que seleccionarlo cada vez.
• Salida de Audio: Tu sintetizador o DAW preferido.
• Modo de Conducción de Voces: SATB Estricto, Teclado Estricto o Modo Libre.
• Tamaños de Panel: Las alturas del piano y la guitarra que ajustaste con el splitter.

Nota para usuarios avanzados: El archivo user_settings.json es texto plano. Si deseas hacer una copia de seguridad de tu configuración o compartirla con otro ordenador, simplemente copia este archivo.