tdmcp

Português

English

Português

English

Appearance

Timelines & setlists de show ​

Um look é um momento; um show é a noite inteira. Esta trilha é a camada de compor-e-automatizar: monte o container do show, armazene e recupere cues, role uma setlist no relógio de parede, sequencie cues no beat e mantenha um blackout de segurança a um botão de distância. Você descreve a ordem e a sensação; o tdmcp constrói os timers, transições e controles.

Use estas ferramentas quando estiver saindo de fazer visuais para rodar um set — uma noite de DJ, um slot de VJ, uma pilha de cues de teatro, uma instalação que precisa rodar sozinha em loop.

Comece com um palco ​

scaffold_show cria o esqueleto em branco: um novo container com um Null de saída master (onde a sua mix chega) e um clock de beat tempo para reatividade — mas ainda sem cenas. É a tela onde você pendura todo o resto:

"Faça o scaffold de um show chamado mainstage e mostre o container."

A partir daí você adiciona looks, salva como cues e conecta o transporte.

Cues: armazenar, recuperar, morphar ​

manage_cue é a base de todo fluxo com cues. Ele armazena, recupera, morpha, lista e apaga cues — snapshots dos parâmetros customizados de um COMP, guardados no próprio storage do COMP. Um morph pode ser suavizado e quantizado ao beat ou ao compasso:

"Salve o look atual como cue drop e morphe para ele em 2 compassos quando eu recuperar."

Quase tudo abaixo recupera do manage_cue: o sequenciador, a timeline, o launcher de clips e o navegador de set leem o mesmo store de cues.

Timelines ​

  • create_scene_timeline (Layer 2) constrói um playhead scrubbável dirigido por timer através de uma lista ordenada de cenas. Cada cena aponta para um cue salvo e morpha na próxima na sua fronteira, em segundos ou compassos. A receita Scene Timeline Demo mostra isso com três cenas e um crossfade.
  • control_timeline_transport (Layer 3) é o verbo atômico de transporte: play, pause, seek para um frame, pular para um cue nomeado ou ajustar a taxa de reprodução — o gancho que um operador ou o copiloto local usa para dirigir a reprodução.

"Construa uma timeline de 3 cenas que faça crossfade intro → build → drop em 8 compassos cada e dê play."

Setlists ​

  • create_setlist_runner (Layer 1) é um player de setlist no relógio de parede: linhas de (TOP fonte, duração, transição) avançam sozinhas num Timer CHOP com crossfade ou corte seco, um overlay de HUD opcional e controles ao vivo de Play / Row / Skip / Prev / Loop. É a ferramenta "toque estes clips nesta ordem, por tanto tempo cada".
  • compose_cue_list (Layer 1) transforma uma descrição em linguagem natural do show numa cue list validada. Usa o LLM local quando configurado, ou um parser de gramática determinístico, e pode encadear direto no sequenciador com apply=true.

Com um vault Obsidian configurado, você também persiste setlists como notas: import_setlist carrega uma nota de setlist e constrói a receita de cada faixa no TD, e export_setlist_to_vault escreve os cues salvos do COMP de volta como uma nota de setlist.

"Rode uma setlist: clip A por 30 s, clip B por 45 s, clip C por 60 s, crossfade de 2 s entre cada, loop no fim, e mostre o HUD."

Sequenciamento no beat & composição de cues ​

Quando a ordem deve seguir a música em vez do relógio:

  • create_cue_sequencer (Layer 2) toca passos ordenados (cada um sendo um cue mais uma contagem de compassos/beats) quantizados ao tempo global, com controles ao vivo de Step / Active / Rate / Loop.
  • create_phrase_locked_cue_engine (Layer 1) enfileira pulsos de cue em FIFO e os dispara na próxima fronteira de frase (1/2/4/8/…/64 compassos), para que um hit disparado em qualquer ponto caia limpo na próxima frase.
  • create_set_navigator (Layer 1) é um navegador de palco no estilo QLab, com a mão leve — percorra uma lista ordenada de nomes de cena/cue com controles Index / Next / Prev / Go, recuperando cada um via manage_cue.
  • create_clip_launcher (Layer 2) dispõe os cues numa grade de botões linhas × colunas que recupera ou morpha ao toque.
  • create_scheduler (Layer 2) dispara timers nomeados com segmentos — recupera um cue, ajusta um parâmetro ou roda um stub de script — em cada fronteira de segmento.

Para travar tudo isso num transporte externo, sync_external_clock (Layer 1) conecta MIDI, OSC, Ableton Link ou um tempo de rede num Beat CHOP, para que o sequenciador, o motor de phrase-lock e os morphs quantizados sigam o clock que chega.

Segurança ao vivo ​

Um show precisa de um botão de pânico que sempre funciona:

  • create_safety_blackout_chain (Layer 1) protege a saída master com um fade-to-black determinístico (curva e tempo configuráveis), um corte seco de emergência opcional, um atalho de teclado e um gatilho de watchdog externo, ambos opcionais, e uma recuperação por fade-in simétrico. É totalmente dirigido por parâmetros — sem Python no cook — então permanece seguro mesmo com TDMCP_BRIDGE_ALLOW_EXEC=0.
  • create_panic (Layer 2) adiciona um kill + freeze por fonte: um toggle de Blackout que leva o brilho a zero e um toggle de Freeze que segura o último frame.

"Adicione um blackout de segurança na saída master com fade ease-out de 1,5 s e um corte seco de emergência armado num atalho de teclado."

Como tudo se encaixa ​

scaffold_show dá a saída master e o clock de tempo. manage_cue armazena os looks. Uma timeline (create_scene_timeline) ou setlist (create_setlist_runner) dirige a ordem; um sequenciador (create_cue_sequencer / create_phrase_locked_cue_engine) trava no beat via sync_external_clock; e create_safety_blackout_chain fica por último no master, para o botão de pânico estar sempre ao alcance.

Veja também ​