Domine o Vaelis

#1. Instalação

#macOS (Intel e Apple Silicon)

Requisito: macOS 11 ou mais novo.

1. Descompacte Vaelis-Mac.zip.
2. Clique com o botão direito em Instalar.command → Abrir → Abrir (o macOS desconfia de apps que não vêm da Apple; só precisa fazer isso uma vez).
3. O instalador copia:
   • Vaelis.vst3 → ~/Library/Audio/Plug-Ins/VST3/
   • Vaelis.component (AU) → ~/Library/Audio/Plug-Ins/Components/
4. Abra o DAW e escaneie os plugins novamente.

Se o macOS bloquear mesmo assim, no Terminal:

xattr -cr ~/Downloads/Vaelis-Mac
bash ~/Downloads/Vaelis-Mac/Instalar.command

Para testar sem DAW, abra Vaelis.app (modo Standalone).

#Windows

Formatos: VST3 e Standalone (não existe AU no Windows). Use o Instalar.bat do pacote Windows, ou copie Vaelis.vst3 para C:\Program Files\Common Files\VST3\.

#Onde encontrar no DAW

O plugin é um instrumento: crie uma faixa de instrumento/MIDI e carregue o Vaelis nela. A saída é estéreo.

#2. Visão geral da interface

A janela tem tamanho fixo (1120 × 822) e está dividida em faixas horizontais:

┌──────────────────────────────────────────────────────────────────────────────┐
│ [logo]  VAELIS     [PART A][PART B]   POLYPHONY [–8+]   status  [Save][Load][Import] │
├──────────────────────────────────────────────────────────────────────────────┤
│  OSCILLATOR 1            │  AMP ENVELOPE   │  OSCILLATOR 2                    │
├───────────────────┬──────────────────────────────┬───────────────────────────┤
│  FILTER           │   TELA CENTRAL (LCD)         │   MIXER                   │
│                   │   preset + leitura + FX/ARP  │   Mix A · Mix B · Main    │
├─────────┬─────────┬──────────┬──────────┬────────┴─┬──────────┐              │
│ MOD ENV1│ MOD ENV2│  LFO 1   │  LFO 2   │  MISC 1  │  MISC 2  │              │
├─────────┴─────────┴──────────┴──────────┴──────────┴──────────┘              │
│ BEND RANGE │              TECLADO                         │  VOICE MODE      │
└──────────────────────────────────────────────────────────────────────────────┘

Cores por função (cada painel usa uma cor de destaque):

#Controles — como usar

• Knob rotativo: arraste para cima/baixo (ou use a roda do mouse). O valor aparece na caixa embaixo (ou na leitura do LCD, nos knobs pequenos).
• Valor exato: nos knobs e faders que têm caixa de valor, clique na caixa e digite o número.
• Duplo clique em um knob ou fader volta o controle ao valor padrão. Para voltar o som inteiro ao padrão, escolha o preset Init Saw.
• Os valores aparecem com unidade: 4.00 kHz, 250 ms, +3.0 dB, 50 %, 120 BPM. Você pode digitar nesse formato (ex.: 2k, 80ms).
• Faders: arraste verticalmente.
• Menus (setinha): clique e escolha.
• Botões liga/desliga: clique para alternar.
• A leitura do LCD mostra nome e valor do último controle que você mexeu.

#3. Como o som é construído (fluxo de sinal)

 Osc 1 ─┐                                       ┌─> Filtro A ─┐
        ├─ grupo A ──┐                          │            ├─ Amp Env A ─ Mix A ─┐
 Osc 2 ─┘            ├─ (Input do filtro) ──────┤            │                     ├─> Main Vol ─> FX ─> Saída
 Osc 1 ─┐            │                          │            │                     │
        ├─ grupo B ──┘                          └─> Filtro B ─┴─ Amp Env B ─ Mix B ─┘
 Osc 2 ─┘

