![](\"homebridge-hue.png\")
\n\n \n
![](\"demo.gif\")
\n\n## Features\n\n- Natural Bell Curve Color Temperature Transitions\n- Smooth, Gradual Changes: The plugin now uses a cosine function to create a smooth, bell-shaped curve for color temperature transitions throughout the day.\n- Enhanced Natural Lighting: Mimics the natural progression of daylight, providing a more comfortable and realistic lighting environment.\n- Automatic color temperature adjustment based on time of day\n- Customizable warm and cool temperature ranges\n- Geolocation-based calculations for accurate sunlight mimicking\n- Manual override option with automatic mode switch\n- Exclude specific lights from automatic adjustments\n- Smart retry mechanism for reliable updates\n\n## Auto Mode and Manual Adjustments\n\n- **Auto Mode**: Automatically adjusts your lights' color temperature based on the time of day. Enabled by default.\n- **Manual Adjustments**: Changing the brightness slider or color temperature in the Home app will disable Auto Mode, allowing you to set your preferred lighting.\n- **Re-Enabling Auto Mode**: To resume automatic adjustments, simply toggle the \"Auto Mode\" switch back on in the Home app.\n- **Excluded Lights**: Specify lights that should never be automatically adjusted, perfect for accent lighting or areas where you want consistent color temperature.\n\n## Prerequisites\n\n- [Homebridge](https://homebridge.io/) installed on your system\n- Philips Hue Bridge with API access - [Hue Guide](https://developers.meethue.com/develop/hue-api-v2/getting-started/#follow-3-easy-steps)\n- Philips Hue color temperature capable lights\n\n## Installation\n\n1. Install the plugin through Homebridge UI or manually:\n\n```bash\nnpm install -g homebridge-hue-daylight-sync\n```\n\n2. Configure the plugin in your Homebridge `config.json` or through the Homebridge UI.\n\n## Configuration\n\nAdd the following to your Homebridge `config.json` file:\n\n```json\n{\n \"platforms\": [\n {\n \"platform\": \"HueDaylightSync\",\n \"name\": \"Hue Daylight Sync\",\n \"bridgeIp\": \"YOUR_HUE_BRIDGE_IP\",\n \"apiToken\": \"YOUR_HUE_API_TOKEN\",\n \"latitude\": 51.5072, // Replace with your latitude\n \"longitude\": 0.1276, // Replace with your longitude\n \"warmTemp\": 2700,\n \"coolTemp\": 3000,\n \"curveExponent\": 3,\n \"updateInterval\": 300000,\n \"inputDebounceDelay\": 750,\n \"defaultAutoMode\": true,\n \"excludedLights\": [] // Array of light IDs to exclude from auto adjustments\n }\n ]\n}\n```\n\n### Configuration Options\n\n| Option | Type | Description | Default |\n|--------|------|-------------|---------|\n| `bridgeIp` | `string` | The IP address of your Hue Bridge | Required |\n| `apiToken` | `string` | Your Hue API token | Required |\n| `latitude` | `number` | Your geographical decimal degrees latitude. Example: 51.5072 for London, but use your location's coordinates | Required |\n| `longitude` | `number` | Your geographical decimal degrees longitude. Example: 0.1276 for London, but use your location's coordinates | Required |\n| `warmTemp` | `number` | Warmest color temperature in Kelvin | 2700 |\n| `coolTemp` | `number` | Coolest color temperature in Kelvin | 3000 |\n| `curveExponent` | `number` | Adjusts the steepness of the transition curve | 3 |\n| `updateInterval` | `number` | Interval in milliseconds between temperature updates | 300000 (5 minutes) |\n| `inputDebounceDelay` | `number` | Delay in milliseconds to prevent rapid successive updates | 750 |\n| `defaultAutoMode` | `boolean` | Enable Auto Mode by default | true |\n| `excludedLights` | `string[]` | Array of light IDs to exclude from automatic adjustments | [] |\n\n**Note**: For `latitude` and `longitude`, you must enter the coordinates for your specific location. The values shown in the example are for London, UK - make sure to replace these with your own coordinates.\n\nYou can find your coordinates using online services like Google Maps or websites like https://www.latlong.net/\n\n### Excluding Lights\n\nTo exclude specific lights from automatic adjustments:\n\n1. Find the light ID from your Hue Bridge (using the Hue API or developer tools)\n2. Add the light ID to the `excludedLights` array in your config\n3. Excluded lights will maintain their manual settings and won't be affected by the daylight sync\n\nExample configuration with excluded lights:\n```json\n{\n \"excludedLights\": [\"light1\", \"light2\"]\n}\n```\n\n## Usage\n\nOnce installed and configured, the plugin will appear in your Home app as a light accessory with an additional switch for the Auto Mode.\n\n- Toggle the main switch to turn the Daylight Sync on or off.\n- Use the brightness slider to manually adjust the color temperature.\n- Toggle the Auto Mode switch to enable or disable automatic temperature adjustments.\n- Excluded lights will maintain their manual settings regardless of Auto Mode status.\n\nWhen Auto Mode is enabled, the plugin will automatically adjust your Hue lights' color temperature throughout the day to match natural daylight patterns.\n\n## Troubleshooting\n\nIf you encounter any issues:\n\n1. Check your Homebridge logs for any error messages.\n2. Ensure your Hue Bridge IP and API token are correct.\n3. Verify that your latitude and longitude are set correctly.\n4. Make sure your Hue lights support color temperature adjustments.\n5. Verify that excluded light IDs are correct if using that feature.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License.\n\n## Acknowledgements\n\n- [Homebridge](https://homebridge.io/) for making this integration possible.\n- [Philips Hue](https://www.philips-hue.com/) for their smart lighting system and API.","readmeFilename":"README.md"}