⚠️ BREAKING CHANGE NOTICE
Version 2.0.0+ requires configuration migration!

This plugin has been converted from an accessory plugin to a platform plugin. If you're upgrading from v1.x, you MUST update your Homebridge configuration. See the Migration Guide below.

Old: Configured in "accessories" array
New: Configured in "platforms" array

This plugin offers you a motion sensor that can be triggered via an HTTP request. This can be used in conjunction with an ESP8266 for instance or an Arduino with an ethernet shield. I will add an example Arduino script in the future.

This version has been completely modernized to use the latest Homebridge APIs and best practices, following the official Homebridge documentation:

• 🏗️ Platform Plugin Architecture: Converted from accessory plugin to platform plugin as recommended by Homebridge developers
• 📦 Multiple Sensor Support: Configure multiple HTTP motion sensors in a single platform
• ⬆️ Updated to Homebridge 1.10.0: Now compatible with the latest Homebridge version
• 🚀 Homebridge v2.0 Ready: Full compatibility with Homebridge v2.0 beta and stable releases
• 🗑️ Removed deprecated dependencies: Eliminated homebridge-ts-helper dependency and use modern Homebridge APIs directly
• ✨ Enhanced Configuration UI: Rich configuration schema with validation and user-friendly forms
• 🛡️ Better error handling: Enhanced HTTP server error handling and configuration validation
• 🧹 Cleaner codebase: Improved code structure, better TypeScript types, and modern async patterns
• 📊 Better logging: More informative debug and info logging throughout the plugin
• 🧪 Comprehensive Testing: CI-ready test suite with automated functional testing

⚠️ Configuration Format Changed: The plugin now uses platform configuration instead of accessory configuration.

• Requires Homebridge 1.6.0 or later (compatible with Homebridge v2.0)
• Node.js 20.15.1 or 22+ required (Node.js 18 support dropped, following Homebridge v2.0)
• Migration required: See migration guide below

✅ This plugin is fully compatible with both Homebridge v1.x and v2.0:

• Uses modern HAP-NodeJS APIs (no deprecated patterns)
• Follows current Homebridge platform plugin best practices
• Tested with Homebridge v2.0 beta releases
• Ready for Homebridge v2.0 stable release

Users will see a green checkmark in the Homebridge UI readiness check when using this plugin with Homebridge v2.0.

⚠️ REQUIRED CONFIGURATION CHANGE: This plugin now uses platform configuration instead of accessory configuration.

Follow these steps to migrate:

1. Remove the old accessory configuration from your "accessories" array
2. Add the new platform configuration to your "platforms" array
3. Restart Homebridge

{
    "accessories": [
        {
            "accessory": "http-motion-sensor",
            "name": "Hallway Motion Sensor",
            "port": 18089
        }
    ]
}

{
    "platforms": [
        {
            "platform": "HttpMotionSensorPlatform",
            "name": "HTTP Motion Sensor Platform",
            "sensors": [
                {
                    "name": "Hallway Motion Sensor",
                    "port": 18089
                }
            ]
        }
    ]
}

🎉 Benefits of the new platform configuration:

• Support for multiple motion sensors in one configuration
• Better resource management and performance
• Enhanced configuration UI with validation
• Future-proof architecture following Homebridge best practices

Run the following command

npm install -g homebridge-http-motion-sensor

Chances are you are going to need sudo with that.

This plugin now uses the platform plugin architecture for better flexibility and multiple sensor support. Here's an example configuration:

{
    "platforms": [
        {
            "platform": "HttpMotionSensorPlatform",
            "name": "HTTP Motion Sensor Platform",
            "sensors": [
                {
                    "name": "Hallway Motion Sensor",
                    "port": 18089,
                    "serial": "E642011E3ECB",
                    "model": "ESP8266 Motion Sensor",
                    "bind_ip": "0.0.0.0",
                    "repeater": [
                        {
                            "host": "192.168.2.11",
                            "port": 22322,
                            "path": "/turnonscreentilltimeout",
                            "auth": "Bearer your-token-here"
                        }
                    ]
                },
                {
                    "name": "Garden Motion Sensor",
                    "port": 18090,
                    "serial": "F642011E3ECC",
                    "model": "ESP8266 Motion Sensor"
                }
            ]
        }
    ]
}

• Multiple Sensors: Configure multiple motion sensors in a single platform
• Better Resource Management: Shared platform resources and better lifecycle management
• Future-Proof: Follows modern Homebridge best practices
• Enhanced Configuration: Rich configuration UI with validation
• Improved Logging: Better debugging and monitoring capabilities

Run the full automated test suite:

npm test

This will:

• Build the plugin
• Start a test Homebridge instance
• Create two test motion sensors on ports 18089 and 18090
• Test motion detection and reset functionality
• Verify HTTP responses, multiple requests, and different endpoints
• Test motion reset after timeout
• Show logs and optionally keep Homebridge running for manual testing

For CI environments (no interactive prompts):

npm run test:ci

For quick development testing:

npm run test:manual

For quick start during development:

npm run test:quick