• Existem duas partes (A e B). Cada uma tem 2 osciladores, 1 filtro, 1 envelope de amplitude, 2 Mod Envs, 2 LFOs e 4 blocos Misc.
• O botão PART A / PART B só decide qual parte você está editando. As duas tocam ao mesmo tempo.
• A entrada do filtro (Input) escolhe de onde o filtro recebe áudio: Osc A, Osc B, Osc A+B ou None (nenhum). Padrão: Filtro A ← Osc A, Filtro B ← Osc B.
• No estado inicial, só o Oscilador 1 da Part A soa (volume 0,8). Todos os outros osciladores começam com volume 0 — aumente o Volume do oscilador para ouvi-los.
• Depois do mixer vêm os efeitos globais (veja seção 10) e um limitador suave de segurança (saturação tanh) para evitar estouros.

#4. Cabeçalho: partes, polifonia e presets

#5. Osciladores

Cada parte tem Oscilador 1 e Oscilador 2, com os mesmos controles.

#Formas de onda

#Dicas

• Supersaw: Saw, Voices 7–8, Detune 0,4–0,6, Stereo 0,8–1.
• Corpo + brilho: Osc 1 Saw, Osc 2 Square uma oitava abaixo (Octave −1), Fine ±5–10 cents.
• Sub: Osc 2 Sine, Octave −1 ou −2, Voices 1.

#6. Filtro

Cada parte tem um filtro estéreo.

#Dicas

• Para o filtro "abrir" no ataque, mande o Mod Env 1 para Cutoff com amount positivo.
• Key Track alto mantém o brilho consistente em notas agudas e graves.
• Resonance alta + Cutoff modulado por LFO = efeito wobble.

#7. Envelope de amplitude

Um ADSR por parte controla o volume da nota.

Os tempos usam uma curva não linear (mais resolução nos valores curtos).

O envelope de amplitude também pode ser usado como fonte de modulação nos blocos Misc (Amp Env A / Amp Env B).

#8. Fontes de modulação: Mod Env, LFO e Misc

Cada parte tem 8 fontes de modulação: 2 Mod Envs, 2 LFOs e 4 blocos Misc. Cada fonte tem 2 roteamentos (destino + amount).

#8.1 Mod Envelope 1 e 2 (violeta)

ADSR igual ao de amplitude, mas não afeta o volume diretamente — serve para modular outros parâmetros.

#8.2 LFO 1 e 2 (azul)

#8.3 Misc 1 – 4 (laranja)

Cada painel Misc (1 e 2) contém 2 blocos (total de 4 por parte). Cada bloco escolhe uma fonte e a envia a até 2 destinos.

#8.4 Destinos de modulação

O amount multiplica a fonte; os valores abaixo são o efeito de amount = 1 (fonte no máximo). Várias fontes no mesmo destino se somam.

Atenção: Phaser Freq e Dist Amount controlam efeitos globais. Se as duas partes enviarem modulação, vale a da Part A (se for diferente de zero), senão a da Part B. O efeito precisa estar ligado na tela central.

#Exemplos de roteamento

#9. Mixer e volume

Uma parte só é processada se o seu Mix estiver acima de zero e algum oscilador que alimenta o seu filtro tiver volume acima de zero. Isso economiza CPU.

#10. Tela central (LCD): arpejador e efeitos

O LCD tem:

• Nome do preset (clique nele para abrir a lista) e botões ‹ / › para trocar de preset.
• Leitura do último parâmetro alterado.
• Lista de 8 módulos, cada um com um botão liga/desliga. Clique no nome para abrir a página do módulo.

Ordem do sinal nos efeitos:

Distortion → Phaser → Chorus → EQ → Delay → Reverb → Compressor (e depois o limitador de segurança)

O Arpejador age sobre as notas MIDI antes de chegarem ao sintetizador.

#10.1 Arpeggiator

Liga/desliga pelo botão do módulo. Tem 3 sub-páginas (botões 1, 2 e 3):

Página 1 — geral

Modos:

Páginas 2 e 3 — grade de 16 passos (passos 1–8 e 9–16)

Cada passo tem três controles:

