ClickerFex
Tu teléfono como clicker de presentaciones: touchpad, avanzar/retroceder y láser por giroscopio. Web estática (Vercel), vinculación por QR, sin cuentas.
Uso
- En la computadora abrí la web. Aparece un QR y un código de 5 caracteres.
- Escaneá el QR con la cámara del teléfono (Android: Chrome). Queda vinculado.
- Elegí modo en la computadora:
| Modo | Instalación | Controla | Cuándo |
|---|
| PDF en navegador | Nada | El PDF dentro de la web | PCs ajenas (universidad, eventos) |
| Sistema (agente) | Agente: ejecutable o script Python | Mouse y teclado reales: PowerPoint, Keynote, Google Slides, Canva | Tu propia laptop |
Controles en el teléfono
- Touchpad: deslizar mueve el puntero (con aceleración), tocar = clic, tocar con dos dedos = clic derecho, arrastrar con dos dedos = scroll.
- Arrastrar (modo sistema, agente v5+): apoyá el dedo quieto ~0,5 s hasta que vibre y el touchpad diga Arrastrando; mové para arrastrar (ventanas, archivos, seleccionar texto, sliders). Al levantar el dedo hay medio segundo para volver a apoyarlo y seguir arrastrando (útil porque el touchpad es chico); si no, suelta. Un toque durante ese medio segundo suelta al instante. Si el dedo se mueve antes del medio segundo es un movimiento normal.
- Cambiar de app (3 dedos, modo sistema): deslizar con tres dedos abre el selector de ventanas (Alt+Tab en Windows, Cmd+Tab en macOS); seguir deslizando mueve la selección (cada ~70 px, también arriba/abajo en Windows); levantar los dedos cambia a esa app. Requiere agente v4.
- ‹ / ›: diapositiva anterior / siguiente.
- Láser: apuntá con la parte de arriba del teléfono (donde está la cámara selfie) hacia el centro de la pantalla y mantené apretado el botón. El punto aparece en el centro y sigue hacia dónde apuntás, como un láser real. Usa orientación absoluta: girar el teléfono sobre su eje largo no lo mueve, y la misma dirección siempre cae en el mismo lugar.
- Ajuste clave (
⋯ → Ancho de la pantalla vista desde vos): cuántos grados ocupa la pantalla desde donde estás parado. Default 30° (≈3 m de pantalla a 5–6 m). Lejos o pantalla chica: bajalo. Cerca o pantalla gigante: subilo.
- También se puede cambiar a modo toque (encender/apagar).
- La pantalla del teléfono no se apaga mientras está vinculado. Para usarlo como app: menú de Chrome → Agregar a pantalla principal.
Atajos en la computadora (modo PDF)
→ Espacio Enter siguiente · ← anterior · F pantalla completa · Q mostrar QR para vincular otro teléfono.
Modo sistema: agente de escritorio
Un navegador no puede mover el mouse del sistema ni enviar teclas a otras apps. El agente es un programa chico que hace eso, escuchando solo en localhost:8765. Con el agente, el touchpad del teléfono maneja toda la computadora.
Ejecutable (sin Python) — links en la web, o en el release agent-latest. GitHub Actions lo recompila en cada cambio de agent/.
- Windows: abrir
ClickerFex-Agent-Windows.exe. Si aparece SmartScreen: Más información → Ejecutar de todas formas (no está firmado).
- macOS (Apple Silicon): descomprimir, clic derecho → Abrir la primera vez (no está firmado). Dar permiso de Accesibilidad a Terminal en Ajustes → Privacidad y seguridad.
Con Python:
cd agent
pip install -r requirements.txt
python clickerfex_agent.py
Después, en la web abierta en esa misma computadora: Conectar agente (Chrome puede pedir permiso de "acceso a la red local": aceptar). La pestaña de ClickerFex debe quedar abierta (puede estar en segundo plano, o mejor en su propia ventana) mientras presentás.
- Láser en modo sistema: mientras mantenés el botón, el puntero se convierte en un punto rojo visible sobre cualquier app (también PowerPoint/Keynote en pantalla completa); al soltar vuelve el cursor normal. Windows reemplaza el cursor del sistema; macOS dibuja el punto en una capa transparente y oculta el cursor.
--no-dot lo desactiva.
- Escribir y dictar (botón de micrófono, solo en modo sistema): hacé clic en un campo de texto con el touchpad y dictá con el micrófono del teléfono; cada frase se escribe en la computadora. También hay un campo para escribir con el teclado del teléfono, y teclas Borrar / Tab / Enter. El dictado usa el reconocimiento de voz de Chrome (requiere internet).
- Seguridad: el agente solo acepta conexiones desde
https://clickerfex.vercel.app. Si usás otro dominio: python clickerfex_agent.py --origin "https://tu-dominio\.com". Para desarrollo local (npm run dev): python clickerfex_agent.py --dev, que además acepta páginas servidas en localhost.
- Segundo plano: con el agente conectado, la pestaña mantiene abierto un flujo de audio inaudible para que Chrome no le baje la prioridad cuando queda detrás de otra pestaña o de PowerPoint. El teléfono muestra la demora de ida y vuelta (
Conectado · 12 ms); si aparece vía servidor externo, la red no deja que teléfono y computadora se hablen directo.
Modo Recorrido (Matterport y otros recorridos 3D)
En el teléfono, el selector Clicker / Recorrido cambia el control a un joystick. Requiere el modo sistema (agente v2 o posterior).
| Control | Acción | Tecla que mantiene el agente |
|---|
| Cruz de flechas | Caminar adelante / atrás / costados | W S A D |
| Joystick | Girar la cámara | I K J L |
| Palanca | Zoom (vuelve sola al centro) | rueda del mouse |
El modo Recorrido se usa con el teléfono de costado: cámara a la izquierda, movimiento a la derecha, zoom arriba. Si la rotación automática está bloqueada, la pantalla se gira sola.
La cámara de Matterport solo entiende tecla apretada o suelta, así que la velocidad se regula pulsando la tecla: Ajustes → Velocidad de la cámara (50 % por defecto) fija la del borde del joystick; cerca del centro gira más lento.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
