VIETA DJ JUNO PARA MIXXX / VIETA DJ JUNO FOR MIXXX
==================================================

Mixxx 2.5 o posterior / Mixxx 2.5 or later
Mapeo personalizado pendiente de validacion completa con el hardware. Pruebalo a volumen bajo.
Custom mapping awaiting full hardware validation. Test at low volume.

ESPANOL
-------

INSTALACION EN macOS Y WINDOWS

1. Cierra Mixxx y conecta la controladora por USB.
2. Copia juntos Vieta-DJ-Juno.midi.xml y Vieta-DJ-Juno-scripts.js.
3. En Mixxx, abre Preferencias > Controladores > Abrir carpeta de mapeos del usuario. Pega ahi los dos archivos, directamente en esa carpeta.
   macOS: tambien puedes abrir ~/Library/Application Support/Mixxx/controllers desde Finder > Ir > Ir a la carpeta. Algunas instalaciones usan ~/Library/Containers/org.mixxx.mixxx/Data/Library/Application Support/Mixxx/controllers.
   Windows: pega %LOCALAPPDATA%\Mixxx\controllers en la barra del Explorador de archivos.
4. Abre Mixxx. En Preferencias > Controladores, selecciona el puerto MIDI de Juno, elige el mapeo "Vieta DJ Juno", marca Activado y pulsa Aplicar. Si Mixxx muestra una salida MIDI independiente, activala para probar los LED.
5. Si no aparece el mapeo, cierra y vuelve a abrir Preferencias > Controladores o reinicia Mixxx. Comprueba que el XML y el JS tengan sus nombres originales y esten juntos.

AUDIO

En Preferencias > Hardware de sonido, asigna Principal/Main y, si hay otro par de canales, Auriculares/Headphones. Comprueba los conectores y canales reales a volumen bajo. El mapeo MIDI no identifica por si solo las salidas fisicas.

PRIMEROS PASOS

- Muestra dos decks. Enfoca la biblioteca, elige una pista con BROWSE y cargala con LOAD en un deck detenido.
- PLAY reproduce; CUE establece o recupera el punto cue; el boton de auriculares activa la preescucha PFL.
- Prueba faders, EQ, filtro, crossfader, SYNC, TEMPO y jogs antes de usar el equipo en directo.
- Para usar los 16 pads de sampler, muestra 16 samplers y carga los sonidos manualmente.
- Los cuatro botones de modo seleccionan HOT CUE, STEMS, BEAT JUMP y SAMPLER. Con SHIFT seleccionan KEYCUE, PAD FX, LOOP y SAVED LOOP.
- Para COLOR FX y MIX FX, selecciona Filter como Quick Effect de cada deck y un EQ de tres bandas con cortes. Asigna FX1 al deck 1 y FX2 al deck 2. Carga Reverb en el slot 1, Echo en el 2 y un efecto opcional en el 3 de cada unidad.
- STEMS usa cortes de EQ; no separa voces ni instrumentos. HOT CUE y SAVED LOOP comparten las posiciones 1-8.
- Para los controles completos y ajustes avanzados, consulta LEEME.md en esta carpeta.

SI ALGO FALLA

- Si el dispositivo no aparece, revisa cable, puerto USB y deteccion por el sistema. En Windows, instala el controlador del fabricante si hace falta.
- Si aparece pero no responde, comprueba puerto MIDI, mapeo activado y los dos archivos juntos.
- Si los controles funcionan pero no hay sonido, revisa Principal/Main, Auriculares/Headphones y volumen.
- Si los LED no responden, comprueba la salida MIDI. Su funcionamiento aun requiere una prueba fisica.

ENGLISH
-------

INSTALLATION ON macOS AND WINDOWS

1. Close Mixxx and connect the controller over USB.
2. Copy Vieta-DJ-Juno.midi.xml and Vieta-DJ-Juno-scripts.js together.
3. In Mixxx, open Preferences > Controllers > Open User Mapping Folder. Paste both files directly into that folder.
   macOS: you can also open ~/Library/Application Support/Mixxx/controllers from Finder > Go > Go to Folder. Some installations use ~/Library/Containers/org.mixxx.mixxx/Data/Library/Application Support/Mixxx/controllers.
   Windows: paste %LOCALAPPDATA%\Mixxx\controllers into the File Explorer address bar.
4. Open Mixxx. Under Preferences > Controllers, select the Juno MIDI port, choose "Vieta DJ Juno" under Load Mapping, check Enabled, and click Apply. If Mixxx lists a separate MIDI output, enable it to test the LEDs.
5. If the mapping is missing, close and reopen Preferences > Controllers or restart Mixxx. Check that the XML and JS have their original names and are in the same folder.

AUDIO

Under Preferences > Sound Hardware, assign Main and, if another stereo channel pair is available, Headphones. Check the actual sockets and channel pairs at low volume. A MIDI mapping cannot identify physical audio outputs.

QUICK START

- Show two decks. Focus the library, select a track with BROWSE, and load it with LOAD into a stopped deck.
- PLAY starts playback; CUE sets or returns to the cue point; the deck headphone button enables PFL monitoring.
- Test faders, EQ, filter, crossfader, SYNC, TEMPO, and jog wheels before a live set.
- To use all sampler pads, show 16 samplers and load samples manually.
- The four mode buttons select HOT CUE, STEMS, BEAT JUMP, and SAMPLER. With SHIFT they select KEYCUE, PAD FX, LOOP, and SAVED LOOP.
- For COLOR FX and MIX FX, select Filter as each deck's Quick Effect and a three-band EQ with kill buttons. Route FX1 to deck 1 and FX2 to deck 2. Load Reverb in slot 1, Echo in slot 2, and an optional effect in slot 3 of each unit.
- STEMS uses EQ cuts; it does not separate vocals or instruments. HOT CUE and SAVED LOOP share positions 1-8.
- For every control and advanced settings, see LEEME.md in this folder.

TROUBLESHOOTING

- Device missing: check the USB cable and port and confirm the OS detects it. On Windows, install the manufacturer's driver if needed.
- Device listed but not responding: check the MIDI port, enabled mapping, and that the XML and JS are together.
- Controls work but no sound: check Main, Headphones, and volume.
- LEDs stay dark: check the MIDI output port. LED feedback still requires physical verification.

Documentacion oficial / Official documentation:
https://manual.mixxx.org/2.5/en/chapters/controlling_mixxx.html
https://manual.mixxx.org/2.5/en/chapters/preferences/sound_hardware.html
