# ATClean 0.7.4 alpha — macOS

## Padrão de abertura e seleção de motor

Selecione **ATClean** na lista de efeitos. Novas instâncias iniciam em **Neural Clássico**, com **Limpeza da voz em 100%**. No topo do plugin, escolha Neural Live ou Live DSP se preferir. Projetos e presets salvos mantêm as escolhas anteriores; um preset padrão personalizado na DAW pode substituir o padrão de fábrica. Os três motores estão disponíveis no mesmo VST3 e no mesmo AU. No Logic: Audio FX > Audio Units > ATClean > ATClean. Faça nova varredura após instalar.

Para baixa latência, selecione **Neural Live**. Atraso desse modo: 1,98 ms a 48 kHz; 2,72 ms a 44,1 kHz; 2,52 ms a 96 kHz; 3,38 ms a 16 kHz. Testado entre 8 e 192 kHz, sempre abaixo de 5 ms. A interface de áudio, buffers e outros efeitos adicionam atraso. Comece com 48 kHz / 128 amostras e reduza o buffer somente se a sessão permanecer estável; 32 amostras teve picos acima do prazo em testes locais.

A rede estima 32 ganhos a cada 10 ms com contexto passado; um filtro curto aplica esses ganhos ao áudio atual. A 0.7.4 mantém o padrão Neural Clássico em 100% e mantém os algoritmos da 0.3.2: não inclui os modelos experimentais. Ainda não identifica a voz mais próxima e pode reduzir inteligibilidade em algumas gravações. Consulte RELEASE.md, REVIEW.md e MODEL-RESEARCH.md no pacote. O modo Neural Clássico mantém 30 ms em 48 kHz. Live DSP usa zero buffering algorítmico e não usa rede neural. Troque de motor preferencialmente com o transporte parado: a DAW precisa reajustar a compensação de latência.

No Neural Live, Studio aplica a maior atenuação por banda; Broadcast e Live são mais suaves. Os perfis não alteram a latência.

AUv2 para Logic Pro e VST3 para hosts compatíveis. macOS 11+, binário universal Intel x86_64 e Apple Silicon arm64. M4/M5 usam a arquitetura arm64; não houve teste físico nesses chips.

## Instalação em três passos

1. Salve sua sessão e encerre Logic Pro, SuperRack Performer e outras DAWs com **⌘Q**. Fechar só a janela não encerra o aplicativo.
2. Abra **ATClean-0.7.4-macos-installer-r2.pkg** e siga o assistente. Informe a senha do Mac quando solicitada. Não é preciso abrir o Terminal nem escolher pastas.
3. Reabra sua DAW e procure **ATClean** nos efeitos.

### Se o Mac bloquear o instalador

Clique em **OK** no aviso. Abra **Ajustes do Sistema → Privacidade e Segurança**, procure o aviso do instalador ATClean e clique em **Abrir Mesmo Assim**. Confirme a abertura e continue a instalação. Autorize somente o arquivo baixado do site oficial.

O pacote é gratuito e não tem notarização Apple. Normalmente essa autorização se aplica à abertura desse instalador; o macOS pode solicitá-la novamente para um novo download ou atualização. Não é necessário desativar o Gatekeeper.

O instalador coloca VST3 em `/Library/Audio/Plug-Ins/VST3/` e AU em `/Library/Audio/Plug-Ins/Components/`, verifica as assinaturas de integridade e guarda cópias anteriores. Instala para todos os usuários. Cópias antigas do usuário conectado são movidas para `~/Library/Application Support/ATClean/backups/` para evitar duplicatas; versões anteriores do sistema são movidas para `/Library/Application Support/ATClean/backups/`.

### Onde encontrar

- **Logic Pro:** Audio FX → Audio Units → ATClean → ATClean.
- **SuperRack Performer:** VST3 Plugins → ATClean → ATClean.

