akomlik/find-music

Coincidencia de Música en Vivo y desde Colección Local (/find-music)

Propósito

Implementa el "Flujo de Trabajo de Música para Video" y la "Ley Antimonotonía y de No Reutilización Obligatoria de Música":

1. Cero Reutilización de Música entre Proyectos: Cada video debe tener un paisaje sonoro único. Las pistas utilizadas en proyectos anteriores (04_Project_Catalog/*/Storyboard.md y .fcproj) se excluyen automáticamente.
2. Búsqueda en Línea Obligatoria Hasta que la Colección Local Supere los 100 Títulos: Debido a que las colecciones locales pequeñas generan elecciones repetitivas de banda sonora, /find-music y /storyboard consultan nuevas pistas libres de derechos del Catálogo Directo en Línea de CreatorMix (fetch_creatormix_catalog.py) y de la Biblioteca de Audio de YouTube Studio antes de reutilizar cualquier pista local existente.
3. Obtención Directa desde CDN sin Fricciones: En lugar de requerir navegación manual para cada canción, fetch_creatormix_catalog.py consulta más de 134 pistas seguras de copyright directamente de 21 álbumes, filtra por duración < 3:00 y descarga directamente desde las URL de flujo CDN en 03_Audio_Library/01_Curated_BGM/<Categoría>/[BPM]_[Mood]_[TrackName]_[Artist].mp3.

Estándar de Directorio y Taxonomía

Todas las pistas guardadas residen dentro de 03_Audio_Library/01_Curated_BGM/:

• 01_Rolling_Cadence/ — 110–125 BPM: pedaleo constante, carreteras llanas, carriles costeros
• 02_Scenic_Wonder/ — 80–105 BPM Ambiental / Melódico: panorámicas amplias, cumbres, arcoíris, senderos costeros
• 03_Punchy_Climbs/ — 120–140 BPM Alegre / Enérgico: esfuerzos fuera del sillín, descensos rápidos
• 04_Warm_Social_And_Retro/ — 75–115 BPM Acústico / Bossa / Café / Retro: viajes al mercado (SaPobla_Market_Trip), paradas en cafeterías, fiestas y presentaciones de diapositivas de archivo de 1977+ / 1980–1984
• 05_Short_Transitions/ — 15–30s ráfagas, riffs cómicos, introducciones rápidas

Formato de Nombre de Archivo: [BPM]_[Mood]_[TrackName]_[Artist].mp3
(Ejemplos: 118bpm_ChillBeat_CircuitRush_TheMiniVandals.mp3, 085bpm_WarmChillhop_BubbleGum_Creatormix.mp3)

Flujo de Trabajo de Ejecución Paso a Paso

Paso 1: Analizar el Perfil de Movimiento y Duración del Proyecto/Clip

1. Leer <project_dir>/Storyboard.md y <project_dir>/project_manifest.json (o inspeccionar el clip de video objetivo).
2. Determinar la duración del video objetivo (regla: < 3:00) y las fases de la escena (p. ej., 01_Rolling_Cadence $\rightarrow$ 04_Warm_Social_And_Retro).
3. Escanear proyectos anteriores en 04_Project_Catalog/ para compilar la lista de pistas excluidas (ya utilizadas).

Paso 2: Obtener Música Nueva (CLI Directo de CreatorMix o Navegador de YouTube Studio)

Opción A: Búsqueda en Línea Directa de CreatorMix y Descarga Automática (Instantánea, Sin Fricción de Navegador)

Ejecute fetch_creatormix_catalog.py con su género o términos de búsqueda deseados:

# Buscar pistas nuevas nunca utilizadas en un género específico:
python3 ./.agents/skills/find-music/scripts/fetch_creatormix_catalog.py --genre chillhop --max-duration 180

# Descargar la pista ganadora (p. ej., candidata #2):
python3 ./.agents/skills/find-music/scripts/fetch_creatormix_catalog.py --genre chillhop --download-idx 2

¡El script descarga el MP3 de alta calidad directamente desde la CDN de CreatorMix, lo formatea con la convención de nomenclatura estándar [BPM]_[Mood]_[TrackName]_Creatormix.mp3, lo mueve a 03_Audio_Library/01_Curated_BGM/<Categoría>/ y actualiza music_catalog.json automáticamente!

Opción B: Pestaña del Navegador de la Biblioteca de Audio de YouTube Studio (studio.youtube.com)

Si busca estados de ánimo ambientales o vintage específicos en la Biblioteca de Audio de YouTube:

1. Conéctese mediante chrome-devtools o /browser a su pestaña abierta de YouTube Studio.
2. Aplique filtros: Duración < 3:00, Género (Dance & Electronic, Ambient, Folk & Acoustic), Estado de ánimo (Inspirational, Happy, Calm).
3. Descargue la pista a ~/Downloads y ejecute save_music_track.py para etiquetarla y moverla automáticamente:

   python3 ./.agents/skills/find-music/scripts/save_music_track.py \
     --source latest \
     --bpm 118 \
     --mood "ChillBeat" \
     --title "Circuit Rush" \
     --artist "The Mini Vandals" \
     --category "01_Rolling_Cadence" \
     --source-site "YouTube_Audio_Library"
   

Paso 3: Confirmar al Creador y Ofrecer Ubicación en la Línea de Tiempo

Informe a Alexander sobre la nueva pista y ofrezca colocarla en la pista A2 mediante /swap-music, /magic-movie o /build-cut-table.