Como editar a grade: cada passo tem uma barra grande, com o valor escrito embaixo (+7, −5, 81).

• Clique ou arraste em uma barra para definir o valor; arraste na horizontal para desenhar vários passos de uma vez.
• Roda do mouse sobre a barra: ajuste fino (1 semitom no Transpose, 5 % na Velocity).
• Duplo clique em um passo volta ao valor padrão.
• Na linha Tie, clique ou arraste para ligar/desligar passos (o primeiro passo clicado define se você está ligando ou desligando).
• Barras de transposição para baixo aparecem em laranja. A leitura do LCD também mostra o valor ao passar o mouse.

A grade tem 16 passos e gira continuamente (1 → 16 → 1) a cada nota tocada pelo arpejador. O controle Steps (1 – 16) da página 1 define o comprimento do padrão: com Steps = 6, só os passos 1–6 tocam e o ciclo volta ao passo 1. O arpejo reinicia quando você pressiona a primeira tecla de uma nova sequência.

A velocity de cada passo também fica disponível como fonte de modulação Step Velocity (nos blocos Misc).

#10.2 Distortion

#10.3 Phaser

#10.4 Chorus

#10.5 Equalizer

#10.6 Delay

Tempo Sync: os tempos são guardados como se o projeto estivesse a 120 BPM. Com Tempo Sync ligado, o Vaelis escala o Delay e os LFOs pelo BPM real do DAW (a 60 BPM o delay dobra de duração). Com Tempo Sync desligado os valores são livres (ms / Hz).

#10.7 Reverb

#10.8 Compressor

#11. Rodapé: Bend Range, teclado e Voice Mode

#Bend Range

Alcance do pitch bend: 1 a 24 semitons (padrão 2).

#Teclado na tela

• Clique nas teclas para tocar. A posição vertical do clique define a velocity (mais embaixo = mais forte).
• Faixa disponível: notas MIDI 24 a 108; o teclado mostra ~4 oitavas — use as setas das pontas para rolar.
• Com o teclado em foco, as teclas do computador tocam notas (layout padrão do JUCE): A W S E D F T G Y H U J K O L P — as teclas Z / X descem/sobem a oitava.
• Os cliques e as teclas do computador passam pelo arpejador se ele estiver ligado.

#Voice Mode

#12. MIDI e controladores

O plugin não responde a MIDI program change nem possui MIDI learn. Para mapear knobs, use a automação do DAW (veja a seção seguinte).

#13. Presets: salvar, carregar e importar

#13.1 Presets de fábrica

O plugin traz 18 presets originais:

Troque com ‹ › ou clicando no nome do preset no LCD.

#13.2 Salvar e carregar (.vaelis)

• Save: grava todos os parâmetros do som atual em um arquivo .vaelis (formato XML).
• Load: carrega um .vaelis.
• Os arquivos são portáteis: você pode copiá-los entre computadores e entre Mac/Windows.

#13.3 O som é salvo junto com o projeto

Ao salvar o projeto do DAW, o estado atual do plugin (todos os parâmetros) é salvo automaticamente. Ao reabrir o projeto, o som volta como estava.

Importante: a lista de presets importados (o banco) não é guardada no projeto — só o som que estava ativo. Se quiser reaproveitar um som importado depois, use Save para gravar um .vaelis.

#13.4 Importar presets (.fxb / .fxp)

Use Import e escolha um arquivo:

• .fxb — banco com vários programas (todos aparecem na lista de presets do LCD).
• .fxp — um único programa.

O formato é detectado automaticamente. Depois de importar:

• A mensagem de status mostra quantos presets foram carregados.
• O primeiro preset do banco é carregado automaticamente.
• Os nomes aparecem como 001: Nome, 002: Nome... Para bancos grandes, o menu é dividido em grupos de 64.
• Para voltar à lista de fábrica: abra o menu de presets e escolha Back to factory presets.

Observações sobre a importação

