Kit Viewifi · versión 1.0.0

Una Raspberry Pi vigilando tu casa en 15 minutos.

Graba esta imagen en una microSD, enciende la Pi y configúrala desde el móvil. Detecta movimiento con la señal WiFi que ya tienes — sin cámaras, sin cablear nada y sin escribir un solo comando en la terminal.

  • Gratissin registro
  • ~500 MBPi 3, 4 y 5
  • 0comandos en terminal

Archivo: viewifi-kit-1.0.0-arm64.img.xz · notas de la versión

Qué es exactamente

Es Raspberry Pi OS de 64 bits con el sensor de Viewifi ya instalado y un asistente de configuración que se abre solo la primera vez. Nada más: no lleva escritorio, ni programas de relleno, ni telemetría.

Viewifi detecta movimiento midiendo cómo un cuerpo humano perturba las ondas de radio entre la Raspberry Pi y tu router. Por eso funciona en la oscuridad total y a través de paredes, y por eso no hay ninguna cámara grabando: lo que se mide es la señal, no la imagen.

¿Esta imagen o solo el programa?

Si vas a dedicar una Raspberry Pi entera al sensor, usa esta imagen: es el camino corto y no toca la terminal. Si tu Pi ya hace otras cosas —Pi-hole, Home Assistant, un NAS— no la grabes: descarga solo el ejecutable, que se instala encima sin romper nada.

Qué necesitas

  • Una Raspberry Pi 3, 4 o 5. Tiene que ser de 64 bits; la Pi 1, la 2 y la Zero original no valen.
  • Una microSD de 8 GB o más. Se borra entera al grabar.
  • La fuente de alimentación de la Pi.
  • Un móvil para la configuración.
  • Una cuenta de Telegram, gratis, donde llegarán las alertas.

No hace falta monitor, ni teclado, ni cable de red, ni cámara.

Los cuatro pasos

De la descarga a las primeras alertas. Unos 15 minutos, casi todos de espera.

  1. Graba la imagen

    Abre Raspberry Pi Imager, pulsa Elegir SO y baja hasta Usar personalizado. Selecciona el archivo .img.xz descargado — no hace falta descomprimirlo. Elige tu microSD y graba.

    Importante: cuando el Imager pregunte si quieres aplicar ajustes personalizados, responde que no. La imagen ya trae los suyos y los del Imager los pisarían.

  2. Enciende la Pi

    Mete la microSD, conecta la alimentación y espera unos dos minutos. La luz verde parpadea mientras arranca. El primer encendido tarda más porque el sistema se expande para ocupar toda la tarjeta.

    No necesitas conectarle nada más: ni monitor, ni teclado, ni cable de red.

  3. Conéctate a Viewifi-Setup

    En el móvil, abre los ajustes de WiFi. Aparecerá una red nueva:

    RedViewifi-Setup
    Contraseñaconfigurar

    El móvil avisará de que esa red no tiene internet. Es normal — dile que se mantenga conectado.

  4. Configura desde el navegador

    Abre http://10.42.0.1 y rellena el formulario: tu red WiFi de casa, una contraseña para el panel y, si quieres, tu cuenta de Viewifi y tu bot de Telegram.

    Al guardar, la Pi se conecta a tu red y se reinicia ya configurada. Vuelve a poner el móvil en tu WiFi de siempre.

Y ya está: abre el panel

Entra en http://viewifi.local:8080 desde cualquier dispositivo de tu red. Ahí tienes la gráfica de señal en vivo, el botón de armar y desarmar, el historial de eventos y toda la configuración. Si viewifi.local no resuelve en tu red, busca en tu router un equipo llamado viewifi y abre su IP con :8080 al final.

Dónde colocarla

Esto importa más que cualquier ajuste del software. Coloca la Raspberry Pi de forma que quien entre pase entre la Pi y el router: ahí es donde más se altera la señal. Un pasillo, un recibidor, o la línea que va de la puerta al salón son buenos sitios.

Evita pegarla al router. Una señal demasiado fuerte apenas varía y el sensor pierde sensibilidad. Y evita también el extremo contrario: por debajo de −75 dBm el ruido se come la señal.

Después de moverla de sitio, pulsa Recalibrar en el panel con la casa vacía. El sensor vuelve a medir su línea base y se ajusta a la nueva posición.

Un detalle que ahorra frustración

La Pi tiene que estar conectada a tu WiFi, no por cable. Lo que mide es la calidad de ese enlace inalámbrico: con Ethernet no hay nada que medir.

