RC Setlist · Documentação

Perguntas frequentes

O RC Setlist é open source?

Ele é source-available sob a PolyForm Noncommercial 1.0.0. Uso, modificação e redistribuição não comerciais são permitidos conforme a licença; uso comercial não é permitido. A PolyForm Noncommercial não é uma licença open source aprovada pela OSI.

O usuário final precisa de Node.js?

Não. Instale o .ablx da release. O Node.js 24.16.0 serve apenas para desenvolvimento.

O que é o RC Bridge, e ainda preciso do AbletonOSC?

O RC Bridge é o Remote Script do Live com que o RC Setlist conversa para transporte e operações do Live Object Model. É um fork do AbletonOSC (<https://github.com/ideoforms/AbletonOSC>, MIT) que responde a cada cliente na porta dele — assim nunca disputa a porta de resposta com outra extensão RC e convive com um AbletonOSC comum. Ele vem dentro da extensão e dentro do kit de instalação; o instalador do kit (Install-RC-Bridge.cmd / Install RC Bridge.command) copia para a User Library do Live. Você não precisa do AbletonOSC — mas se já tem, o RC Setlist continua funcionando com ele.

Por que o navegador mostra um aviso de certificado?

Na primeira conexão, o navegador pode mostrar ERR_CERT_AUTHORITY_INVALID porque o RC Setlist cria um certificado local autoassinado para WebSockets seguros. 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.

Onde as letras ficam salvas?

No diretório de armazenamento de Ableton Extensions, dentro do perfil ativo do RC Setlist. Use o editor interno em vez de editar os arquivos diretamente.

Posso usar minhas letras?

Somente se você for o autor ou tiver autorização. O repositório e o kit de demonstração usam texto fictício; o RC Setlist não fornece letras comerciais.

O macOS funciona?

O código foi projetado para ser portátil, mas a versão 0.5.0 mantém o macOS como experimental até existir uma matriz completa em hardware real.

Posso expor o RC Setlist na internet?

Não. Ele foi projetado para uma rede local confiável. Nunca exponha a porta 4444 diretamente à internet.

Posso vender o RC Setlist ou uma modificação?

Não sob a PolyForm Noncommercial 1.0.0. Leia a licença e procure orientação jurídica própria para um caso específico.

Por que a duração total do meu setlist está diferente do esperado?

Se o seu projeto no Ableton Live possui automações de andamento desenhadas na faixa master do Arrangement e os locators não contêm a tag [bpm N], a extensão não consegue ler a curva de automação. Nem o Live Object Model nem o Extensions SDK expõem os pontos de automação da linha do tempo remotamente.

Sem tags declaradas, o RC Setlist calcula a duração usando o andamento corrente do Live como estimativa uniforme e exibe a etiqueta EST.. Em um setlist real de 21 faixas com andamentos entre 93 e 166 BPM, essa estimativa gerou uma distorção de 16:59 (95:40 contra os 78:41 reais).

Para obter durações exatas, adicione [bpm N] no nome do locator de cada música (ex.: Nome da Música [bpm 120]). O RC Setlist passará a usar o modo de confiança declarada com cálculo trecho a trecho e removerá o aviso EST..

Por que não ouço a contagem?

Por padrão, a contagem de 1 compasso é apenas visual (mostrando 1 2 3 4 no botão Play no navegador), para que o celular do operador não apite pelo alto-falante no palco. Se você quiser ouvir o click, ative-o por aparelho definindo rc-setlist.count-in-audio como true no localStorage do navegador (ex.: via console de desenvolvedor num notebook que alimenta um retorno de ouvido). O menu "Count-In" embutido no Live não se aplica ao Play, apenas à gravação.

Como atualizo da versão 0.x?

O produto foi renomeado de Ableton RC Setlist para RC Setlist na 1.0. Rode o 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 e nunca sobrescreve um arquivo que já existe no destino. Em seguida, no Live, abra Configurações > Extensões e remova a entrada antiga Ableton RC Setlist, 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.

Automação de tempo desenhada no Live

Se o seu Arrangement tem automação de tempo própria, mantenha Definir o tempo do Live ao pular desligado no painel do Live. Ele já vem desligado, e o motivo é este.

Um pulo explícito pode escrever o tempo de destino no Live antes de mover o playhead. Escrever song.tempo sobrepõe a automação de tempo do Live: o arranjo para de seguir o próprio envelope até você clicar em Re-Enable Automation na barra de transporte. Um pulo no meio do show achataria o tempo do resto do set.

O RC Setlist também vigia isso sozinho. Quando o tempo que o Live reporta diverge da tag [bpm N] declarada naquele ponto do setlist, a extensão conclui que alguém além do setlist é dono do tempo e se recusa a escrever, mesmo com a opção ligada.

Uma tag [bpm N] significa "meça a duração com isto". Ela não significa "imponha isto ao Live". Marcar as suas músicas é seguro com automação de tempo, e é o que transforma uma duração estimada do set numa duração exata.

Ligue a opção apenas quando as tags forem a sua fonte de verdade para o tempo e o Arrangement não tiver automação de tempo.

Rendered from docs/pt-BR/FAQ.md on 2026-09-24.