VIETA DJ ANDROMEDA PARA MIXXX / VIETA DJ ANDROMEDA FOR MIXXX
===========================================================

Mapping personalizado 1.0 para Mixxx 2.5.6.
Custom mapping 1.0 for Mixxx 2.5.6.

ESPANOL
-------

INSTALACION EN macOS Y WINDOWS

1. Conecta Andromeda por USB. En Mixxx, abre la carpeta de mappings del usuario desde Preferencias > Controladores. Cierra Mixxx antes de sustituir archivos.
2. Copia juntos Vieta-DJ-Andromeda.midi.xml y Vieta-DJ-Andromeda-scripts.js a esa carpeta.
   macOS: la carpeta habitual de esta version es ~/Library/Containers/org.mixxx.mixxx/Data/Library/Application Support/Mixxx/controllers.
   Windows: la carpeta habitual es %LOCALAPPDATA%\Mixxx\controllers.
   Si tu instalacion usa otra ruta, utiliza la carpeta que abre Mixxx.
3. Abre Mixxx. En Preferencias > Controladores selecciona el puerto MIDI Andromeda y carga "Vieta DJ Andromeda - Mixxx 2.5.6 - Final 1.0". Activa el controlador y pulsa Aplicar.
4. Si no aparece, comprueba que los archivos XML y JS conservan sus nombres, estan juntos y has reiniciado Mixxx.

AUDIO Y PRIMEROS PASOS

- Configura las salidas Principal y Auriculares en Hardware de sonido. Los canales exactos deben comprobarse en la interfaz Andromeda; el mapping no configura el audio.
- Usa cuatro decks y ocho samplers. Carga las muestras desde Mixxx.
- PLAY reproduce/pausa; CUE controla el punto cue; PFL activa preescucha. LOAD carga la pista seleccionada solamente si el deck esta parado.
- La direccion de TEMPO esta corregida. La captura suave requiere alcanzar la posicion actual en pantalla antes de tomar control.
- Los seis botones COLOR seleccionan Filtro, Reverb, Ruido blanco, Eco, Pitch y Flanger para los cuatro canales. Cada mando COLOR regula su propio canal; en el centro desactiva el efecto.
- Los indices COLOR corresponden a la lista inspeccionada de Mixxx 2.5.6 en espanol. Si cambia el orden de presets, el idioma o la instalacion, consulta LEEME.md.
- HOT CUE: puntos 1-8. BEAT JUMP: saltos. SAMPLER: muestras 1-8. SHIFT + HOT CUE: puntos 9-16; SHIFT + STEMS: loop rolls; SHIFT + BEAT JUMP: loops.
- STEMS, VOCAL, INST, DRUMS y FX STEMS no tienen funcion en esta version 2.5.6. No se sustituyen por cortes de EQ. SAVED LOOP tampoco esta implementado.
- FX izquierdo usa unidad 1 y derecho unidad 2. Carga un efecto en la primera ranura de cada unidad. ASSIGN alterna decks 1/3 o 2/4.
- BOOTH regula la salida fisica de monitores de cabina; no esta mapeado por MIDI.

SI ALGO FALLA

- Dispositivo ausente: revisa USB y que el sistema lo detecte.
- Aparece pero no responde: revisa puerto, preset, activacion y pareja XML/JS.
- MIDI funciona sin audio: revisa Hardware de sonido, salidas, cableado y volumen.
- Luces apagadas: revisa la salida MIDI. Pantallas y vumetros necesitan validacion con el hardware.
- Efecto COLOR incorrecto: revisa la lista de presets y colorChainIndices segun LEEME.md.

ESTADO DE VALIDACION

Sintaxis, estructura y simulacion MIDI comprobadas. Pendiente de prueba fisica y de carga de esta entrega en el motor real de Mixxx. No se trasladan a Andromeda las pruebas fisicas realizadas con Orion. Consulta LEEME.md para todas las funciones y limitaciones.

ENGLISH
-------

INSTALLATION ON macOS AND WINDOWS

1. Connect Andromeda over USB. In Mixxx, open the user mapping folder under Preferences > Controllers. Close Mixxx before replacing files.
2. Copy Vieta-DJ-Andromeda.midi.xml and Vieta-DJ-Andromeda-scripts.js together into that folder.
   macOS: the usual folder for this version is ~/Library/Containers/org.mixxx.mixxx/Data/Library/Application Support/Mixxx/controllers.
   Windows: the usual folder is %LOCALAPPDATA%\Mixxx\controllers.
   If your installation uses another location, use the folder opened by Mixxx.
3. Open Mixxx. Under Preferences > Controllers select Andromeda's MIDI port, load "Vieta DJ Andromeda - Mixxx 2.5.6 - Final 1.0", enable the controller and click Apply.
4. If the preset is missing, check both filenames, keep XML and JS together and restart Mixxx.

AUDIO AND QUICK START

- Configure Main and Headphones outputs under Sound Hardware. Verify the actual Andromeda audio channels; the mapping does not configure audio.
- Use four decks and eight samplers. Load samples in Mixxx.
- PLAY toggles playback, CUE operates the cue point and PFL enables headphone preview. LOAD only loads a selected track into a stopped deck.
- TEMPO direction is corrected. Soft takeover requires matching the current software position.
- Six COLOR buttons select Filter, Reverb, White Noise, Echo, Pitch and Flanger for all four decks. Each COLOR knob controls its own deck; the center position bypasses the effect.
- COLOR indices match the inspected Spanish Mixxx 2.5.6 preset list. Recheck colorChainIndices after changing preset order, language or installation.
- HOT CUE uses cues 1-8; BEAT JUMP performs jumps; SAMPLER uses samples 1-8. SHIFT + HOT CUE selects cues 9-16; SHIFT + STEMS selects loop rolls; SHIFT + BEAT JUMP selects loops.
- STEMS, VOCAL, INST, DRUMS and FX STEMS are unassigned on Mixxx 2.5.6. They are not EQ-cut substitutes. SAVED LOOP is also unimplemented.
- Left FX controls unit 1 and right FX unit 2. Load an effect in each unit's first slot. ASSIGN switches decks 1/3 or 2/4.
- BOOTH controls the hardware booth-monitor output; it has no MIDI assignment.

TROUBLESHOOTING AND VALIDATION

Check USB detection, MIDI port, enabled preset and matching XML/JS files if controls do not respond. If MIDI works but audio does not, check output configuration, cabling and volume. Check MIDI output for LEDs. If a COLOR button selects the wrong effect, recalibrate the preset indices.

Syntax, XML structure and simulated MIDI behavior have been checked. This release has not been tested on the physical Andromeda or loaded into the real Mixxx engine. Hardware testing of Orion does not establish Andromeda compatibility. The included LEEME.md contains the detailed Spanish control guide and limitations.

Official Mixxx controls / Controles oficiales:
https://manual.mixxx.org/2.5/en/chapters/appendix/mixxx_controls.html
