Nyquist Prompt

Conheça o Nyquist Prompt: a interface do Audacity para executar scripts Nyquist de processamento de áudio.

Publicado: 18/07/2026
nyquist prompt script programação lisp

O que você vai aprender

  • Entender o que é o Nyquist Prompt
  • Acessar o Nyquist Prompt no Audacity
  • Executar o primeiro script Nyquist
  • Compreender a sintaxe básica
  • Diferenciar Nyquist de outros tipos de efeitos

Antes de começar

  • Conceito de Sample Rate
  • Conceito de Track
  • Familiaridade com edição de áudio no Audacity

O que é o Nyquist Prompt?🔗

O Nyquist Prompt é uma janela do Audacity que permite escrever e executar código na linguagem Nyquist — um dialeto de Lisp criado por Roger Dannenberg para síntese e processamento de áudio.

Ele dá acesso a operações que os efeitos padrão do Audacity não oferecem: geração de tons customizados, processamento matemático do sinal, análise espectral e muito mais.

Janela do Nyquist Prompt com um script simples digitado

Acessando o Nyquist Prompt🔗

No menu: Tools > Nyquist Prompt... (ou Alt+T, depois N)

A janela possui:

  • Campo de texto: onde você digita o código
  • Botões: Load, Save, Use OK/Cancel para executar ou descartar
  • Opção de runtime: “Display” (mostra resultado textual) ou “Process” (aplica ao áudio)

Primeiro Script🔗

Digite este código no Nyquist Prompt e pressione OK:

; Nyquist script simples — reduz volume pela metade
(mult s 0.5)

Isso multiplica cada amostra do áudio selecionado por 0.5, reduzindo o volume em ~6 dB.

ℹ

A variável s representa o sinal de áudio selecionado. Em scripts estéreo, s é um array com dois elementos: (aref s 0) (canal esquerdo) e (aref s 1) (canal direito).

Sintaxe Básica de Nyquist🔗

Nyquist é um dialeto de Lisp, então usa notação polonesa prefixada com parênteses:

; Comentário começa com ponto-e-vírgula
; Operações básicas:
(+ 1 2)        ; soma: 3
(* 3 4)        ; multiplicação: 12
(mult s 0.5)   ; multiplica o sinal por 0.5

; Funções de áudio:
(lowpass8 s 1000)    ; filtro passa-baixa a 1000 Hz
(highpass8 s 200)    ; filtro passa-alta a 200 Hz
(scale 0.8 s)        ; escala o sinal
(reverse s)          ; inverte o áudio

Gerando Tons🔗

; Gera um tom de 440 Hz (Lá) por 2 segundos
(fmosc (hz-to-step 440) (pwe 1 2))
; Gera ruído branco por 1 segundo
(noise 1)

Headers de Plugin🔗

Para que um script Nyquist apareça como efeito no menu, adicione headers:

;nyquist plug-in
;version 3
;type generate
;name "Meu Tom"
;action "Gerando tom..."

;control freq "Frequência (Hz)" float "" 440 20 20000
;control dur "Duração (s)" float "" 1 0.1 10

(fmosc (hz-to-step freq) (pwe 1 dur))
Script Nyquist com headers — aparece como efeito customizado no menu

Tipos de Plugin Nyquist🔗

TipoDescrição
type generateGera áudio novo (tons, ruído)
type processModifica o áudio selecionado
type analyzeAnalisa e retorna informações (não modifica)

Erros comuns

  • Esquecer os parênteses.
  • Confundir mult com scale: ambos multiplicam, mas scale é mais seguro para sinais .
  • Scripts de análise com type process: se o script retorna texto, use type analyze para evitar corrupção do áudio.
  • Testar scripts longos sem salvar.

Perguntas para reflexão

  1. Qual linguagem o Nyquist Prompt usa?
  2. Lisp (dialet)
  3. O que a variável s representa?
  4. O sinal de áudio selecionado
  5. Qual header define um plugin que gera áudio?
  6. type generate
  7. Qual função aplica filtro passa-baixa?
  8. lowpass8

Você aprendeu

  • Nyquist Prompt executa scripts Nyquist (dialeto de Lisp)
  • Acesse via Tools > Nyquist Prompt
  • A variável s representa o áudio selecionado
  • Scripts podem gerar, processar ou analisar áudio
  • Headers definem o tipo de plugin

Referências🔗