Cómo Instalar MotionEye en Raspberry Pi (Videovigilancia)

MotionEye es una interfaz web para el servicio Motion, que se usa comúnmente en Raspberry Pi para conectar, gestionar y monitorizar todo tipo de cámaras. No está disponible directamente en el repositorio oficial de Raspberry Pi OS, así que te guiaré paso a paso a través del proceso de instalación en tu Pi en este tutorial.

MotionEye se puede instalar en cualquier distribución de Linux usando PIP (el gestor de paquetes de Python). Todas las dependencias, incluyendo Motion y un servidor web, se agregarán automáticamente al sistema.

Empezaré con los requisitos previos (hardware y software), y luego te daré todos los comandos para que puedas instalarlo en tu Raspberry Pi en unos minutos.

Requisitos previos para ejecutar MotionEye en Raspberry Pi

MotionEye se puede usar de muchas maneras, pero aquí están mis recomendaciones para empezar correctamente con él en Raspberry Pi.

Requisitos de hardware

• Cualquier modelo de Raspberry Pi: Estoy probando esto en mi Raspberry Pi 4, pero realmente no importa. Los servicios son lo suficientemente ligeros como para funcionar en cualquier modelo y todos están soportados.
  Un Raspberry Pi Zero 2W (en inglés) podría ser una buena opción por si planeas conectar una cámara directamente a él (pequeño y discreto pero lo suficientemente potente).
  
• Tarjeta SD o memoria USB para el sistema: utilizaremos Raspberry Pi OS, así que ambos son compatibles. Yo probé con mi memoria USB SanDisk estándar.
  Podrías necesitar una unidad adicional si planeas grabar el flujo de la cámara, o agregar detección de movimiento más adelante (este sería mi disco preferido para esto, mismas dimensiones que tu Pi con montones de espacio en disco).
  
• Teclado y ratón (opcional): estoy usando mi nuevo teclado favorito Rii para todos mis proyectos ahora. Pero puedes usar una configuración sin cabeza y seguir este tutorial desde tu computadora si prefieres.

Un módulo de cámara es opcional. Puedes usar motion eye de dos maneras principales:

• Como el centro de control solo para la interfaz web. Lo conectarás a varias cámaras IP, o a otro Raspberry Pi (ejecutando Motion o MotionEye si es necesario).
• Como una cámara de seguridad autónoma, con un solo dispositivo. En este caso, necesitarás un módulo de cámara en el mismo Pi que MotionEye.

Recomiendo usar el módulo de cámara oficial para esto (o la alternativa NoIR). Están perfectamente soportados por Raspberry Pi OS y MotionEye, por lo que sería la forma más fácil.

Sistema operativo

MotionEye se basa en Python, por lo que debería funcionar en cualquier sistema operativo siempre que tengas Python 3 disponible (e instalado).

Recientemente actualicé este artículo usando Raspberry Pi OS Bookworm, la versión Lite, así que recomiendo usar lo mismo si estás comenzando desde cero. Ha habido muchos cambios en la forma en que el sistema maneja los módulos de cámara en las últimas versiones, por lo que puede que notes algunas diferencias si usas otra cosa.

Si necesitas ayuda para instalar Raspberry Pi OS, puedes hacer clic en este enlace para seguir mi tutorial. Para configurar tu sistema con acceso a la red y continúa.

Nota: Hay una imagen de MotionEyeOS disponible en algún lugar, pero no se ha actualizado durante varios años. No la estoy usando porque probablemente sea más seguro comenzar con Raspberry Pi OS e instalar la aplicación “manualmente”.

Opcional: Instalación de la cámara

MotionEye puede conectarse a cualquier tipo de cámara, cámara local (USB, módulo de cámara, …), o cualquier modelo en tu red (o incluso cámaras remotas). Una vez que la interfaz está instalada, puedes agregar tantas cámaras como desees.

Pero si planeas usar un módulo de cámara Raspberry Pi en él, por favor asegurate de realizar la instalación y las pruebas antes de continuar. No tiene sentido seguir todos los pasos para MotionEye si la cámara no funciona ya.

Tengo un tutorial dedicado en este sitio web sobre cómo instalar un módulo de cámara en Raspberry Pi. Léelo para más detalles.

Guía de instalación de MotionEye

Aquí están los pasos principales para instalar MotionEye en tu Raspberry Pi:

• Asegurarte de que tu sistema esté actualizado.
• Instalar todas las dependencias de Python y el administrador de paquetes PIP.
• Usar PIP para descargar e instalar MotionEye desde el proyecto en GitHub.

Vamos a ver todos estos pasos en detalle ahora.

Actualizar tu sistema

Como siempre, es una buena práctica actualizar tu sistema antes de empezar cualquier instalación de paquetes para un nuevo proyecto. Puedes hacer esto con dos comandos:
sudo apt update
sudo apt upgrade -y

Puedes escribirlos directamente en la Raspberry Pi, o hacerlo como yo, y usar SSH para hacer todo desde la comodidad de tu computadora (aquí está mi guía de SSH si necesitas ayuda para configurarlo).

Instalar dependencias de MotionEye

Podemos seguir adelante e instalar las dependencias necesarias para MotionEye:
sudo apt install python3-dev libcurl4-openssl-dev libssl-dev

En Raspberry Pi OS, Python 3 viene preinstalado (en todas las versiones), así que debería ser bastante rápido. Pero si usas otra distribución, probablemente habrá muchos más paquetes que instalar en esta etapa.

