# CALM EverClean: arquitectura tecnica, flujo de senal e instrucciones de uso

## 1. Abstract

CALM EverClean es un procesador de audio en tiempo real orientado a voz, feedback control, limpieza dinamica y channel strip para uso live y studio. El sistema combina una ruta espectral/neural de mayor selectividad con una ruta causal de latencia anadida cero.

El diseno se basa en separar el problema en dos familias de procesamiento:

- **Control espectral/neural con latencia controlada**, usado por CALM en modo Studio 21 ms.
- **Procesamiento causal sample-by-sample**, usado por EverClean, DNS Zero Latency y CALM Zero Latency.

La arquitectura permite trabajar en dos escenarios muy distintos: directo sensible a latencia, donde cada muestra cuenta, y entornos donde 21 ms son aceptables a cambio de mayor precision de analisis.

Este documento explica la arquitectura publica del plugin, sus modulos, el flujo de senal, los modos de latencia, las recomendaciones de uso y las instrucciones de instalacion. No incluye detalles internos de implementacion protegida ni informacion sensible del motor.

## 2. Objetivos de diseno

CALM EverClean esta disenado con seis objetivos principales:

1. **Latencia predecible**: modo Studio 21 ms y modo Zero Latency real.
2. **Controles principales simples**: dos nucleos claros, CALM y EverClean.
3. **Limpieza vocal dinamica**: reducir ruido, bleed, cola de sala y acumulaciones tonales sin convertir el plugin en un ecualizador fijo.
4. **Proteccion vocal**: evitar que la limpieza destruya cuerpo, consonantes, susurros o aire util.
5. **Uso live**: interfaz rapida, medicion clara, CPU estable y recall fiable.
6. **Distribucion robusta**: recursos internos embebidos y cifrados, sin modelos externos que el usuario tenga que copiar.

## 3. Arquitectura general

El plugin se organiza en cinco bloques funcionales:

```text
Input
  |
  |-- Mode Router
  |     |-- Studio 21 ms path
  |     |     |-- CALM FFT/neural control
  |     |     |-- Resonance / spectral modules
  |     |     |-- DNS frame-based processing
  |     |
  |     |-- Zero Latency path
  |           |-- EverClean causal cleaning
  |           |-- CALM causal feedback guard
  |           |-- DNS causal split
  |
  |-- Channel Strip
  |     |-- Expanse
  |     |-- Clean EQ
  |     |-- Body
  |     |-- De-esser
  |     |-- Compression
  |     |-- Finisher
  |
  |-- Auto Gain / Output Trim
  |
Output
```

La decision mas importante es que el plugin no intenta usar una unica solucion para todo. El modo Studio y el modo Zero Latency tienen responsabilidades diferentes.

## 4. Modos de latencia

### 4.1 Studio 21 ms

Studio es la ruta de maxima selectividad. Utiliza una ventana espectral y analisis neural para tomar decisiones mas finas sobre el contenido tonal, feedback risk y limpieza.

Caracteristicas:

- Latencia aproximada a una ventana de 1024 muestras a 48 kHz.
- Indicacion de latencia en la interfaz en ms y muestras.
- Mayor resolucion espectral.
- Mejor contexto para control tonal, resonancias y feedback.
- Recomendado para mezcla, broadcast, streaming, teatro, instalaciones, estudio y directo cuando el buffer/latencia lo permite.

En este modo CALM dispone de mas informacion temporal y frecuencial. Por eso es el modo recomendado para maxima seguridad anti-feedback.

### 4.2 Zero Latency

Zero Latency evita lookahead y no declara latencia al host. La ruta trabaja de forma causal, con filtros y estados que solo dependen del presente y del pasado.

Caracteristicas:

- Latencia anadida cero.
- EverClean activo como motor principal de limpieza.
- CALM Zero Latency como guardia tonal causal.
- DNS Zero Latency como reduccion de ruido causal.
- Recomendado para monitores, directo sensible, voz hablada, lavs/headsets y situaciones donde la latencia es critica.

La diferencia fundamental es que Zero Latency no puede "ver el futuro". Por eso su comportamiento se basa en estados recurrentes, envelopes, filtros causales y deteccion de estabilidad tonal.

## 5. Motor CALM

CALM es el nucleo de control anti-feedback y estabilidad tonal.

### 5.1 CALM en Studio 21 ms

En Studio, CALM usa informacion espectral por frames. La senal se analiza por bandas y bins para estimar:

- presencia de tonos estrechos,
- estabilidad temporal,
- riesgo de feedback,
- acumulacion tonal,
- relacion entre energia vocal y energia resonante,
- necesidad de reduccion dinamica.

El motor neural no debe entenderse como un "efecto" que pinta una curva fija. Actua como un estimador de control. El DSP ejecuta despues la reduccion de forma suavizada para evitar saltos, modulacion innecesaria y danos a la voz.

