Audio Cue Locator
Ferramenta para localizar sinas de áudio conhecidos dentro de arquivos maiores de áudio ou vídeo.
O ACL recebe uma mídia-fonte e um ou mais cues de referência, localiza suas ocorrências no tempo e apresenta resultados por cue com posições, scores de similaridade, prévia em áudio e exportação em JSON.
O que o projeto faz
O Audio Cue Locator (ACL) localiza trechos de áudio conhecidos dentro de arquivos maiores de áudio ou vídeo. O usuário fornece uma mídia-fonte e um ou mais sinais de audio em WAV; o backend prepara o áudio em um formato canônico, procura ocorrências de cada referência e devolve posições na linha do tempo com scores de similaridade específicos do método. O mesmo núcleo atende a WebUI e a REST API.
Da configuração aos resultados
A WebUI mantém todo o fluxo em uma única tela. Cada cue (sinal de som) pode ter um nome e limites opcionais de início e fim, que restringem a região pesquisada na mídia-fonte sem recortar o próprio cue.
Depois que a análise é criada, os resultados são agrupados por cue, exibindo a quantidade de ocorrências, o método de matching efetivamente utilizado e uma opção para exportar o resultado estruturado em JSON.
Inspecionando as ocorrências
Cada grupo de cues pode ser expandido para revisar as ocorrências em ordem cronológica. A interface separa índice, posição no ranking de similaridade, posição temporal e score, além de permitir ouvir o cue e o trecho correspondente da mídia-fonte.
O score é específico do método de matching. Ele não representa uma porcentagem nem uma confiança estatística, e o threshold efetivamente utilizado é preservado como parte da configuração da análise.
Escopo atual
A implementação atual oferece o fluxo principal de ponta a ponta para localizar trechos de áudio conhecidos em arquivos maiores de áudio ou vídeo, incluindo canonicalização de mídia, configuração do matching, inspeção das ocorrências, reprodução e exportação estruturada dos resultados. Esta implementação representa o baseline concluído definido para o projeto.
Por que este projeto importa
Além do matching acústico, o ACL explora como transformar processamento de sinais em um produto rastreável: configuração efetiva preservada em cada análise, resultados versionados, persistência local e uma API e uma WebUI construídas sobre o mesmo núcleo da aplicação.
O baseline implementado representa o escopo concluído deste projeto, enquanto evoluções futuras poderão ser exploradas de forma independente.