akomlik/find-music

Localizador de Música ao Vivo e do Acervo Local (/find-music)

Propósito

Implementa o "Fluxo de Trabalho de Música para Vídeo" e a Lei Antimonotonia e de Não Reutilização Obrigatória de Música:

1. Reutilização Zero de Música Entre Projetos: Cada vídeo deve ter uma paisagem sonora única. Faixas usadas em projetos anteriores (04_Project_Catalog/*/Storyboard.md e .fcproj) são automaticamente excluídas.
2. Pesquisa Online Obrigatória Até o Acervo Local Ter Mais de 100 Títulos: Como acervos locais pequenos levam a escolhas repetitivas de trilha sonora, /find-music e /storyboard consultam faixas royalty-free novas do Catálogo Online Direto da CreatorMix (fetch_creatormix_catalog.py) e da Biblioteca de Áudio do YouTube Studio antes de reutilizar qualquer faixa local existente.
3. Captura Direta e Sem Atrito via CDN: Em vez de exigir navegação manual no navegador para cada música, o fetch_creatormix_catalog.py consulta 134+ faixas seguras de direitos autorais diretamente de 21 álbuns, filtra por duração < 3:00 e baixa diretamente pelas URLs de stream CDN para 03_Audio_Library/01_Curated_BGM/<Categoria>/[BPM]_[Mood]_[TrackName]_[Artist].mp3!

Diretório Padrão e Taxonomia

Todas as faixas salvas ficam em 03_Audio_Library/01_Curated_BGM/:

• 01_Rolling_Cadence/ — 110–125 BPM: pedalada constante, estradas planas, faixas costeiras
• 02_Scenic_Wonder/ — 80–105 BPM Ambiente / Melódico: panoramas amplos, cumes, arco-íris, caminhadas costeiras
• 03_Punchy_Climbs/ — 120–140 BPM Animado / Intenso: esforços fora do selim, descidas rápidas
• 04_Warm_Social_And_Retro/ — 75–115 BPM Acústico / Bossa / Café / Retro: idas ao mercado (SaPobla_Market_Trip), paradas em cafés, festas e apresentações de slides de arquivo de 1977+ / 1980–1984
• 05_Short_Transitions/ — 15–30s vinhetas, riffs cômicos, introduções rápidas

Formato do Nome do Arquivo: [BPM]_[Mood]_[TrackName]_[Artist].mp3
(Exemplos: 118bpm_ChillBeat_CircuitRush_TheMiniVandals.mp3, 085bpm_WarmChillhop_BubbleGum_Creatormix.mp3)

Fluxo de Trabalho Passo a Passo

Passo 1: Analisar o Perfil de Movimento e a Duração do Projeto/Clipe

1. Leia <project_dir>/Storyboard.md e <project_dir>/project_manifest.json (ou inspecione o clipe de vídeo alvo).
2. Determine a duração alvo do vídeo (regra: < 3:00) e as fases da cena (ex.: 01_Rolling_Cadence $\rightarrow$ 04_Warm_Social_And_Retro).
3. Escaneie projetos anteriores em 04_Project_Catalog/ para compilar a lista de faixas excluídas (já usadas).

Passo 2: Obter Música Nova (CreatorMix Direto via CLI ou Navegador YouTube Studio)

Opção A: Pesquisa Online Direta CreatorMix e Download Automático (Instantâneo, Zero Atrito no Navegador)

Execute fetch_creatormix_catalog.py com o gênero ou termo de pesquisa desejado:

# Pesquisar faixas novas nunca usadas em um gênero específico:
python3 ./.agents/skills/find-music/scripts/fetch_creatormix_catalog.py --genre chillhop --max-duration 180

# Baixar a faixa vencedora (ex.: candidato #2):
python3 ./.agents/skills/find-music/scripts/fetch_creatormix_catalog.py --genre chillhop --download-idx 2

O script baixa o MP3 de alta qualidade diretamente do CDN da CreatorMix, formata-o com a convenção de nomenclatura padrão [BPM]_[Mood]_[TrackName]_Creatormix.mp3, move-o para 03_Audio_Library/01_Curated_BGM/<Categoria>/ e atualiza music_catalog.json automaticamente!

Opção B: Aba do Navegador da Biblioteca de Áudio do YouTube Studio (studio.youtube.com)

Se estiver pesquisando ambientes específicos ou climas vintage na Biblioteca de Áudio do YouTube:

1. Conecte-se via chrome-devtools ou /browser à sua aba aberta do YouTube Studio.
2. Aplique filtros: Duração < 3:00, Gênero (Dance & Electronic, Ambient, Folk & Acoustic), Clima (Inspirational, Happy, Calm).
3. Baixe a faixa para ~/Downloads e execute save_music_track.py para etiquetar e mover automaticamente:

   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"
   

Passo 3: Confirmar ao Criador e Oferecer Posicionamento na Linha do Tempo

Informe a Alexander sobre a nova faixa e ofereça-se para colocá-la na faixa A2 via /swap-music, /magic-movie ou /build-cut-table.