Controles relevantes:

- **CALM On/Off**: activa el nucleo anti-feedback.
- **Strength**: cantidad principal de CALM.
- **Turbo**: respuesta mas fuerte ante situaciones dificiles.
- **Tonal Lock**: seguimiento de tonos estables.
- **Low Tonal Lock**: extension de deteccion hacia frecuencias mas bajas.

Uso recomendado:

- Empieza con CALM activado y Strength moderado.
- Activa Turbo solo cuando el sistema esta cerca del limite.
- Usa Studio si quieres maxima precision.
- Usa Tonal Lock si hay tonos persistentes que aparecen incluso con programa activo.

### 5.2 CALM en Zero Latency

En Zero Latency, CALM cambia a un guardia causal de bandas estrechas. En vez de usar una ventana FFT con lookahead, analiza la senal muestra a muestra con un banco de filtros estrechos.

El proceso conceptual es:

1. Dividir la senal en bandas estrechas.
2. Medir envolvente y energia de cada banda.
3. Estimar suelo dinamico por banda.
4. Detectar dominancia tonal y estabilidad.
5. Aplicar cancelacion/reduccion causal en las bandas sospechosas.
6. Suavizar ataque y release para evitar artifacts.

Este modo no pretende sustituir toda la precision del CALM Studio, pero si aportar una capa de seguridad de latencia cero.

## 6. Motor EverClean

EverClean es el motor de limpieza vocal de latencia anadida cero.

### 6.1 Funcion

EverClean esta pensado para actuar sobre problemas que normalmente se mezclan en una voz en directo:

- ruido de fondo,
- bleed de escenario,
- cola de sala,
- reflexiones tempranas,
- suciedad tonal,
- pequenas acumulaciones que hacen que la voz parezca lejana o menos inteligible.

El motor procesa en tiempo real sin lookahead. Usa estados internos persistentes y una ruta causal para adaptar la limpieza a la senal.

### 6.2 Procesamiento mono y stereo

EverClean puede trabajar en mono y stereo.

- En mono, procesa directamente el canal de voz.
- En stereo, mantiene relacion entre canales y evita que la limpieza rompa innecesariamente la imagen.

Para directo, el uso mas comun sera mono en canales vocales individuales. Para buses stereo o stems vocales, la ruta stereo mantiene coherencia de salida.

### 6.3 Control principal

El control principal de EverClean es **EverClean Strength**.

Rangos orientativos:

- **0-25%**: limpieza muy ligera, util para fuentes delicadas.
- **25-50%**: limpieza natural para voz hablada o canto con ruido moderado.
- **50-70%**: limpieza fuerte, util en escenarios con bleed o sala complicada.
- **70-100%**: modo agresivo. Usar con cuidado y escuchar consonantes, aire y cuerpo.

EverClean debe ajustarse escuchando en contexto. Si se usa demasiado alto en una fuente ya limpia, puede empezar a sonar demasiado procesado.

### 6.4 Relacion con DNS

EverClean y DNS no hacen exactamente lo mismo:

- EverClean busca limpieza vocal dinamica general.
- DNS busca reduccion de ruido de fondo.

En Zero Latency, ambos pueden convivir. La recomendacion es:

1. Ajustar EverClean hasta que la voz se acerque.
2. Activar DNS si queda ruido estacionario.
3. Mantener DNS en valores conservadores si EverClean ya esta trabajando fuerte.

## 7. DNS

DNS es un motor de reduccion dinamica de ruido.

### 7.1 DNS en Studio

En Studio, DNS opera con informacion por bandas y estimacion de suelo de ruido. La idea es mantener un historico del nivel minimo/probable de ruido y reducirlo cuando la energia cae por debajo del umbral dinamico.

El proceso conceptual:

1. Analisis de energia por bandas.
2. Estimacion de suelo de ruido.
3. Comparacion con umbral dinamico.
4. Generacion de ganancia por banda.
5. Suavizado de ataque/release.
6. Proteccion de bandas vocales.

### 7.2 DNS en Zero Latency

En Zero Latency, DNS usa una division causal de cinco zonas frecuenciales. Cada zona mantiene:

- envolvente,
- suelo de ruido,
- ganancia minima,
- ataque/release,
- proteccion vocal.

Controles:

- **DNS Bias**: determina cuanto se inclina el detector hacia reduccion.
- **DNS Attenuation**: determina la reduccion maxima disponible.

Recomendacion:

- Para modo Basic, usar Auto DNS.
- Para modo Advanced, empezar con valores bajos y subir poco a poco.

## 8. Auto Gain

Auto Gain compensa el nivel de salida tras el procesamiento. Es importante porque un procesador de limpieza puede sonar "mejor" solo por estar mas bajo. Auto Gain ayuda a comparar de forma mas justa.