• Todos os parâmetros do formato original (osciladores, filtro, envelopes, LFOs, modulação, arpejador com Steps e pausas, todos os controles de efeitos, Tempo Sync, modo de portamento e posição da Mod Wheel) são lidos e aplicados. Mesmo assim o som é uma aproximação: algumas curvas (tempos de envelope, Pre-Delay, Spread, Smear, modo do Chorus etc.) foram estimadas por análise dos arquivos, então os sons podem soar muito parecidos, mas não garantidamente idênticos ao original. Ajuste Cutoff, Mix e Main Vol de ouvido.
• O Velo do arpejador (origem da velocity), o Solo de parte e o modo de portamento (Normal = só desliza em legato) são reproduzidos. A velocity das teclas não altera o volume nos presets importados (como no Sylenth1).
• As curvas de Cutoff, Resonance (inclusive a perda de ganho em ressonância altas), Drive, Key Track, Filter Control, envelopes, tempos de LFO/Delay, EQ e níveis de Reverb/Distortion foram medidas contra o Sylenth1 instalado (somente pelo que o plugin informa ao host: textos de parâmetros e áudio renderizado). Em 435 presets de teste, o nível mediano fica a ~0,4 dB e o desvio espectral mediano a ~5 dB do original.
• Quando algum destino ou fonte de modulação do preset original não existe no Vaelis, o menu de presets mostra a seção "Not reproduced by Vaelis:" com a lista do que foi ignorado.
• Importe apenas presets dos quais você tem direito de uso. Não redistribua bancos de terceiros.
• Se o arquivo não tiver o formato reconhecido, o Vaelis tenta um mapeamento genérico (veja fxp_map.json abaixo) e, se falhar, mostra o erro no status.

#13.5 Mapeamento genérico (avançado)

Para arquivos .fxp de outros sintetizadores, existe um mapeamento opcional por JSON:

~/Library/Application Support/Vaelis/fxp_map.json   (macOS)

Há um exemplo em Presets/fxp_map.example.json no projeto. Ele associa o índice de cada valor do preset ao ID de um parâmetro do Vaelis (veja a seção 17).

#14. Automação no DAW

Todos os parâmetros aparecem na lista de automação do DAW com nomes como:

• A Osc 1 Wave, B Cutoff, A Amp Attack, A LFO 1 Rate, Mix A, Main Volume
• Arp On, Arp Mode, Arp Rate, Arp Transpose 1…16, Arp Velocity 1…16, Arp Tie 1…16
• Distortion On, Phaser Mix, Delay Time (ms), Reverb Mix, Comp Threshold (dB) etc.

Dicas:

• Filtro sweep: automatize A Cutoff.
• Build-up: automatize Reverb Mix, Distortion Drive e Delay Feedback.
• Os parâmetros do tipo menu (waves, tipos de filtro, destinos) também são automatizáveis, mas trocar de forma de onda no meio de uma nota pode causar um pequeno clique.

Automação sem "zipper" (degraus audíveis): os controles de som são suavizados internamente (cutoff, resonance, drive, volumes, mix, efeitos). Ligar/desligar um efeito faz um crossfade de ~10 ms em vez de um corte, e roubo de voz / retrigger no modo mono não estalam. Os valores aparecem no DAW já com unidade (Hz, ms, dB, %).

Troca de preset pelo DAW: os presets de fábrica (ou o banco importado) são expostos como programas; reenviar o mesmo programa não apaga edições restauradas do projeto. O nome do preset e o programa ativo são salvos no projeto.

#15. Receitas rápidas de som

Parta sempre do preset Init Saw e altere só o que está listado.

#Lead supersaw

• Part A / Osc 1: Saw, Voices 7, Detune 0,45, Stereo 0,8.
• Osc 2: Square, Volume 0,5, Voices 5, Fine +7.
• Filtro: Low Pass 24 dB, Cutoff 5 kHz, Resonance 0,25.
• Amp: A 5 ms, R 300 ms.
• FX: Delay (Mix 0,25) e Reverb (Mix 0,2).
• Voice Mode: Legato, Portamento 0,05.

#Baixo com sub