Se uma versão anterior foi bloqueada, o host pode ter guardado a rejeição. No SuperRack, use **VST3 → Clear Caches and Rescan** e reinicie o host. No Logic, procure ATClean no **Gerenciador de Plug-ins** e use **Redefinir e reescanear seleção**. Se não estiver na lista, reinicie o Mac e abra o Logic novamente. Essas etapas são recuperação de instalações antigas, não parte do fluxo normal.

O ZIP antigo continua disponível para instalação manual e contém o instalador de Terminal anterior; prefira o PKG.

[Autorização de apps no macOS — Apple](https://support.apple.com/en-au/102445) · [Plugins ausentes no Logic — Apple](https://support.apple.com/en-ca/122179) · [Nova varredura no SuperRack — Waves](https://www.waves.com/support/how-to-find-third-party-vst3-plugins-in-superrack-performer).

## Uso e limites

Controle principal Limpeza da voz; Avançadas mostra os ajustes completos. Broadcast aplica o RNNoise, Studio acrescenta atenuação nas pausas, Ambiente original devolve sinal sem limpeza. Para maior redução: Clean/Noise/Dry-Wet em 100%, Ambiente original em zero. Presets antigos mantêm valores antigos; Reset adota os novos padrões.

A 0.7.4 registra somente o AU AtCl (ATClean). Projetos antigos que usavam o AU separado AtNL (ATClean Neural Live) precisam substituir esse efeito por ATClean e escolher Neural Live. Preserve uma cópia do projeto e seus presets; o instalador guarda o bundle anterior para restauração. Não há migração automática garantida dessa variante AU.

Estado verificável da descoberta, auval e testes em `STATUS.md` e nos logs do pacote. Aprovação auval não equivale a uma sessão real no Logic. Sem modelo dedicado para canto ou separação garantida de instrumentos.

## Reprodução

`bash scripts/build-macos.sh` fixa dependências, compila arm64/x86_64, testa áudio/estado/latência, verifica arquiteturas e assinaturas e executa `auval -v aufx AtCl Atel`. O pacote só é gerado se o único componente passar no auval e os três modos passarem nos testes do host AU. Nenhum arquivo de áudio pessoal é enviado ao serviço de compilação.

Registro AU segue a documentação [Audio Components da Apple](https://developer.apple.com/documentation/audiotoolbox/audio-components).

Presets novos (.atclean / ATC2) e projetos salvam também o motor. Presets ATC1 continuam aceitos e conservam o motor atualmente selecionado. A/B e Reset incluem a seleção do motor.

## SuperRack Performer

O Performer carrega o **VST3**; o AU é para Logic. Após instalar, abra o menu abaixo do nome do rack e escolha **VST3 → Scan plugins**. Procure **VST3 Plugins → ATClean → ATClean**. Se uma versão anterior foi rejeitada, use **Clear Caches and Rescan**, conclua a varredura e reinicie o Performer. O ATClean oferece mono e estéreo. Não é necessário definir uma pasta personalizada com o instalador 0.7.4.

Para usar imediatamente uma instalação anterior sem atualizar: **VST3 → Scan single plugin** e selecione o bundle ATClean.vst3 na pasta do usuário indicada nas instruções da versão antiga.

A pasta padrão é documentada pela [Waves](https://www.waves.com/support/how-to-find-third-party-vst3-plugins-in-superrack-performer). No Mac, o bundle universal inclui arm64 nativo para Apple Silicon. A execução manual dentro do Performer no Mac ainda não foi testada. Não há integração SoundGrid.


Idioma: escolha **EN**, **PT-BR** ou **ES** no seletor superior do plugin. A mudança é imediata, preserva os controles de áudio e fica salva neste computador.


## Se apareceu “A instalação falhou”

A revisão 1 aborta se detectar Logic ou SuperRack aberto. Salve sua sessão, encerre com ⌘Q e reabra o instalador. A revisão 2 avisa antes de começar, com instruções claras, para evitar essa falha genérica. Se falhar com as DAWs encerradas, no instalador escolha **Janela → Registro do Instalador → Mostrar Todos os Registros** e salve o relatório para o suporte.