Recomendacion:

- Mantener Auto Gain activado durante pruebas.
- Desactivarlo solo si se quiere medir el nivel real de reduccion o si el usuario prefiere controlar ganancia manualmente.

## 9. Channel strip avanzado

El modo Advanced convierte CALM EverClean en un canal vocal completo.

### 9.1 Expanse

Expanse funciona como una reduccion dinamica del fondo. Es util para controlar ruido/sala entre frases sin cortar de forma brusca.

Controles:

- Threshold
- Depth
- Speed

Uso recomendado:

- Voz hablada: depth moderado, speed medio.
- Canto: depth menor para no cortar respiraciones ni colas musicales.

### 9.2 Resonance

Resonance esta orientado a controlar resonancias estrechas. Es especialmente util en modo Studio, donde hay mas informacion espectral.

Controles:

- Sensitivity
- Depth

Uso recomendado:

- Subir Sensitivity hasta que detecte resonancias.
- Subir Depth solo lo necesario.
- Evitar valores extremos si la voz empieza a perder cuerpo.

### 9.3 Clean EQ

Clean EQ ofrece dos areas:

- Focus: peso, pegada, calidez o control de zona baja.
- Clarity: presencia, aire, sheen o silk.

No es un sustituto de EverClean; es un finalizador tonal.

### 9.4 Body

Body permite controlar proximidad y cuerpo. Puede ayudar a recuperar peso si la limpieza deja la voz demasiado fina.

### 9.5 De-esser

De-esser reduce sibilancia. Incluye modos wideband, split-band y spectral.

Uso recomendado:

- Usar despues de ajustar EverClean/DNS.
- Si EverClean esta muy alto, revisar de-essing porque la percepcion de sibilancia cambia.

### 9.6 SSL-style compression

Compresion de estilo bus/canal para estabilizar la dinamica.

Uso recomendado:

- Ratio moderado.
- Auto makeup si se quiere flujo rapido.
- Evitar comprimir antes de resolver feedback severo.

### 9.7 Vocal Finisher

Modulo de color final con drive, opto y aire. Usar al final, no como sustituto de limpieza.

## 10. Flujo de trabajo recomendado

### 10.1 Voz vocal live con riesgo de feedback

1. Seleccionar **Studio 21 ms** si la latencia es aceptable.
2. Activar **CALM**.
3. Subir **Strength** hasta que el sistema se estabilice.
4. Activar **Turbo** solo si hace falta.
5. Activar **EverClean** si ademas hay ruido, bleed o sala.
6. Activar **Auto Gain** para comparar.
7. Ajustar channel strip al final.

### 10.2 Monitores o situacion de latencia critica

1. Seleccionar **Zero Latency**.
2. Activar **EverClean**.
3. Ajustar EverClean Strength entre 25% y 60%.
4. Activar **CALM** si hay riesgo tonal/acople.
5. Activar **DNS** si queda ruido estacionario.
6. Evitar ajustes extremos si el cantante se monitoriza directamente.

### 10.3 Lav/headset corporativo

1. Empezar en **Zero Latency**.
2. EverClean entre 35% y 65%.
3. Auto DNS activado si hay aire acondicionado, sala o ruido constante.
4. Expanse suave si hay ruido entre frases.
5. De-esser si el micro es brillante.

### 10.4 Teatro

1. Usar **Zero Latency** si hay monitoraje sensible.
2. Usar **Studio 21 ms** si el sistema permite latencia y se busca mas control.
3. EverClean moderado para no destruir respiraciones ni interpretacion.
4. DNS conservador.
5. Body para recuperar proximidad si la limpieza afina demasiado.

### 10.5 Broadcast / streaming

1. Usar **Studio 21 ms** si no hay problema de latencia.
2. CALM moderado.
3. EverClean moderado.
4. DNS segun ruido de fondo.
5. Clean EQ, de-esser y compresion para acabado.

## 11. Ajustes iniciales recomendados

### Natural live vocal

```text
Mode: Studio 21 ms
CALM: On
CALM Strength: 35-55%
Turbo: Off
EverClean: On
EverClean Strength: 30-50%
DNS: Auto / conservative
Auto Gain: On
```

### Zero-latency speech

```text
Mode: Zero Latency
CALM: On
CALM Strength: 25-45%
EverClean: On
EverClean Strength: 35-60%
DNS: On if needed
Auto Gain: On
```

### Difficult noisy vocal

```text
Mode: Studio 21 ms if possible
CALM: On
CALM Strength: 45-65%
Turbo: On only if feedback is close
EverClean: On
EverClean Strength: 50-70%
DNS: On, moderate
Expanse: optional, light to medium
Auto Gain: On
```

### Emergency feedback-prone channel