También necesitamos PIP (el gestor de paquetes de Python), así que asegúrate de que esté instalado usando este comando:
sudo apt install python3-pip

Instalar MotionEye

Ahora que las dependencias están instaladas, podemos usar los comandos principales para instalar MotionEye. Descargaremos el archivo desde su proyecto en GitHub directamente. Así que siéntete libre de hacer clic en el enlace si quieres echarle un vistazo primero.

De todos modos, aquí tienes el comando para instalarlo con PIP:
sudo pip3 install 'https://github.com/motioneye-project/motioneye/archive/dev.tar.gz'

Nota: Si estás instalando MotionEye en Bookworm o posterior, obtendrás un error en este punto porque evita instalar bibliotecas fuera de un entorno virtual (más sobre eso aquí, en inglés).

Según el desarrollador, MotionEye tiene una pequeña cantidad de dependencias, por lo que está bien usar esta bandera para eludir esta seguridad:
sudo pip3 install 'https://github.com/motioneye-project/motioneye/archive/dev.tar.gz' --break-system-packages

Una vez hecho esto, ahora si podemos ejecutar el script de inicialización de MotionEye, que te añadirá todos los requisitos (incluyendo Motion, MariaDB, un servidor web, etc.):
sudo motioneye_init

Sólo probé en una instalación nueva de Raspberry Pi OS, así que no podria decirte qué tan bien está integrado si es que ya tienes algunos de estos servicios en funcionamiento. Supongo que en algún momento te pedirá tu contraseña de MySQL, pero no lo sé. Quizás sea más seguro hacer una copia de seguridad primero en este caso.

Empezando con MotionEye

Una vez que MotionEye está instalado, está listo para usarse. La interfaz web se inicia automáticamente, por lo que puedes usarla directamente para añadir nuevas cámaras a tu sistema. Aquí te comparto algunos consejos para empezar.

Acceso y configuración web

La interfaz de MotionEye es accesible a través de un navegador web, en la dirección IP de la Raspberry Pi con el puerto 8765: http://<YOUR-IP>:8765.

Si no sabes la dirección IP de la Raspberry Pi, puedes usar una de las formas listadas aquí para encontrarla rápidamente. Si tienes un entorno de escritorio, http://localhost:8765 debería funcionar también.

La página predeterminada de MotionEye te da un formulario de inicio de sesión. Las credenciales predeterminadas son:

• Login: admin
• Password: (empty)

Haz clic en “Login” para acceder a la interfaz completa.

Requisitos para Bookworm y versiones posteriores

Mientras actualizo este artículo, agregar una cámara todavía no funciona por defecto en una instalación nueva de Raspberry Pi OS Bookworm. Hay algunos pasos adicionales.

Puedes intentar la siguiente sección sin hacer estos y ver qué pasa, pero probablemente necesitarás hacerlos para que funcione:

• Instalar el paquete libcamera:
  sudo apt install libcamera-v4l2
• Actualizar el archivo de servicio para usarlo:
  sudo sed -i 's/\/usr\/local\/bin\/meyectl/\/usr\/bin\/libcamerify \/usr\/local\/bin\/meyectl/' /etc/systemd/system/motioneye.service
• Reiniciar el servicio MotionEye para aplicar cambios:
  sudo systemctl restart motioneye

Después de eso, debería funcionar casi igual sin importar la versión del SO que estés usando.

Agregando tu cámara

Una vez conectado a la interfaz web, se te invitará a agregar tu cámara a ella.

Desde allí, los siguientes pasos serán completamente diferentes dependiendo de tu proyecto. Si solo quieres agregar el módulo de cámara del Raspberry Pi, elige el que se sugiere por defecto en la lista de cámaras:

Si todo funciona como se espera, deberías ver una interfaz parecida a esta:

Tienes una vista previa de tu cámara en el lado derecho y muchas opciones en el lado izquierdo. Puedes añadir tantas cámaras como quieras haciendo clic en la lista desplegable (Camera1) y luego “Add new camera…”.

Como te mencioné antes, MotionEye es compatible con el módulo de cámara Pi, pero puedes añadir cualquier cámara remota a la misma página y ver todas tus cámaras de seguridad desde una sola página.

Desde aquí, te dejo jugar con todas las opciones y consultar la wiki oficial para preguntas específicas.

Para llevar tu proyecto un poco más allá, probablemente añadiría un servidor VPN en el Raspberry Pi, para que puedas acceder a la página de MotionEye desde cualquier lugar. En este caso, solo no olvides configurar una contraseña fuerte (Admin sin contraseña no es una buena idea ^^).

Gestionar el servicio

Los servicios MotionEye y Motion están configurados para iniciarse automáticamente después de la instalación, por lo que no deberías preocuparte por ellos.

Si es necesario, puedes manejarlos con tu comando favorito de gestión de servicios. Generalmente uso service para esto:
sudo service <service_name> status | start | restart | stop
Pero “systemctl” debería funcionar también.

Entonces, por ejemplo:
sudo service motioneye status

Y si estás buscando otras ideas de proyectos interesantes que puedes hacer con un Raspberry Pi (y una cámara), echa un vistazo a estos artículos:

• 11 Ideas Geniales para Proyectos con el Módulo de Cámara de Raspberry Pi (en inglés)
• Cómo Hacer Streaming en Vivo con la Cámara de Raspberry Pi (2 Formas Fáciles) (en inglés)
• Cómo Usar la Cámara de Raspberry Pi con Python (en inglés)