# Solução de problemas

O RC Setlist não aparece no Live

• Confirme o Ableton Live 12.4.5+ Suite (Beta).
• Abra novamente o .ablx e confirme a instalação.
• Reinicie o Live e procure em Extensions > RC Setlist.

O RCBridge não aparece na lista de Control Surface

• Instale em User Library/Remote Scripts/RCBridge, e não na pasta oculta

User Remote Scripts das preferências do Live. O Install-RC-Bridge.cmd / Install RC Bridge.command do kit coloca no lugar certo.

• Confirme que RCBridge/__init__.py existe diretamente nessa pasta, sem

outro diretório RCBridge aninhado.

• Feche e abra o Live de novo depois de copiar; o Live lê a pasta ao iniciar.
• Selecione RCBridge como Control Surface; Input e Output podem permanecer

como None.

• A linha OSC do painel diz com qual script a extensão está falando de fato

(via RC Bridge 1.0.0 na porta 11020, ou via AbletonOSC na porta 11000), e mostra os passos de instalação quando não é o RC Bridge que responde.

O painel inicia, mas os controles OSC ou o playhead não respondem

• Escolha Verificar OSC no painel do RC Setlist.
• Live conectado significa que as respostas do remote script estão chegando

ao RC Setlist.

• Aguardando o AbletonOSC significa que o servidor local está rodando, mas

ainda não recebeu resposta. Confira novamente a pasta exata acima, a seleção de Control Surface e reinicie o Live.

• Conexão com AbletonOSC interrompida significa que havia respostas e elas

pararam.

• A extensão decide com qual script falar quando o servidor inicia. Se você

instalou e selecionou o RC Bridge com o servidor já rodando, aperte Reiniciar no painel.

• Play/Stop e o playhead em movimento são os testes OSC ponta a ponta mais claros.

Nenhuma música aparece

• Confirme que o Live Set tem locators no Arrangement.
• Comece o nome com uma música; use Música > Seção nas seções.
• Reinicie pelo painel depois de mudar a configuração da integração.

A página do navegador não abre

• Na primeira conexão, ERR_CERT_AUTHORITY_INVALID é o aviso esperado para o

certificado local autoassinado do RC Setlist. Continue somente se o endereço for exatamente o IP mostrado no painel do Live e a rede local for confiável. Cada navegador/aparelho pode exigir isso uma vez.

• Abra https://localhost:4444/health no host.
• Confirme que o painel informa que o servidor está em execução.
• Libere TCP 4444 somente no perfil de rede privada.
• Coloque host e controle na mesma LAN que não seja uma rede de convidados.
• Aceite o certificado autoassinado somente para esse endereço exato do painel.

Os controles estão somente para leitura

Abra a URL de controle ou leia o QR code de controle no painel. O token é obrigatório para transporte e escrita. Não o compartilhe publicamente.

Se músicas, letras e timecode atualizam, mas transporte e navegação falham, confirme que você usa 0.3.0 ou superior. Versões anteriores podiam falhar ao codificar comandos OSC no runtime embutido do Ableton.

O primeiro início mostra erro de persistência do perfil

Instale 0.3.0 ou superior. Versões anteriores podiam gravar o perfil inicial e falhar logo depois por usar uma API indisponível. Se o erro continuar, capture um trecho sanitizado de ExtensionHost.txt sem apagar os dados do perfil.

As letras não correspondem à música

• Confirme o perfil ativo.
• Confirme que a letra está associada ao título limpo da música.
• Remova tags de locator do nome usado na letra.
• Salve novamente no editor interno e atualize o estado.

Ao atualizar de uma versão antiga chamada RC SETLIST ou Ableton Setlist Bridge, reinicie o servidor uma vez. O RC Setlist importa letras e ordem ausentes das pastas conhecidas sem apagar pastas antigas ou substituir arquivos já existentes no perfil novo.

Ao atualizar do Ableton RC Setlist 0.x (0.4.x–0.7.0), rode Migrate-RC-Setlist-Data.cmd (Windows) ou Migrate RC Setlist Data.command (macOS) do kit uma vez, antes de abrir o Live com a 1.0. Ele copia perfis, project-setlists, token e preferências para a pasta nova sem mexer na antiga. No Live, remova a entrada antiga Ableton RC Setlist em Configurações > Extensões para que as duas extensões não coexistam na mesma máquina. Pular a migração ou deixar as duas instaladas faz os perfis antigos ficarem invisíveis para a extensão nova.

Outra extensão usa a porta OSC 11001

Isso só acontece com um AbletonOSC comum. Ele envia todas as respostas para a porta UDP fixa 11001; quando outra extensão RC já ocupa essa porta, o RC Setlist usa a porta 11101 como fallback, ainda pode enviar comandos, mas não recebe as respostas do AbletonOSC. O painel compacto mostra Live ativo · porta de retorno OSC ocupada.

A solução é o RC Bridge: ele responde na porta de quem perguntou, então cada extensão RC recebe as suas respostas e nada é compartilhado. Instale (veja INSTALL), selecione como Control Surface e reinicie o servidor.

Quando a ponte MCP local também está disponível, o fallback MCP mantém o playhead, o estado de reprodução e o tempo sincronizados e fornece a duração total. O RC Setlist também conserva localmente a quantização pedida pelo operador; ao escolher Nenhuma, os saltos de seção ficam imediatos mesmo com a porta de retorno OSC ocupada. Verificar OSC continua mostrando o conflito de porta corretamente, sem chamar o fallback de conexão OSC nativa.

Se a ponte MCP também estiver ausente, pare a outra extensão RC, reinicie o RC Setlist e use Verificar OSC novamente. Não tente forçar dois sockets a compartilhar a porta 11001 no Windows; apenas um deles receberá cada resposta. Para o diagnóstico OSC nativo, mantenha o início automático ligado em apenas uma extensão RC que dependa de OSC.

Aparecem setlists de outro Live Set

As versões atuais guardam vários setlists somente dentro do escopo do Live Set atual. A lista global de perfis de versões antigas não aparece no projeto aberto. Se o projeto foi trocado enquanto uma versão antiga estava rodando, reinicie o servidor do RC Setlist depois de abrir o .als correto.

Os dados globais antigos continuam preservados como backup. Somente a antiga pasta por projeto que corresponde exatamente ao Live Set salvo atual é importada automaticamente.

Se os metadados do projeto chegarem depois da inicialização, o escopo temporário do projeto é promovido ao escopo do .als salvo. Perfis criados durante a espera, inclusive Second Setlist, são copiados sem apagar a origem temporária. Em um Set não identificado, letras ausentes só são recuperadas quando uma única ordem personalizada antiga corresponde à lista completa de músicas atual; resultados ambíguos permanecem intactos.

O que incluir em um bug report

Inclua sistema operacional, versão/edição do Live, versão do RC Setlist, navegador, passos exatos e logs sanitizados. Remova tokens, certificados, caminhos locais e conteúdo real do setlist ou das letras. Consulte SUPPORT.md.