Luz
Usa una fuente amplia delante de ti. Evita contraluz, parpadeo de luminarias baratas y sombras duras sobre los dedos. La piel no necesita un fondo verde; sí necesita contraste estable.
Documento 01 · Manual de usuario
Del primer gesto a la interpretación
Una guía práctica para convertir la cámara en un campo musical continuo: montaje, calibración, articulación, afinación, presets históricos, experimentación y captura. No necesitas conocer síntesis; sí conviene escuchar con atención y moverte con intención.
Primer sonido: recorrido esencial
Theremin Web abre preparado como instrumento clásico de concierto: modo Clásico, escala Libre, voz Rockmore, Cabinet 1929, sala discreta y extensión Do1–Do7. La aplicación necesita un clic inicial porque el navegador protege cámara y audio.
- Abre la app por HTTPS o en localhost. Pulsa EMPEZAR y concede acceso a la cámara. Nunca solicita el micrófono.
- Entra con las manos fuera de plano. Deja que el indicador de FPS se estabilice y comprueba que la cámara seleccionada sea la correcta.
- Muestra primero la mano derecha. Muévela despacio de abajo arriba: abajo es grave, arriba es agudo. En Libre no existen notas ni escalones entre ambos extremos.
- Añade la mano izquierda. Baja su altura para cerrar el volumen y súbela para abrirlo. Separa ataque, nota y liberación como si manejaras un arco invisible.
- Ajusta el espacio, no tu cuerpo. Si seis octavas resultan demasiado sensibles, elige “Webcam cómoda” o calibra una zona más amplia antes de forzar movimientos pequeños.
Idea fundamental
La derecha decide qué frecuencia suena; la izquierda decide cuándo y con qué fraseo. Ensaya ambas tareas por separado antes de coordinarlas.
Lista previa de 30 segundos
Preparar el espacio y la cámara
Composición
Coloca la cámara aproximadamente a la altura del pecho o de los hombros. Reserva margen arriba y abajo: ese recorrido vertical es tu “antena” de tono.
Sonido
Los auriculares con cable reducen retardo; unos monitores o altavoces con buen grave permiten oír mejor Do1. Muchos portátiles no reproducen con autoridad 32,7 Hz.
Postura
Aléjate lo suficiente para no llegar a los bordes de la imagen. Mantén el codo derecho estable y deja que el antebrazo haga cambios amplios; reserva movimientos pequeños para afinación y vibrato.
Qué afecta al seguimiento
| Situación | Síntoma | Corrección |
|---|---|---|
| Manos se cruzan o tapan | Una mano desaparece brevemente | Separa planos y alturas; la app conserva roles, pero ninguna cámara ve a través de la otra mano. |
| Fondo muy parecido a la piel | Landmarks inestables | Cambia el ángulo o añade una luz lateral suave. |
| Poca luz | FPS bajo y movimiento borroso | Aumenta luz real antes de subir la exposición automática. |
| Mano junto al borde | El tono se pega al extremo | Calibra una zona interior y evita salir del encuadre. |
| Bluetooth | La nota llega tarde | Prueba cable o altavoz interno para separar latencia de audio y latencia visual. |
Seguridad auditiva
Empieza con volumen físico bajo. Un gesto accidental puede recorrer varias octavas; el limitador protege picos técnicos, no sustituye un nivel de escucha prudente.
El lenguaje gestual
La imagen está espejada para comportarse como un espejo, pero el motor conserva cada rol por trayectoria espacial. El eje horizontal ayuda a identificar manos; no altera el tono.
Clásico · derecha
El centro de la palma controla frecuencia. Arriba = agudo; abajo = grave. La relación es logarítmica: la misma distancia visual equivale al mismo intervalo musical.
Clásico · izquierda
La altura controla la ganancia. Acércala a la zona calibrada de silencio para cortar y a la zona forte para abrir. Es el equivalente funcional de la antena de volumen.
Dúo · ambas manos
Cada palma controla una voz y la distancia pulgar–índice regula su volumen. Izquierda: Do2–Do4; derecha: Do4–Do6.
Gestos musicales
- Glissando
- Desplazamiento vertical continuo. En Libre pasa por todas las frecuencias intermedias.
- Portamento
- Glissando intencionadamente lento entre dos notas. “Inercia del tono” prolonga el enlace, pero no crea la continuidad: el puente entre fotogramas siempre está activo.
- Vibrato
- Oscilación vertical pequeña y regular alrededor del centro de afinación. Rockmore no añade vibrato automático.
- Legato
- Mantén volumen abierto mientras la derecha conecta alturas.
- Staccato
- Corta y abre rápidamente con la izquierda sin mover la derecha de su nota.
- Dinámica
- Modela cada ataque y salida con la izquierda; evita dejar el volumen permanentemente al máximo.
Diferencia con una antena física
Un theremin clásico mide capacitancia y responde sobre todo a la distancia mano–antena. Theremin Web mide la palma con una cámara y traduce su altura. La gramática musical —campo continuo, dos manos independientes y ausencia de trastes— se conserva; el mecanismo físico no.
Todos los controles de la aplicación
Barra superior
- Cámara: cambia de dispositivo. El motor silencia antes del cambio y vuelve a asociar las manos.
- Reiniciar: reconstruye sesión, cámara y audio conservando los ajustes guardados.
- Detener: libera cámara, AudioContext y temporizadores; vuelve a la pantalla inicial.
- FPS / latencia: FPS es una media del seguimiento. La latencia mostrada corresponde a la salida Web Audio declarada por el navegador, no a todo el trayecto cámara→sonido.
Panel principal
| Control | Qué modifica | Cuándo usarlo |
|---|---|---|
| Modo | Clásico: tono + volumen separados. Dúo: dos voces. | Clásico para repertorio; Dúo para contrapunto y texturas. |
| Sonido | Fuente, filtros, vibrato automático, cabinet, reverb y eco base. | Cambia el carácter sin cambiar la afinación. |
| Escala | Libre o atracción suave a notas cuando la mano se detiene. | Libre para theremin auténtico; escalas para apoyo tonal. |
| Tónica | Desplaza Mayor, menor y Pentatónica. | No afecta a Libre; en Cromática todas las notas siguen presentes. |
| Reverb | Cantidad enviada a la sala sintética. | 12 % para concierto íntimo; más para paisajes, menos para estudio seco. |
| Grabación | Captura solo la mezcla sintetizada. | Pulsa una vez para iniciar y otra para cerrar el archivo. |
Configuración interpretativa
- Perfil de ejecución: combina rango y tiempos de respuesta; al editar un valor pasa a Personalizado.
- Frecuencia mínima/máxima: límites exactos entre 16 y 5000 Hz, con separación válida.
- Extensión: de 1 a 7 octavas en pasos de media octava; los botones −/+ conservan el grave y recalculan el agudo.
- Inercia del tono: 3–100 ms en interfaz. Aumentarla hace el movimiento más flotante; no cuantiza.
- Respuesta del volumen: 5–150 ms. Menos = ataques rápidos; más = fraseo redondeado.
- Cabinet 1929: activa la ruta de altavoz histórico modelado.
- Cargar IR real: decodifica localmente un archivo de respuesta al impulso y lo usa en la rama del cabinet.
- Restablecer ajustes: borra preferencias v5 y la migración anterior; no borra archivos que ya hayas descargado.
Sonidos, escalas y extensión
Presets sonoros
Rockmore · predeterminado
Centro vocal, grave rico, agudo progresivamente puro, cabinet y sala al 12 %. Sin vibrato automático: el gesto conserva la expresividad.
RCA/Rockmore directo
La misma familia histórica sin cabinet por defecto y con ambiente mínimo. Útil para oír el motor antes de la coloración de altavoz.
RCA + Cabinet 1929
Filtros, saturación y compresión modelan el amplificador, altavoz y caja. Es una aproximación, no una medición de un RCA 106 concreto.
Ciencia ficción moderna
Pulso brillante, vibrato automático retardado de 5,8 Hz / 34 cents, hall y eco. Evoca la tradición cinematográfica, no el concierto de Rockmore.
Órbita prismática
Parciales discontinuos, quinta 3:2, octava ligeramente abierta, movimiento lento y eco de 243 ms. Diseñado para descubrir, no para imitar.
Perfiles de ejecución
| Perfil | Rango | Extensión | Tono / volumen |
|---|---|---|---|
| Concierto completo | 32,703–2093,005 Hz | Do1–Do7 · 6 oct | 10 / 18 ms |
| RCA 1929 | 123,47–1396,91 Hz | Si2–Fa6 · ≈3,5 oct | 14 / 55 ms |
| Rockmore estable | 65,41–2093 Hz | Do2–Do7 · 5 oct | 10 / 18 ms |
| Webcam cómoda | 130,81–1046,5 Hz | Do3–Do6 · 3 oct | 24 / 35 ms |
| Personalizado | 16–5000 Hz permitidos | 1–7 oct en el deslizador | 3–100 / 5–150 ms |
Libre frente a escalas
Libre aplica una identidad matemática: la frecuencia mapeada pasa al motor sin redondeo MIDI. Cromática, Pentatónica, Mayor y menor conservan el glissando durante el movimiento y atraen gradualmente hacia una nota compatible cuando la velocidad baja.
No confundir asistencia con trastes
Una escala no convierte el instrumento en teclado. La atracción depende de velocidad y tarda en asentarse; si necesitas un barrido absolutamente continuo, vuelve a Libre.
Calibración de cuatro poses
La calibración adapta el campo de la cámara a tu postura real. No cambia el timbre ni las frecuencias elegidas: define qué zonas visuales representan cada extremo.
- Grave. Sitúa la mano derecha en el punto bajo que puedas repetir cómodamente y mantenla quieta durante la captura.
- Agudo. Llévala al punto alto sin elevar el hombro ni salir del encuadre.
- Silencio. Coloca la izquierda donde quieras cerrar la frase.
- Forte. Colócala en el máximo cómodo de apertura dinámica.
Cada pose recoge muestras durante aproximadamente 340 ms y usa la mediana, que resiste valores aislados. Para seis octavas, la app exige un recorrido vertical mayor que para tres; una zona demasiado estrecha se rechaza para evitar una afinación impracticable.
Calibrar bien
- Captura posiciones reproducibles, no extremos anatómicos.
- Mantén al menos seis muestras visibles y evita mover la cámara durante el proceso.
- Puedes invertir el gesto de volumen: se normaliza la pareja silencio/forte.
- Si cambias cámara, encuadre, distancia o extensión radicalmente, calibra de nuevo.
- La calibración se guarda en el navegador; no viaja entre dispositivos ni perfiles privados.
¿Por qué no comprimir seis octavas en unos pocos centímetros?
Cada semitono ocuparía muy pocos píxeles y el ruido normal de detección se convertiría en varios cents. Un campo más amplio da resolución espacial, reduce tensión y facilita vibrato controlado.
¿Qué ocurre si una mano desaparece?
Una pérdida breve conserva la trayectoria durante 110 ms. Después se silencia y reinicia el filtro. Si dejan de llegar fotogramas por completo, un watchdog apaga ambas voces tras el umbral de seguridad.
Técnica interpretativa
Encontrar notas sin referencias físicas
Escucha el destino antes de moverte. Desplaza la derecha con velocidad decidida, frena cerca de la altura y corrige con movimientos pequeños. En escala Libre, el oído es la referencia; el panel de Entrenamiento puede mostrar cents, estabilidad y vibrato sin alterar el sonido.
Ataque limpio
- Cierra volumen.
- Busca la altura con la derecha.
- Abre la izquierda sin desplazar el cuerpo.
Cambio legato
- Mantén volumen.
- Conecta alturas en un arco vertical.
- Frena sin bloquear la muñeca.
Cambio separado
- Cierra volumen.
- Reposiciona tono en silencio.
- Abre con el carácter del nuevo ataque.
Vibrato consciente
- Afina el centro.
- Oscila poco y regular.
- Cambia anchura y velocidad según la frase, no por hábito.
Ejercicio de cinco minutos
- Sostén una frecuencia 10 s sin vibrato; observa estabilidad, luego repite sin mirar.
- Haz glissandi de una octava a velocidad constante y escucha si el recorrido parece uniforme.
- Alterna dos alturas con volumen cerrado durante el viaje y ataque en destino.
- Sostén una nota y dibuja tres vibratos: estrecho/lento, estrecho/rápido, ancho/lento.
- Toca una frase corta y grábala; evalúa ataque, centro de afinación y final de cada nota por separado.
Modo entrenamiento
Los cents se calculan frente al semitono temperado más próximo. “Estabilidad” es dispersión en una ventana reciente y “vibrato” estima oscilaciones: son ayudas, no un juicio musical.
Rutas de práctica según tu objetivo
Control antes que extensión
Elige Webcam cómoda, Libre, Rockmore y reverb 8–12 %. Practica ataques con una sola altura, después intervalos pequeños. Cuando tres octavas sean predecibles, amplía de media en media.
Fraseo clásico
Usa Rockmore estable o Concierto completo, escala Libre, Cabinet activo y sala 8–16 %. Calibra antes de cada sesión importante. Trabaja con drone externo o referencia afinada, pero retíralos al consolidar la memoria espacial.
Diseñar comportamiento
Parte de Órbita prismática, prueba 4–5 octavas, aumenta inercia a 30–60 ms y explora XY lentamente. Graba gestos que no puedas repetir a mano y reprodúcelos como material compositivo.
Consejos de repertorio
- Transcribe primero melodías cantables con saltos moderados; el theremin revela cada transición.
- Marca respiraciones con la mano izquierda aunque no necesites tomar aire.
- En graves, reduce vibrato y deja espacio a los armónicos; en agudos, evita exceso de reverb.
- No persigas visualmente cada nota: usa la pantalla para diagnóstico y el oído para interpretar.
Laboratorio creativo
El laboratorio no sustituye los presets: los deforma de forma continua y permite capturar movimientos como datos.
| Herramienta | Función | Idea musical |
|---|---|---|
| Carácter X | Funde la voz activa hacia Órbita prismática. | Cambia de una línea vocal a un espectro hueco dentro de una nota sostenida. |
| Espacio Y | Añade reverb y eco sobre la base del preset. | Aleja finales de frase o crea perspectivas sin cambiar la altura. |
| Congelar nota | Mantiene la última frecuencia de la voz derecha; el volumen sigue siendo articulable. | Drone para afinación, pedal tonal o capa inmóvil. |
| Grabar gestos | Registra tiempo, frecuencia, amplitud y preset a un máximo de 30 Hz. | Captura un movimiento imposible de anotar. |
| Reproducir | Automatiza la voz derecha con el gesto capturado. | Interpreta con la otra mano/voz sobre una trayectoria previa. |
| Importar/exportar JSON | Intercambia hasta 18 000 eventos de gesto. | Archiva estudios o transforma datos fuera de la app. |
Tres recetas insólitas
Órbita respirante
Experimental · 4 octavas · inercia 45 ms · X 65 % · Y 45 %. Sostén una quinta lenta y articula pulsos irregulares con la izquierda.
Coro espectral de dos manos
Modo Dúo · Rockmore · escala Pentatónica · reverb 28 %. Mantén una mano como pedal y dibuja movimientos contrarios con la otra.
Señal de otro planeta
Sci‑Fi · Libre · 5,5 octavas · inercia 70 ms · Y 70 %. Abre volumen después de alcanzar la nota para que el vibrato automático aparezca con retardo.
Grabación, descarga y archivos
La grabadora recibe la mezcla después de voces, cabinet, espacio, limitador y master. No graba vídeo, micrófono ni sonido ambiente.
- Pulsa el botón circular rojo. El contador confirma que MediaRecorder está recibiendo audio.
- Interpreta y vuelve a pulsar para detener. El archivo comprimido aparece en el reproductor.
- Descarga el original o genera WAV PCM de 16 bits. La conversión conserva frecuencia de muestreo y canales que el navegador haya decodificado.
- En dispositivos compatibles, “Compartir” abre el panel del sistema. Nada sale del dispositivo hasta esa acción explícita.
Memoria
No existe un límite de duración impuesto por la app: la sesión se conserva en memoria hasta detenerla. Para tomas largas, divide por movimientos y descarga cada una.
Gestos JSON frente a audio
El audio conserva el resultado audible. El JSON conserva una trayectoria editable de frecuencia, amplitud, tiempo y preset. No son intercambiables: importa JSON para reinterpretar; importa audio en un editor para mezclar.
Solución de problemas por síntomas
La cámara no aparece o el permiso fue denegado
Comprueba que usas HTTPS o localhost, cierra otras apps que monopolizan la cámara y restablece el permiso del sitio. En iOS, abre la página en Safari normal, no dentro del navegador embebido de otra aplicación.
La app ve mis manos pero no suena
Pulsa EMPEZAR mediante un gesto real, verifica la salida de audio del sistema y abre volumen con la izquierda en Clásico. Si el AudioContext quedó suspendido al cambiar de pestaña, vuelve y pulsa Reiniciar.
El tono parece ir a saltos
Confirma escala Libre. Aumenta luz para recuperar FPS, evita Bluetooth y comprueba que no estés oyendo el “afina al parar” de una escala. El motor interpola cada objetivo de cámara; una detección visual muy irregular puede seguir sentirse imprecisa aunque la señal sea continua.
El tono tiembla cuando intento sostenerlo
Amplía el recorrido calibrado, reduce octavas, estabiliza codo y hombro y mejora luz. Prueba Webcam cómoda para separar jitter de técnica. El filtro One Euro suaviza, pero no debe borrar un vibrato deliberado.
Las manos intercambian su función
Entra con ellas separadas y evita cruces largos u oclusiones completas. La asociación temporal sobrevive cruces normales, pero necesita volver a observar cada palma.
No oigo Do1
32,7 Hz está por debajo de la respuesta útil de muchos teléfonos y portátiles. Sube a Rockmore estable o conecta altavoces/auriculares capaces de reproducir subgrave; no aumentes volumen de forma brusca.
Una IR no carga o suena extraña
Usa WAV/AIFF sin protección y de duración razonable. La IR se procesa localmente y complementa la cadena previa del cabinet; una IR ya ecualizada o muy larga puede duplicar coloración y cola.
El rendimiento cae con el tiempo
Cierra pestañas pesadas, reduce resolución desde la configuración del sistema si es posible, evita modo ahorro y reinicia. El motor intenta GPU y pasa a CPU si la delegación falla; el indicador FPS ayuda a reconocer el cambio.
Quiero volver al estado inicial
“Restablecer ajustes” borra configuración y calibración guardadas. Después pulsa Detener y EMPEZAR para reconstruir cámara y audio con Rockmore, Libre y Do1–Do7.
Para límites, fallbacks y valores exactos, consulta las especificaciones de compatibilidad.
Privacidad, accesibilidad y uso responsable
Vídeo local
La cámara se entrega al modelo dentro del navegador. La app no incorpora backend, analítica, telemetría, XHR, WebSocket ni subida de fotogramas.
Dependencias de red
En el primer arranque se descargan MediaPipe/WASM desde jsDelivr y el modelo de manos desde Google Storage. Por eso no es completamente offline.
Datos persistentes
Ajustes y calibración viven en localStorage sin cifrado. IR, gestos y grabaciones permanecen locales salvo descarga o uso explícito de Compartir.
Acceso físico
Adapta rango, calibración y respuesta a tu movilidad. No existe una única postura “correcta”; la técnica debe evitar dolor y fatiga.
Teclado y lectura
Los documentos son navegables por teclado, ofrecen salto al contenido, foco visible, índice semántico, modo de impresión y reducción de movimiento. En la app, los controles estándar admiten teclado, pero la interpretación musical requiere una cámara y gestos de mano.
Si aparece dolor
Detén la sesión, baja brazos y descansa. Reduce extensión o cambia encuadre. La precisión nunca justifica mantener hombros elevados ni una muñeca forzada.
Referencia rápida
| Objetivo | Sonido | Perfil | Escala | Espacio |
|---|---|---|---|---|
| Theremin de concierto | Rockmore | Concierto completo o Rockmore estable | Libre | 8–16 % |
| RCA doméstico 1929 | RCA + Cabinet | RCA 1929 | Libre | 5–12 % |
| Aprendizaje | Rockmore | Webcam cómoda | Cromática o Libre | 5–10 % |
| Ciencia ficción | Sci‑Fi | 3–5 octavas | Libre / menor | 30–50 % |
| Improvisación extraña | Órbita | Personalizado | Pentatónica / Libre | 25–60 % + XY |
Regla de oro: si algo se siente demasiado sensible, amplía el gesto o reduce octavas antes de aumentar el filtrado. Si algo se siente lento, prueba audio con cable y más luz antes de reducir toda la inercia.
Continúa con la historia del theremin o consulta la especificación técnica completa.