Connect HomeKit + OSC
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Processing Kontrol 1.0.2 beta demo Nov 30, 2015
README.md Kontrol 1.0.2 beta demo Nov 30, 2015

README.md

Kontrol for HomeKit + OSC

Add-ons and examples for connecting to HomeKit via OSC.


Theaters, artists, musicians, education - from professionals to amateurs. Kontrol enables an easy and accessible way to create interactive lightning experiences.



Hookup apps like VDMX, QLab, Max MSP, Super Collider, Ableton Live etc. to Kontrol for HomeKit.

Control light installations easily in realtime via Processing, openFrameworks, VVVV, Puredata, Arduino, Raspberry pi etc. without having to take care of all the technics behind.


Take full control of any HomeKit compatible lights within minutes.


www.kontrol-app.com



How to send a command?


All lights:
/lights/power 						(0/1 int)
/lights/brightness 					(0-1 float)
/lights/hue 						(0-1 float)
/lights/saturation 					(0-1 float)

Single light:

/lights/LIGHT_NAME/power 			(0/1 int)
/lights/LIGHT_NAME/brightness 		(0-1 float)
/lights/LIGHT_NAME/hue 				(0-1 float)
/lights/LIGHT_NAME/saturation 		(0-1 float)

Outlets:

/outlets/OUTLET_NAME/power 			(0/1 int)

Scenes:

/scenes 							(SCENE_NAME String)


Setup


###1. Download the iOS app In order to control HomeKit devices via OSC you'll need the official Kontrol for HomeKit app, found in the AppStore:

https://itunes.apple.com/us/app/kontrol-for-homekit

Please note: OSC support requires the 1.0.2 version currently only available for beta testers.
Join the beta group on our website: www.kontrol-app.com

###2. Get the IP

Launch the iOS settings.app and navigate to Kontrol. Activate the OSC server and launch Kontrol. Once the server is running you will see the IP of your iOS device in the settings.

###3. Launch the app

Since HomeKit doesn't work in the background and is only available on iOS + watchOS Kontrol for HomeKit has to be running in the foreground while you use it.


Examples


Download the Processing examples to see how you can quickly program your HomeKit lights.

Setup:

KONTROL_APP = new Kontrol();
KONTROL_APP.setup("192.168.0.5", 9999);

Draw:
// SINUS WAVE 0-1

float hue = (sin((float(frameCount)*.001))+1)/2;
  
// WITH 60 FPS DON'T SEND TOO MANY COMMANDS:

if (frameCount % 15 == 1) {
	KONTROL_APP.send("/lights/hue", hue);
}