This python script allows you to integrate your Philips Hue smart lighting system with your Loxone system. By running this script, events in the Hue system are forwarded to the Loxone Miniserver in the form of UDP packets. The signal-flow is like this:

graph LR
    A[Hue Accessory] --> B[Hue Bridge]
    B --> C[✨Philips Hue to Loxone Bridge✨]
    C --> D[Loxone Miniserver]

The bridge is designed to parse the following events. (If you are missing an event type, hit me up and we'll see if i can add it 😎)

Each event is sent to the Loxone Miniserver as a UDP packet in the format hue_event/{item_type}/{item_id}/{item_state}. Every Hue item has a unique id. If an item can have multiple different event types, then a unique id for every event type is generated.

To make it easier for you to assign the id to a specific item, the python script prints all names and id's during startup.

This guide assumes that you have git and python 3 installed on you system. If true, continue with these steps:

1. Clone this repository.

   git clone https://github.com/marcelschreiner/hue-to-loxone.git

2. Install the required dependencies (python libraries) with pip. pip3 is traditionally used on Raspberry Pis to install libraries for Python 3 other systems may use pip.

   pip3 install requests
   pip3 install aiohue

3. Generate a Philips Hue API key, to access you Hue bridge. To do this configure the IP of you Hue bridge in get_api_key.py. Then execute the script, it will guide you through the process.

   python3 get_api_key.py

4. Modify the configuration variables in the hue2lox.py script as described in the Configuration section.

5. Run the Philips Hue to Loxone bridge using the following command:

   python3 hue2lox.py

6. OPTIONAL: (Example for Raspberry Pi) If you want the python script to automatically start if your system starts, open rc.local

   sudo nano /etc/rc.local

   Then add the path to the hue2lox.py script:

   ...
   python3 /home/pi/hue2lox.py &
   exit 0
   

Open the script and modify the following variables to match your setup:

• HUE_IP: Set this to the IP address of your Philips Hue bridge.
• HUE_API_KEY: Set this to your Hue bridge's API key.
• LOXONE_IP: Set this to the IP address of your Loxone Miniserver.
• LOXONE_UDP_PORT: Set this to the UDP port your Loxone Miniserver is configured to listening on.
  
  

To integrate the Philips Hue events with your Loxone Miniserver, you need to configure a virtual UDP input in the Loxone Config. Follow the steps below:

1. Open the Loxone Config and connect to your Miniserver.

2. Navigate to the Periphery tree in the structure view.

3. Right-click on the Virtual Inputs and select Add Virtual UDP Input.

4. In the properties of the newly created Virtual UDP Input, set the UDP Command to for exaple hue_event/sensors/42/\v.
   
   

Released under the MIT License, this code is yours to command! 🚀 Modify it, tweak it, use it to your heart's content. Let's create something amazing together! 💻🌟