Qué lleva dentro

ComponentePara qué
Raspberry Pi OS Lite 64 bitsEl sistema base, oficial y sin modificar más allá de lo que añadimos.
Viewifi HostEl sensor y el panel web del puerto 8080. Código Python, sin dependencias externas.
Asistente de primer arranqueEl punto de acceso Viewifi-Setup y el formulario de configuración.
Tres servicios systemdArrancan solos, se reinician tras un apagón y se recuperan de cualquier fallo.
LEEME.txtLa guía rápida, visible al abrir la microSD desde cualquier ordenador.

Seguridad

  • No hay contraseña de fábrica. La imagen sale con una aleatoria que se descarta durante su propia construcción. La primera contraseña real es la que eliges tú en el asistente.
  • SSH viene desactivado. Si lo quieres, creas un archivo vacío llamado ssh en la partición de arranque.
  • La contraseña del WiFi se borra sola del archivo de configuración en cuanto la Pi se conecta. Esa partición se lee desde cualquier ordenador, así que no es sitio para una credencial.
  • El sensor corre sin privilegios, con permisos de escritura limitados a su propia carpeta.
  • La cámara y el micrófono están apagados y solo se activan si tú los enciendes en el panel.
Comprobar que la descarga llegó entera

El sha256 del archivo es 34d809c84aa392c643bb1bcc8dbdd49f27a67bef7f1c585403f1c55957f7f489. En Windows: certutil -hashfile viewifi-kit-1.0.0-arm64.img.xz SHA256. En Linux o macOS: sha256sum o shasum -a 256.

Preguntas frecuentes

¿Cuál es la diferencia entre la imagen completa y descargar solo el programa?

La imagen completa trae el sistema operativo entero y borra la microSD: es para dedicar una Raspberry Pi al sensor, y no necesitas terminal. El programa suelto son unos 15 MB que instalas sobre el sistema que ya tienes: sirve si tu Pi ya hace otras cosas, como Pi-hole o Home Assistant, y sí requiere terminal.

¿La imagen borra lo que tenga la Raspberry Pi?

Borra la tarjeta microSD que grabes, no la Raspberry Pi en sí. Si quieres conservar lo que ya tienes, usa otra microSD: cambiarlas lleva un segundo y puedes volver a la anterior cuando quieras.

¿Qué tarjeta microSD necesito?

Cualquiera de 8 GB o más. El sistema ocupa unos 3 GB una vez grabado y el resto queda libre para el historial de eventos, que crece muy despacio. Una tarjeta de clase 10 va sobrada.

¿Funciona en una Raspberry Pi Zero 2 W?

En teoría sí, porque su procesador es ARM64 igual que el de la Pi 3, pero no está probado. Las que sí hemos verificado son la Pi 3, la 4 y la 5. La Pi Zero original y la Pi 1 y 2 no sirven: su procesador no es de 64 bits.

¿Cómo compruebo que la descarga llegó completa?

El sha256 del archivo es 34d809c84aa392c643bb1bcc8dbdd49f27a67bef7f1c585403f1c55957f7f489. En Windows ejecuta certutil -hashfile viewifi-kit-1.0.0-arm64.img.xz SHA256, y en Linux o macOS sha256sum o shasum -a 256. Si el resultado coincide, el archivo está íntegro.

¿Qué contraseña trae la imagen de fábrica?

Ninguna. La imagen sale con una contraseña aleatoria que se descarta durante su propia construcción, así que nadie puede entrar hasta que tú elijas la tuya en el asistente. Esa contraseña vale a la vez para el panel y para el usuario del sistema. El acceso remoto por SSH viene desactivado.

¿Puedo volver a empezar si me equivoco al configurarla?

Sí. Apaga la Pi, saca la microSD, métela en el ordenador y crea un archivo vacío llamado viewifi-reset.txt en la partición de arranque. Al encenderla, la Pi olvida su configuración y vuelve a mostrar la red Viewifi-Setup.

¿No aparece la red Viewifi-Setup?

Dale tres minutos desde que la enchufaste. Si sigue sin salir, desconecta y vuelve a conectar la alimentación. Esa red solo aparece mientras la Pi no está configurada: si ya la configuraste antes, no volverá a salir hasta que hagas el reinicio de fábrica.

Descarga la imagen

Gratis, sin registro y sin anuncios. Solo necesitas una Raspberry Pi y una tarjeta.

~500 MB · Raspberry Pi 3, 4 y 5 · versión 1.0.0