Primeiros passos com o RC Setlist 1.0

Este guia leva de uma instalação nova do Live até um setlist rodando em menos de 15 minutos. Se algo aqui não bater com o que você vê na tela, abra uma issue com a label docs/wrong.

• 1. Instalar
• 2. Abrir o Live e habilitar o RC Setlist
• 3. Primeiro setlist em três locators
• 4. Abrir o painel
• 5. Parear o celular do palco
• Próximos passos

1. Instalar

Você precisa de:

• Ableton Live 12.4.5 Suite (Beta) ou mais recente, com Extensions

habilitado.

• macOS 13+ (caminho de release) ou Windows 11 23H2+ (caminho de

release). Linux não é suportado pelo host; o bridge é Python e roda onde o Live rodar.

• Um navegador moderno no celular (Safari 17+, Chrome 121+) para o

Stage Control.

Abra o kit baixado da página de release e dê duplo clique no instalador do seu sistema. O instalador copia o RC Bridge para a User Library do Live e imprime a URL final do painel local.

Se preferir fazer manualmente, siga INSTALL.md. A instalação 1.0 é uma pasta RC Bridge mais a extensão .ablx; nada mais precisa estar no disco.

2. Abrir o Live e habilitar o RC Setlist

1. Abra o Ableton Live. 2. Em Preferences → Extensions, confirme que RC Setlist aparece na lista com status Enabled. 3. Extensions → RC Setlist → Open panel abre o painel do host. 4. O painel mostra a URL local, o token de controller como QR code, e o IP de LAN autodetectado.

A URL é https://<lan-ip>:4444/; o QR embute a mesma URL com o token na query string. Trate o QR como senha — quem escanear consegue parar o transporte.

3. Primeiro setlist em três locators

O Live usa locators (cue points no Arrangement). Cada um carrega o título da música mais tags opcionais dentro de colchetes [ ]. O RC Setlist transforma isso em músicas e seções.

Crie um Set novo, marque o tempo em 120 BPM, e adicione três locators:

| Beat | Nome | Notas | | ---- | -------------------- | ------------------ | | 0 | INTRO | Primeira música | | 16 | > Verso | Seção da INTRO | | 48 | MÚSICA 2 [bpm 100] | Próxima em 100 BPM |

Abra o painel e confirme que você vê:

• INTRO listada como música atual
• Verso listada como seção da INTRO
• MÚSICA 2 listada como música separada com BPM 100

Se o painel não mostrar nada, confira o painel de logs; um locator malformado é a causa mais comum.

4. Abrir o painel

O painel é a interface principal do operador. Mostra a música atual, o cronômetro, o próximo locator e os controles de play, stop, jump e edição. Espaço alterna play/stop; N e P pulam para o próximo e o anterior locator; J abre um diálogo para digitar o nome de um marker e pular para ele.

A referência completa está em USER-GUIDE.md.

5. Parear o celular do palco

1. No celular do palco, escaneie o QR do painel. 2. O celular abre a página de Stage Control na mesma URL, com o token já na query string. 3. Toque em Confirmar controller para registrar o celular como controller desta sessão.

O celular passa a mostrar a próxima música, o índice da seção, o cronômetro e a letra. Não há app separado de pareamento; o único estado que o celular precisa é a URL.

Se o celular perder a conexão, o painel re-renderiza e a URL continua válida até você reiniciar o Live.

Próximos passos

• USER-GUIDE.md — referência completa do painel e

do Stage Control.

• CONTRATOS.md — o contrato público (HTTP, WS,

gramática de locators). Leia se quiser escrever seu próprio controller.

• THEME_CONTRACT.md — paleta e tipografia se

você quer uma skin custom para o Stage Control.

• TESTER-GUIDE.md — o que conferir num release

candidate antes de mandar pra banda.

• DEVELOPMENT.md — como rodar os testes e buildar

a extensão localmente.