• Osc 1: Saw, Voices 1, Octave −1.
• Osc 2: Sine, Volume 0,8, Octave −2.
• Filtro: Low Pass 24 dB, Cutoff 400 Hz, Resonance 0,3, Key Track 0,3.
• Mod Env 1 → Cutoff, Amount +0,4 (D 150 ms, S 0).
• Voice Mode: Mono.

#Pad lento

• Osc 1: Saw, Voices 5, Detune 0,3. Osc 2: Triangle, Volume 0,55, Fine +5.
• Filtro: Cutoff 1,8 kHz.
• Amp: A 0,9 s, D 1 s, S 0,85, R 1,6 s.
• LFO 1 (Rate 0,3) → Cutoff, Amount 0,25.
• FX: Chorus + Reverb (Size 0,8, Mix 0,4).

#Pluck de arpejo

• Osc 1: Saw, Voices 3. Filtro Cutoff 2 kHz.
• Amp: A 1 ms, D 250 ms, S 0, R 150 ms.
• Mod Env 1 → Cutoff, Amount +0,5.
• Arp: On, Mode Up, Rate 1/16, Octaves 2, Gate 0,5. Delay Mix 0,3.

#Wobble

• Osc 1: Saw, Voices 3. Filtro Low Pass 24 dB, Cutoff 600 Hz, Resonance 0,5.
• LFO 1: Triangle, Rate 3 Hz → Cutoff, Amount 0,7.
• Distortion Soft, Drive 0,4, Mix 0,5.

#Duas camadas (Part A + Part B)

1. Na Part A, deixe o Osc 1 com Saw.
2. Clique em PART B; no Osc 1, escolha Square e suba o Volume (começa em 0).
3. Em Filter → Input da Part B, deixe Osc B.
4. Ajuste Mix A e Mix B para equilibrar.

#16. Solução de problemas

#17. Referência completa de parâmetros

IDs usados para automação, mapeamento e arquivos .vaelis. Para parâmetros por parte, o prefixo é a_ (Part A) ou b_ (Part B).

#17.1 Por parte (a_ / b_)

Osciladores — o1_ / o2_

Filtro

Envelope de amplitude

Mod Envelopes — me1_ / me2_

LFOs — lfo1_ / lfo2_

Misc — misc1_ … misc4_

Menu de destinos (19): -, Cutoff, Reso, Drive, Pitch, Pitch O1, Pitch O2, Volume, Level O1, Level O2, Pan, Phase, Mix, LFO1 Rate, LFO1 Gain, LFO2 Rate, LFO2 Gain, Phaser Freq, Dist Amount.

Menu de fontes Misc (12): -, Velocity, Mod Wheel, Key, Aftertouch, Mod Env 1, Mod Env 2, LFO 1, LFO 2, Amp Env A, Amp Env B, Step Velocity.

#17.2 Globais

#17.3 Arpejador

#17.4 Efeitos

Todos os efeitos começam desligados.

#18. Limitações conhecidas

• Tempo Sync é uma escala global (LFOs e Delay seguem o BPM do DAW em relação a 120 BPM), não uma grade de divisões musicais por controle.
• Sem MIDI learn. Troca de programa por MIDI depende do suporte do DAW; use a automação para o resto.
• Sem redimensionamento da janela (tamanho fixo).
• Importação de presets é aproximada (veja 13.4): Hold de passo do original é tratado como Tie; o filtro High Pass do Sylenth1 tem um comportamento próprio (inclinação suave e um piso de cerca de −20 dB nos graves) que o Vaelis não imita; a forma de onda TriSaw do original é diferente (só o nível foi igualado); a largura estéreo do unison é um pouco menor que a do original; Pre-Delay, Spread, Smear e modo do Chorus são aproximações.
• Windows: build ainda não testado em máquina real. AU só existe no macOS.
• Mac: o app e os plugins são assinados ad hoc (não notarizados pela Apple); por isso a primeira abertura exige "botão direito → Abrir".

Vaelis 0.1.0 — manual atualizado em 19/10/2026.