================================================================================
                    🚀 INICIO RÁPIDO - GENERADOR .ALS
================================================================================

¡Bienvenido al Generador de Archivos .als para Ableton Live!

Este documento te ayudará a empezar en menos de 5 minutos.

================================================================================
📌 PASO 1: VERIFICAR INSTALACIÓN
================================================================================

Ejecuta el script de verificación:

    ./setup.sh

Si ves "✅ Instalación completa y verificada", estás listo para continuar.

================================================================================
📌 PASO 2: GENERAR TU PRIMER PROYECTO
================================================================================

Ejecuta:

    python3 als_generator.py

Esto creará un archivo "generated_project.als" con:
- 1 GroupTrack "Drums"
- 5 tracks MIDI (Kick, Snare, HiHat, Bass, Lead)
- 8 clips con patrones de 16 notas cada uno
- Mixer completo

================================================================================
📌 PASO 3: ABRIR EN ABLETON LIVE
================================================================================

1. Abre Ableton Live 12 Suite
2. Ve a File > Open
3. Navega hasta la carpeta /mnt/c/als_gen
4. Abre "generated_project.als"
5. ¡Disfruta tu proyecto generado!

================================================================================
📌 PASO 4: ANALIZAR EL PROYECTO
================================================================================

Para ver qué contiene tu proyecto:

    python3 als_analyzer.py generated_project.als info

Verás:
- Información general (versión, creador)
- Lista de tracks
- Clips MIDI y número de notas

================================================================================
📌 PASO 5: CREAR UNA VARIACIÓN
================================================================================

Vamos a randomizar las velocidades:

    python3 als_analyzer.py generated_project.als randomize-vel 70 127

Esto creará "generated_project_modified.als" con todas las notas
con velocidades aleatorias entre 70-127.

¡Ábrelo en Ableton Live para escuchar la diferencia!

================================================================================
📌 PASO 6: VER EJEMPLOS COMPLETOS
================================================================================

Para ver todas las funcionalidades:

    python3 ejemplo_uso.py

Esto ejecutará 6 ejemplos que mostrarán:
- Generación de proyectos
- Análisis
- Modificaciones
- Duplicación de clips
- Creación de variaciones

Al final tendrás 5+ proyectos nuevos.

================================================================================
📌 COMANDOS BÁSICOS
================================================================================

# Generar
python3 als_generator.py

# Analizar
python3 als_analyzer.py archivo.als info

# Modificar velocidades
python3 als_analyzer.py archivo.als randomize-vel MIN MAX

# Transponer
python3 als_analyzer.py archivo.als transpose SEMITONOS

# Duplicar clips
python3 als_analyzer.py archivo.als duplicate TRACK_INDEX NUM_COPIAS

# Exportar información
python3 als_analyzer.py archivo.als export archivo.txt

================================================================================
🎵 EJEMPLO PRÁCTICO COMPLETO
================================================================================

Vamos a crear un proyecto, modificarlo y guardarlo:

# 1. Crear proyecto base
python3 als_generator.py

# 2. Ver qué se creó
python3 als_analyzer.py generated_project.als info

# 3. Randomizar velocidades
python3 als_analyzer.py generated_project.als randomize-vel 80 120

# 4. Transponer +3 semitonos
python3 als_analyzer.py generated_project_modified.als transpose 3

# 5. Duplicar clips en track 1
python3 als_analyzer.py generated_project_modified_modified.als duplicate 1 3

# 6. ¡Abrir en Ableton Live!
# Archivo final: generated_project_modified_modified_modified.als

================================================================================
💡 CONSEJOS
================================================================================

1. Usa el archivo original como base:
   cp "jukeblocks - Pop.als" mi_proyecto.als

2. Crea múltiples variaciones:
   for i in {1..5}; do
     python3 als_analyzer.py mi_proyecto.als randomize-vel 60 127
   done

3. Experimenta con la transposición:
   python3 als_analyzer.py mi_proyecto.als transpose -5   # Más grave
   python3 als_analyzer.py mi_proyecto.als transpose 7    # Más agudo

4. Combina modificaciones:
   python3 -c "
   from als_analyzer import ALSModificator
   m = ALSModificator('mi_proyecto.als')
   m.load_als()
   m.randomize_velocities(70, 127)
   m.transpose_notes(2)
   m.duplicate_clips(1, 2)
   m.save_als('resultado_final.als')
   "

================================================================================
📚 DOCUMENTACIÓN COMPLETA
================================================================================

Para más información:
- README.md: Documentación completa
- RESUMEN.md: Resumen ejecutivo del proyecto
- COMANDOS_UTIL.txt: Lista de comandos avanzados

================================================================================
❓ SOLUCIÓN DE PROBLEMAS
================================================================================

Problema: "No se encontró el archivo"
Solución: Asegúrate de estar en el directorio /mnt/c/als_gen

Problema: "Python no encontrado"
Solución: Instala Python 3.6+ o usa python3 en lugar de python

Problema: El archivo .als no abre en Ableton
Solución: Verifica que el archivo existe con: ls -lh *.als

================================================================================
✅ ¡ESTÁS LISTO!
================================================================================

Ahora puedes:
✓ Generar proyectos .als desde cero
✓ Analizar proyectos existentes
✓ Modificar y crear variaciones
✓ Abrir todo en Ableton Live 12 Suite

¡Experimenta y diviértete creando música!

================================================================================
                            🎵 ¡A CREAR MÚSICA! 🎵
================================================================================