Room Light Control is a Home Assistant integration designed to automatically control the lights in a specific room of your house. Using a combination of sensors and logic, the automation creates a natural and convenient experience when you enter and exit the room.

• Automatic Light Control: Lights in a room are automatically discovered and controlled without any additional configuration. The integration uses the lights assigned to a room (a.k.a area) to seamlessly manage turning them on and off based on motion or presence sensors.
• Simplified Setup: No need to manually configure individual lights — just assign your lights to a room in Home Assistant, and Room Light Control takes care of the rest.
• Scene or Script Activation: Optionally, specify a scene or script to activate for more complex lighting setups. When configured, these scenes or scripts can define exactly how the lights turn on, providing full control over the lighting atmosphere.
• Human Presence Detection: Supports advanced sensors like the Aqara FP1 (mmWave sensors) to detect human presence and control lights accordingly.
• Automatic Lights-Off Logic: Lights turn off based on a timer after no motion is detected, or by using occupancy sensors. The timer resets if motion is detected again.
• Illuminance-Based Lighting: Optionally use an illuminance sensor to only turn on the lights when the natural light level is below a defined threshold.
• Manual Interference Handling: Automatically pauses auto-control if manual actions are detected, WHEN
  • ... lights are already on
  • ... a scene is activated while auto-control is running (e.g. Philips Hue Scene turned on with your Smartphone)
• Automatic Blocking Timeout: Optionally configure how long manual overrides or blocking entities can hold control before Room Light Control turns the lights off and resumes automation. Defaults to 3 hours of inactivity.
• Turn-Off Blocking Entities: Configure entities that, when active, prevent the lights from being turned off (e.g., if a specific device is running or a condition is met).
• Flexible Configuration for Advanced Users: Advanced users can define custom scripts or scenes for more tailored lighting behaviors, while simple setups can rely on automatic light discovery and control.

1. Make sure HACS is installed in your Home Assistant instance.
2. In Home Assistant, open HACS → Integrations, select the three-dot menu, and choose Custom repositories.
3. Add the URL of this repository (for example, https://github.com/valem/room-light-control) and select Integration as the category.
4. After the repository has been added, search for Room Light Control inside HACS and install the integration.
5. Restart Home Assistant to load the newly installed integration.

To install Room Light Control manually, simply copy all files from the room_light_control directory to your Home Assistant's /custom_components/room_light_control directory, using the Raw button to ensure proper formatting. Then, restart Home Assistant.

Configuring Room Light Control is straightforward thanks to its auto-discovery feature that detects lights based on a room or area.

To enable this integration, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
room_light_control:

• An area, which represents your room (e.g. office)
• One motion sensor
• Lights assigned to the area

Important: This integration is built all around rooms, so first you need to configure an area for each of your rooms and assign the lights and sensors to the corresponding area.

Example Configurations:

a) Minimum Configuration - The lights will turn on when motion is detected and will turn off after 3 minutes (default) of no motion.

- office_light_control:
    room: office
    motion_sensor: binary_sensor.office_motion_sensor

b) Using a Scene or Script to Turn On Lights - You can either use a scene or a script to turn on the lights when motion is detected.

- floor_light_control:
    room: floor
    motion_sensor: binary_sensor.floor_motion_sensor
    activate_light_script_or_scene: scene.floor_bright
    turn_off_delay: 30    

c) Multiple Motion Sensors and Illuminance Sensor - Use multiple motion sensors to trigger the light. An illuminance sensor can prevent the lights from turning on when there is enough natural light in the room.

- bedroom_light_control:
    room: bedroom
    motion_sensor: 
      - binary_sensor.bedroom_left_motion_sensor
      - binary_sensor.bedroom_right_motion_sensor
    illuminance_sensor: sensor.bedroom_light_level
    illuminance_sensor_threshold: 5
    activate_light_script_or_scene: script.bedroom_activate_light
    turn_off_delay: 90

d) Multiple Rooms Support - This configuration enables automatic light control in a combined living area that includes a kitchen.

- living_light_control:
    room: 
      - livingroom
      - kitchen
    motion_sensor: 
      - binary_sensor.living_room_motion_sensor
      - binary_sensor.kitchen_motion_sensor
    illuminance_sensor: sensor.livingroom_light_level
    illuminance_sensor_threshold: 5.0            
    activate_light_script_or_scene: scene.living_area_default
    turn_off_delay: 120           

e) Using a Human Presence Sensor (Aqara FP1) - The lights will turn on when motion is detected and will turn off when a human presence sensor like the Aqara FP1 detects that the person has left the room. This is an alternative to using a timer to turn off the lights.

- bath_light_control:
    room: bath
    motion_sensor:
      - binary_sensor.bath_ground_motion_sensor # PIR motion sensor
      - binary_sensor.bath_occupancy # mmwave motion sensor
    turn_off_sensor:
      - binary_sensor.bath_occupancy # mmwave motion sensor
    activate_light_script_or_scene: script.bath_activate_light

f) Automatic Timeout for Manual Overrides - When lights are turned on manually or blocked by an entity, Room Light Control will resume automation after no motion is detected for the configured timeout. If omitted, the timeout defaults to 3 hours. Setting the timeout to 0 disables the auto-clear behavior.

- hobby_room_light_control:
    room: hobby_room
    motion_sensor:
      - binary_sensor.hobby_room_motion
    turn_off_blocking_entity:
      - input_boolean.hobby_room_manual_hold
    blocking_entities_timeout: 600  # 10 minutes after motion stops

If you encounter issues with Room Light Control, here are some steps and tools to help you troubleshoot and resolve them:

You find all relevant attributes under Developer Tools->States. Here you can also see which lights have been dynamically scanned.

The state of RLC transitions as follows:

To get detailed logs from your Room Light Control integration, you can increase the logging level in Home Assistant. Add the following to your configuration.yaml file under the logger component:

logger:
  default: warning
  logs:
    custom_components.room_light_control: debug

Please read CONTRIBUTING.md and the process for submitting issues.

Room Light Control is licensed under the GNU GENERAL PUBLIC LICENSE.

Special credits go to Daniel Mason, the creator of entity-controller from which I got inspired and used his code base as a starting point for this integration.