VIETA DJ ORION PARA MIXXX / VIETA DJ ORION FOR MIXXX
====================================================

Mixxx 2.5 o posterior / Mixxx 2.5 or later
Mapping personalizado v1.1. Crossfader, PADS FX y vumetro contrastados con pruebas fisicas; consulta LEEME.md para los limites.
Custom v1.1 mapping. Crossfader, PAD FX, and meter checked with hardware feedback; see LEEME.md for remaining limits.

ESPANOL
-------

INSTALACION EN macOS Y WINDOWS

1. Cierra Mixxx y conecta Orion por USB.
2. Copia juntos Vieta-DJ-Orion.midi.xml y Vieta-DJ-Orion-scripts.js a la carpeta personal controllers de Mixxx.
   macOS: abre Preferencias > Biblioteca > Abrir carpeta de ajustes de Mixxx y entra en controllers. En la instalacion comprobada: ~/Library/Containers/org.mixxx.mixxx/Data/Library/Application Support/Mixxx/controllers.
   Windows: pega %LOCALAPPDATA%\Mixxx\controllers en la barra del Explorador.
3. Abre Mixxx. En Preferencias > Controladores selecciona el puerto MIDI Orion, carga "Vieta DJ Orion", activa la controladora y pulsa Aplicar. Activa la salida MIDI si aparece por separado para los LED de botones y pads.
4. Si no aparece, confirma que el XML y el JS conservan sus nombres y estan juntos; reinicia Mixxx.

AUDIO Y VUMETRO

En Preferencias > Hardware de sonido, selecciona Orion > Canales 1-2 como salida Principal para que las barras del vumetro sigan la musica. Se ha comprobado que las barras miden el audio que sale por la interfaz Orion: si Mixxx reproduce solo por los altavoces del ordenador u otro dispositivo, permanecen apagadas. Prueba a volumen bajo porque el sonido pasara a las salidas fisicas de Orion. El resto de controles MIDI funciona aunque elijas otra salida de audio.

PRIMEROS PASOS

- Muestra dos decks. Enfoca la biblioteca, gira BROWSE para elegir una pista y pulsa LOAD en un deck detenido.
- PLAY reproduce; CUE establece o recupera cue; PFL activa la preescucha.
- Prueba faders, crossfader, EQ, filtro, SYNC, TEMPO y jogs antes de usarlo en directo.
- Los cuatro botones de modo eligen HOT CUE, STEMS, BEAT JUMP y SAMPLER; con SHIFT eligen KEY CUE, PADS FX, LOOP y SAVED LOOP.
- Para los 16 pads de SAMPLER, muestra 16 samplers en Mixxx y carga los sonidos manualmente.
- PADS FX izquierdo actua sobre FX 1/deck 1; derecho sobre FX 2/deck 2. Carga efectos en las ranuras de Mixxx. El fader FX central ajusta la mezcla dry/wet de la unidad seleccionada.
- COLOR FX Reverb y Echo necesitan efectos cargados en las ranuras 1 y 2 de FX 1 y FX 2.
- STEMS usa cortes EQ; no separa voces, instrumentos ni bateria. HOT CUE y SAVED LOOP comparten las posiciones 1-8.
- Para todas las funciones y combinaciones, consulta LEEME.md.

SI ALGO FALLA

- No aparece Orion: revisa cable y puerto USB y confirma que el sistema la detecta.
- Aparece pero no responde: verifica puerto MIDI, mapping activado y XML/JS juntos.
- Controles MIDI funcionan pero no hay sonido: revisa Principal, canales 1-2, cableado y volumen.
- Vumetro apagado: confirma que Principal sale por Orion; la salida MIDI por si sola no mueve las barras.
- LED de botones apagados: comprueba que la salida MIDI esta activada.

ENGLISH
-------

INSTALLATION ON macOS AND WINDOWS

1. Close Mixxx and connect Orion over USB.
2. Copy Vieta-DJ-Orion.midi.xml and Vieta-DJ-Orion-scripts.js together into Mixxx's user controllers folder.
   macOS: open Preferences > Library > Open Mixxx settings folder, then controllers. The tested installation uses ~/Library/Containers/org.mixxx.mixxx/Data/Library/Application Support/Mixxx/controllers.
   Windows: paste %LOCALAPPDATA%\Mixxx\controllers into File Explorer's address bar.
3. Open Mixxx. Under Preferences > Controllers select Orion's MIDI port, load "Vieta DJ Orion", enable it, and click Apply. Enable a separate MIDI output if listed for button and pad LEDs.
4. If the mapping is missing, check that the XML and JS retain their filenames and are together, then restart Mixxx.

AUDIO AND LEVEL METERS

Under Preferences > Sound Hardware, select Orion > Channels 1-2 as the Main output for the meter bars to follow music. Hardware testing confirmed that the bars meter audio passing through Orion. If Mixxx plays only through the computer speakers or another device, the bars stay dark. Start at low volume: audio will move to Orion's physical outputs. MIDI controls still work with a different audio output.

QUICK START

- Show two decks. Focus the library, turn BROWSE to select a track, and press LOAD on a stopped deck.
- PLAY starts playback, CUE sets or returns to cue, and PFL enables headphone preview.
- Test faders, crossfader, EQ, filter, SYNC, TEMPO, and jog wheels before a live set.
- The four mode buttons choose HOT CUE, STEMS, BEAT JUMP, and SAMPLER; with SHIFT they choose KEY CUE, PADS FX, LOOP, and SAVED LOOP.
- Show 16 samplers and load sounds manually to use all sampler pads.
- Left PADS FX controls FX 1/deck 1; right PADS FX controls FX 2/deck 2. Load effects into Mixxx's slots. The central FX fader controls dry/wet mix for the selected unit.
- COLOR FX Reverb and Echo require effects in slots 1 and 2 of FX units 1 and 2.
- STEMS uses EQ cuts, not source separation. HOT CUE and SAVED LOOP share positions 1-8. See LEEME.md for all controls.

TROUBLESHOOTING

- Orion missing: check the USB cable and port and OS detection.
- Device listed but unresponsive: check MIDI port, enabled mapping, and the XML/JS pair.
- Controls work but no sound: check Main, channels 1-2, cabling, and volume.
- Meter bars stay dark: confirm that Main is routed through Orion; MIDI output alone does not drive them.
- Button LEDs stay dark: enable the MIDI output port.

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