Documentação — Speaker Cuts

Requisitos

Adobe Premiere Pro 2024 ou posterior (CEP 12+), em macOS ou Windows.
ffmpeg instalado e disponível no PATH (usado para extrair o áudio).
O servidor de análise do Speaker Cuts (incluído no instalador).
Opcional: GPU NVIDIA com CUDA para análise local acelerada, ou uma chave de API para processamento na nuvem.

Guia de instalação

1. Habilite extensões não-assinadas

Durante o beta, o painel roda como extensão não-assinada. Ative o modo de depuração uma única vez:

macOS — no Terminal:

defaults write com.adobe.CSXS.12 PlayerDebugMode 1

Windows — no Editor de Registro (regedit), em HKEY_CURRENT_USER\Software\Adobe\CSXS.12, crie um valor de texto PlayerDebugMode com o valor 1.

Nota: o número 12 corresponde à versão do CEP. Premiere Pro 2024+ usa 12; versões anteriores podem usar 11 ou 10.

2. Copie o painel para a pasta de extensões

macOS:

~/Library/Application Support/Adobe/CEP/extensions/

Windows:

%APPDATA%\Adobe\CEP\extensions\

3. Reinicie o Premiere Pro

Feche e abra o Premiere. O painel aparece em Window › Extensions › Speaker Cuts.

Como usar

Com uma sequência aberta na timeline e o painel visível, o fluxo tem quatro passos:

Passo 1 — Extrair áudio

Clique em Extrair Áudio. O plugin extrai o áudio da sequência ativa via ffmpeg (mono, 16 kHz), respeitando a duração real da timeline.

Passo 2 — Analisar speakers

Clique em Analisar Speakers. O áudio é enviado ao servidor de diarização. Se você souber quantas pessoas falam, informe o número para resultados ainda melhores — ou deixe a IA detectar sozinha. Ao terminar, você vê a lista de speakers com tempo de fala e percentual.

Passo 3 — Mapear câmeras

Ouça cada speaker pelo botão de play, renomeie se quiser e associe cada um a uma faixa de vídeo (câmera). Defina a câmera geral (wide) e, se desejar, a frequência dos wide shots automáticos.

Passo 4 — Aplicar

Clique em Aplicar Multicam Edit para montar a edição completa, ou use Cortes Simples para apenas razor cuts e markers, sem multicam.

Todos os cortes entram pelo sistema de edição padrão do Premiere. Pode desfazer com Ctrl/Cmd+Z a qualquer momento.

Opções

N.º de speakers — dica opcional do número esperado de pessoas.
Frequência do wide shot — com que frequência o plano geral entra (desligado, pouco, médio ou muito).
Desativar áudio correspondente — silencia as faixas de áudio das câmeras não ativas.
Adicionar markers — markers coloridos em cada troca de speaker.
Cortar todos os tracks — corta vídeo + áudio, ou apenas áudio.

Solução de problemas

O painel não aparece no menu Extensions

Confirme que o PlayerDebugMode está como 1, que a pasta está no caminho correto e reinicie o Premiere por completo.

Servidor offline

Verifique se o servidor do Speaker Cuts está em execução e se a porta 3333 está livre.

ffmpeg não encontrado

Instale o ffmpeg e confirme que ele está no PATH do sistema (which ffmpeg no macOS, where ffmpeg no Windows).

Suporte

Travou em algum ponto ou encontrou um bug? Estamos por aqui.

E-mail: contato@magnadigital.com.br
Antes de escrever, dê uma olhada nas perguntas frequentes — boa parte das dúvidas é respondida lá.