Modo portatil: ejecutar FOSFENO en un portatil Linux

Anade 'bash install.sh --laptop' y el lanzador './fosfeno' para correr FOSFENO en portatiles Debian/Ubuntu/Mint sin Raspberry Pi: puerto 8080, sin arranque automatico ni cambios en el sistema. El servidor admite las variables FOSFENO_PORT y FOSFENO_NO_KIOSK. Nueva documentacion en docs/portatil.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
hacklab 2026-05-22 14:39:34 +02:00
parent 30a09fdee6
commit 3c1c631895
7 changed files with 250 additions and 53 deletions

View file

@ -16,6 +16,9 @@ para consultarse a saltos después.
Cómo encuentra el usuario el panel de control: el código QR del proyector,
la dirección `fosfeno.local` y qué hacer con el router.
- [FOSFENO en un portátil Linux](portatil.md)
Cómo correr FOSFENO en un portátil Debian, Ubuntu o Mint, sin Raspberry Pi.
- [Uso del panel](uso.md)
Cómo se maneja desde el móvil, qué hace cada motor de visuales y cómo se
configura cada opción.

71
docs/portatil.md Normal file
View file

@ -0,0 +1,71 @@
# FOSFENO en un portátil Linux
FOSFENO nació para una Raspberry Pi, pero está hecho con tecnología web, así
que funciona igual de bien en un portátil con Linux. De hecho un portátil va
más sobrado, ya trae micrófono y cámara, y lo conectas al proyector por HDMI
como cualquier otra cosa.
Este modo está pensado para Debian, Ubuntu o Linux Mint, que son las
distribuciones que usan `apt`.
## Instalar
Una sola vez, desde la carpeta del proyecto:
```
bash install.sh --laptop
```
Hace lo mismo que en la Raspberry (entorno de Python, librerías de visuales,
y projectM si quieres), pero sin las cosas propias de un aparato dedicado: no
toca el arranque del sistema, no cambia el nombre de red y no necesita
permisos especiales de puertos.
## Arrancar
Cuando quieras usarlo, desde la carpeta del proyecto:
```
./fosfeno
```
Eso levanta FOSFENO y abre dos cosas:
- El **panel de control** en tu navegador, en `http://localhost:8080/`.
- Una **ventana con las visuales**, aparte.
Para cerrarlo todo, pulsa `Ctrl+C` en la terminal donde lanzaste `./fosfeno`.
## Llevar las visuales al proyector
La ventana de las visuales es una ventana normal. Conecta el proyector por
HDMI, arrastra esa ventana a la pantalla del proyector y pulsa `F11` para
ponerla a pantalla completa. El panel de control lo manejas desde el portátil,
o desde el móvil si prefieres.
## Micrófono y cámara
El portátil ya trae micrófono y cámara integrados. No hace falta nada por USB,
aunque puedes usarlo si quieres mejor sonido o una webcam mejor.
La primera vez, elige el micrófono en el apartado Audio del panel, y la cámara
en el apartado del Mezclador. Si los conectas con FOSFENO ya abierto, usa el
botón de buscar dispositivos de nuevo.
## Controlarlo desde el móvil
Si quieres manejar el panel desde el móvil mientras el portátil hace de VJ,
conecta el móvil a la misma red WiFi y entra en `http://nombre-del-portatil.local:8080/`.
El nombre del portátil lo ves con el comando `hostname`. La dirección exacta
también aparece en la terminal al arrancar `./fosfeno`.
## En qué se diferencia de la Raspberry
- No arranca solo: lo lanzas tú con `./fosfeno` cuando lo necesitas.
- Usa el puerto 8080 en lugar del 80.
- No cambia el nombre de red del equipo.
- Los botones de reiniciar y apagar del panel no harán nada (es tu portátil,
no un aparato dedicado, así que es lo correcto).
Todo lo demás (los cinco motores, el editor de código, la detección de BPM,
el mezclador) funciona exactamente igual.