im1k31s/motioneye-custom repository overview

⁠MotionEye Custom

A custom fork of motionEye⁠ — a web frontend for the Motion⁠ video surveillance daemon — with hardened security, cross-platform camera discovery, optional facial recognition, and Home Assistant integration.

⁠Quick start (Docker)

docker run -d \
  --name motioneye \
  --restart unless-stopped \
  -p 8765:8765 \
  -p 8081:8081 \
  -v motioneye-config:/etc/motioneye \
  -v motioneye-media:/var/lib/motioneye \
  im1k31s/motioneye-custom:edge

Then open http://localhost:8765/⁠ — you'll be prompted to set the admin password on first boot.

⁠Available tags on Docker Hub⁠

For native install (Linux, macOS, Windows/WSL2) and the full Docker Compose recipe, see docs/INSTALLATION.md⁠.

⁠Features

• 🎥 Multi-camera support — USB/V4L2, IP/RTSP, MJPEG, Pi CSI/MMAL, macOS AVFoundation, and remote-motionEye relays
• 🔍 Motion detection with configurable sensitivity, masks, and scheduling
• 🤖 Facial recognition (optional, via face_recognition) — tag familiar faces, log unfamiliar ones
• 🏠 Home Assistant native integration via MQTT discovery
• 📧 Email, webhook, and Telegram notifications
• 🐳 Multi-architecture Docker images (amd64 + arm64)
• 🔐 Hardened security: bcrypt passwords, XSRF, strict CSP, TLS verification always enforced — see CHANGELOG.md for the full audit log

⁠Supported camera types

The Add Camera dialog auto-detects host capabilities and only shows options that actually work. Labels carry the friendly name with the technical backend in parentheses.

⁠Documentation

⁠Compatibility

⁠Contributing

git clone https://github.com/M1K31/MotionEye-Custom.git
cd MotionEye-Custom
make dev-install      # bootstraps motioneye_env/ and installs deps
make test

See docs/DEVELOPMENT.md⁠ for setup details and CONTRIBUTING.md⁠ for the PR workflow.

⁠License

GPL-3.0 — see LICENSE⁠.

⁠Acknowledgments

Built on the excellent motionEye⁠ project and the Motion⁠ daemon.