```text
Mode: Studio 21 ms preferred
CALM: On
CALM Strength: 60-80%
Turbo: On
Tonal Lock: On
Low Tonal Lock: On only if low feedback is present
EverClean: use only as needed
```

## 12. Instalacion

### 12.1 macOS

Formatos incluidos:

- AU: `CALM EverClean.component`
- VST3: `CALM EverClean.vst3`
- Standalone: `CALM EverClean.app`

Ubicaciones habituales:

```text
~/Library/Audio/Plug-Ins/Components/
~/Library/Audio/Plug-Ins/VST3/
/Applications/
```

Si macOS bloquea la beta por no estar notarizada:

```bash
xattr -cr ~/Library/Audio/Plug-Ins/Components/CALM\ EverClean.component
xattr -cr ~/Library/Audio/Plug-Ins/VST3/CALM\ EverClean.vst3
killall -9 AudioComponentRegistrar
```

Despues, reiniciar Logic, LiveProfessor, Reaper o el host correspondiente.

### 12.2 Windows

Formato incluido:

- VST3: `CALM EverClean.vst3`
- Standalone: `CALM EverClean.exe`

Ubicacion habitual VST3:

```text
C:\Program Files\Common Files\VST3\
```

Si Windows muestra advertencia de seguridad, aceptar solo si el archivo procede del paquete oficial de EverWorks.

## 13. Pruebas recomendadas para beta testers

Para que el feedback sea util, reportar:

```text
OS:
Host:
Plugin format:
Buffer size:
Sample rate:
Source:
Mic:
Mode: Studio 21 ms / Zero Latency
CALM Strength:
EverClean Strength:
DNS:
Auto Gain:
What improved:
What got worse:
CPU / glitches:
Would you trust it live:
```

Ejemplo de feedback util:

```text
macOS 14, Logic, AU, 48 kHz, 128 buffer.
SM58 vocal through wedge.
Zero Latency, CALM 40%, EverClean 55%, DNS On.
Reduced room noise and small ringing around 3 kHz.
Above 70% EverClean consonants started to feel processed.
No CPU issue.
Would use live around 45-55%.
```

## 14. Troubleshooting

### El plugin no aparece en Logic

1. Cerrar Logic.
2. Ejecutar `xattr -cr` sobre el AU.
3. Ejecutar `killall -9 AudioComponentRegistrar`.
4. Abrir Logic de nuevo.
5. Revisar Plugin Manager.

### El host solo muestra mono o stereo incorrecto

1. Reiniciar el host.
2. Verificar que el plugin se ha escaneado de nuevo.
3. Probar en una pista mono y en un bus stereo.

### Suena demasiado procesado

1. Bajar EverClean.
2. Bajar DNS Attenuation.
3. Desactivar Turbo si no hay feedback real.
4. Activar Auto Gain para comparar nivel.
5. Recuperar cuerpo con Body o Clean EQ si hace falta.

### No noto reduccion

1. Verificar que el modulo esta activado.
2. Subir Strength progresivamente.
3. Probar Studio 21 ms si se busca maxima selectividad.
4. Probar con una fuente que realmente tenga ruido, cola o feedback risk.

### CPU alta

1. Usar Zero Latency si el sistema necesita minimo consumo.
2. Desactivar modulos avanzados no usados.
3. Subir buffer en mezcla o broadcast.
4. Evitar cadenas duplicadas en muchos canales si no son necesarias.

## 15. Seguridad de distribucion

La version actual embebe los recursos de EverClean cifrados dentro del binario. En carga, el plugin valida los datos antes de inicializar el motor. Esto mejora:

- portabilidad,
- integridad,
- resistencia a instalaciones incompletas,
- control de version del motor,
- reduccion de archivos externos.

La firma y notarizacion de macOS se anadiran en una fase posterior de distribucion.

## 16. Limitaciones conocidas

CALM EverClean no debe entenderse como una herramienta milagrosa. Sus limites practicos son:

- No arregla una ganancia mal planteada.
- No sustituye un sistema mal alineado.
- No elimina feedback fisico extremo si el sistema ya esta fuera de control.
- No convierte una grabacion muy contaminada en una pista de estudio perfecta.
- Los modos agresivos pueden afectar consonantes, aire o cuerpo si se fuerzan demasiado.

El uso correcto es como capa adicional de control, no como unica solucion del sistema.

## 17. Conclusion

CALM EverClean combina control anti-feedback, limpieza vocal de latencia cero, reduccion de ruido, auto gain y channel strip avanzado en una herramienta gratuita orientada a uso real.

La arquitectura actual esta pensada para dos mundos:

- **Studio 21 ms**, cuando se busca maxima precision.
- **Zero Latency**, cuando la latencia manda.

La direccion del proyecto es clara: mantener el plugin gratuito, simplificar el flujo de trabajo y mejorar la limpieza con feedback real de usuarios reales.