renato97/ableton-mcp-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
5ce8187c65df51ed7d50a374e125dc7771816988
ableton-mcp-ai/docs/skill_produccion_audio.md
OpenCode Agent 5ce8187c65 feat: Implement senior audio injection with 5 fallback methods 
- Add _cmd_create_arrangement_audio_pattern with 5-method fallback chain
- Method 1: track.insert_arrangement_clip() [Live 12+]
- Method 2: track.create_audio_clip() [Live 11+]
- Method 3: arrangement_clips.add_new_clip() [Live 12+]
- Method 4: Session->duplicate_clip_to_arrangement [Legacy]
- Method 5: Session->Recording [Universal]

- Add _cmd_duplicate_clip_to_arrangement for session-to-arrangement workflow
- Update skills documentation
- Verified: 3 clips created at positions [0, 4, 8] in Arrangement View

Closes: Audio injection in Arrangement View
2026-04-12 14:02:32 -03:00

6.8 KiB
Raw Blame History

Skill: Producción Senior de Audio en Ableton Live

Descripción

Flujo profesional completo para producción de pistas de audio en Ableton Live usando inyección automática en Arrangement View con selección inteligente de samples.

Casos de Uso

  • Producción de beats reggaetón con samples de librería
  • Creación de drum patterns (kick, snare, hi-hat, perc)
  • Layering de múltiples tracks de audio
  • Composición timeline-based sin Session View

Flujo de Producción Automático

Paso 1: Verificar Sistema

# Health check antes de empezar
ableton-live-mcp_health_check
# Resultado esperado: 5/5 checks OK

Paso 2: Escaneo de Librería (Opcional)

# Escanear samples disponibles
ableton-live-mcp_scan_library
ableton-live-mcp_scan_library --subfolder reggaeton/kick
ableton-live-mcp_scan_library --subfolder reggaeton/snare

Paso 3: Crear Tracks de Audio

# Crear tracks específicos para cada elemento
ableton-live-mcp_create_audio_track  # Kick
ableton-live-mcp_create_audio_track  # Snare
ableton-live-mcp_create_audio_track  # Hi-Hat
ableton-live-mcp_create_audio_track  # Bass

Paso 4: Inyección Senior de Audio

Patrón Único (1 clip)

ableton-live-mcp_create_arrangement_audio_pattern(
    track_index=3,
    file_path="C:\\...\\libreria\\reggaeton\\kick\\kick 1.wav",
    positions=[0],
    name="IntroKick"
)

Patrón de 4 Tiempos (4 clips)

ableton-live-mcp_create_arrangement_audio_pattern(
    track_index=3,
    file_path="C:\\...\\libreria\\reggaeton\\kick\\kick 1.wav",
    positions=[0, 4, 8, 12],
    name="KickLoop"
)

Patrón Completo (16 compases)

ableton-live-mcp_create_arrangement_audio_pattern(
    track_index=3,
    file_path="C:\\...\\libreria\\reggaeton\\kick\\kick 1.wav",
    positions=[0, 4, 8, 12, 16, 20, 24, 28, 32, 36, 40, 44, 48, 52, 56, 60],
    name="FullKick"
)

Paso 5: Verificación Visual

# Confirmar clips en Arrangement View
ableton-live-mcp_get_arrangement_status
ableton-live-mcp_get_arrangement_clips

Arquitectura de Inyección (5 Métodos Automáticos)

El sistema intenta automáticamente los siguientes métodos en orden:

Método 1: track.insert_arrangement_clip()      [Live 12+ - Directo]
Método 2: track.create_audio_clip()            [Live 11+ - Directo]  
Método 3: arrangement_clips.add_new_clip()     [Live 12+ - API Arrangement]
Método 4: Session → duplicate_clip_to_arrangement  [Legacy]
Método 5: Session → Recording               [Universal Fallback]

Zero configuración manual - El sistema elige automáticamente el mejor método disponible.

Ejemplos de Producción

Ejemplo 1: Drum Kit Básico (Kick + Snare)

# Kick en track 3
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 3 \
    --file_path "C:\\...\\reggaeton\\kick\\kick 1.wav" \
    --positions "[0, 4, 8, 12]" \
    --name "Kick"

# Snare en track 4
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 4 \
    --file_path "C:\\...\\reggaeton\\snare\\snare 1.wav" \
    --positions "[2, 6, 10, 14]" \
    --name "Snare"

Ejemplo 2: Pattern Completo (4/4 Time)

# Kick cada compás
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 3 \
    --file_path "C:\\...\\kick\\kick 1.wav" \
    --positions "[0, 4, 8, 12, 16, 20, 24, 28]"

# Snare en 2 y 4
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 4 \
    --file_path "C:\\...\\snare\\snare 1.wav" \
    --positions "[4, 12, 20, 28]"

# Hi-hat cada medio compás
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 5 \
    --file_path "C:\\...\\hi-hat\\hihat 1.wav" \
    --positions "[2, 6, 10, 14, 18, 22, 26, 30]"

Ejemplo 3: Variaciones de Intensidad

# Intro - Kick solo
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 3 \
    --file_path "...\\kick 1.wav" \
    --positions "[0, 4]" \
    --name "Intro"

# Verse - Full drums
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 3 \
    --file_path "...\\kick 1.wav" \
    --positions "[8, 12, 16, 20, 24, 28, 32, 36]" \
    --name "Verse"

# Chorus - Full + extras
ableton-live-mcp_create_arrangement_audio_pattern \
    --track_index 3 \
    --file_path "...\\kick 2.wav" \
    --positions "[40, 44, 48, 52, 56, 60]" \
    --name "Chorus"

Formatos de Posiciones

Compases a Beats (Automático)

  • 0 = Compás 1, beat 1
  • 4 = Compás 2, beat 1
  • 8 = Compás 3, beat 1
  • 12 = Compás 4, beat 1

Sincronización por Tempo

El sistema automáticamente:

  1. Convierte posiciones en beats según tempo del proyecto
  2. Sincroniza con grid de Ableton
  3. Aplica warping si es necesario

Resolución de Problemas

"created_count: 0"

Causa: Ningún método funcionó
Solución: Verificar:

  • Archivo existe y es formato soportado (WAV, AIFF, MP3)
  • Track index es válido
  • Track es audio track (no MIDI)

Clips muy cortos

Causa: Sample no tiene duración definida
Solución: Usar samples WAV con duración completa, no one-shots cortos

Posiciones incorrectas

Causa: Usando Método 5 (recording fallback)
Solución: Normal, tiene ±1 beat de tolerancia. Para precisión absoluta, reiniciar Ableton para activar Métodos 1-3.

Referencia Técnica

Métodos del Live Object Model

  • track.insert_arrangement_clip(path, start_beat, end_beat) - Live 12+
  • track.create_audio_clip(path, position) - Live 11+
  • arrangement_clips.add_new_clip(start, end) - Live 12+
  • song.duplicate_clip_to_arrangement(track, slot, pos) - Legacy

Formatos Soportados

  • WAV (recomendado)
  • AIFF
  • MP3
  • FLAC

Tracks por Defecto

  • Track 0-1: MIDI (reservados)
  • Track 2+: Audio (disponibles para inyección)

Anti-Patrones de Producción

❌ NO cargar samples manualmente en Session View antes de inyectar
❌ NO usar grabación manual cuando existe inyección automática
❌ NO duplicar clips manualmente con Ctrl+D
❌ NO ajustar posiciones manualmente después de inyección

Mejores Prácticas

✅ SIEMPRE verificar ableton-live-mcp_health_check antes de empezar
✅ USAR rutas absolutas para archivos de audio
✅ PLANIFICAR posiciones en beats (múltiplos de 4 para compases)
✅ NOMBRAR clips descriptivamente ("KickVerse", "SnareFill")
✅ VERIFICAR en Arrangement View después de inyección

Integración con Workflow Completo

# Paso 1: Reinicio (usar skill_reinicio_ableton.md)
# Paso 2: Producción (usar esta skill)
# Paso 3: Mezcla (aplicar EQ/compresión)
# Paso 4: Master (exportar)

Historial

  • v1.0 (2026-04-12): Skill de producción senior con 5 métodos de inyección
  • Autor: AbletonMCP_AI Senior Architecture Team

Relacionado

  • skill_reinicio_ableton.md - Proceso de reinicio correcto
  • ../README.md - Documentación general del proyecto
Reference in New Issue View Git Blame Copy Permalink