Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
An OSC remote control for Android devices
Java
branch: master
Failed to load latest commit information.
code now displaying local IP
data fixes allover
sign&export
AndroidManifest.xml
Kontrolleur.pde set ports default to 44444
Menu.pde set ports default to 44444
MultiTouch.pde
Networking.pde now using alternative way to retrieve local IP
README.md fixes to the markdown syntax
RemoteValue.pde fixes all over
Sensors.pde fixes all over
Settings.pde added signation stuff..
icon-36.png init
icon-48.png init
icon-512.png added signation stuff..
icon-72.png init
oscP5.jar
screenshot-1.jpg added signation stuff..
screenshot-2.jpg added signation stuff..
screenshot-2.png added signation stuff..
sketch.properties set ports default to 44444

README.md

Kontrolleur is a proof of concept open source general purpose remote controlling app for Android written in Processing. It displays (using simple autolayout) interface elements (slider, button,...) that are being pushed to it via OSC by the target application and sends back values to given OSC addresses on the target application.

Its main idea is ease of use by not requiring you to create an interface layout manually and assign its values to parameters in your target application. Instead the target application can expose specific interface elements on the fly without any further manual assignment needed by the user.

Additionally Kontrolleur can display the current value of a parameter as set by the target application and it can send multiple touches and sensors (accelerometer, orientation, magnetic field) directly to the target application.

While conceived for plug and play compatibility with vvvv it can be easily adopted by any software capable of sending and receiving OSC.

A demo-video is here: http://vimeo.com/22041214

Usage

Starting Kontrolleur on your phone for the first time prompts you with the menu. There you can set the IP Address and Port of your target application. The IP defaults to a broadcast IP on your current subnet which should be fine for a start. P ressing the Save button saves those settings and starts the network connection. Next time you start Kontrolleur those settings are loaded and used. To change settings use the Menu button on your phone at any time to bring up the menu again.

From the target application you can now send OSC messages in the following format to create interface elements:

  • /k/add sssfffff
  • /k/update sssfffff
  • /k/remove s

where the typetags have to be used as follows:

  • s: OSC address on target application
  • s: parameter name
  • s: parameter type (accepts: Slider, Endless, Toggle, Bang)
  • f: default value for parameter (can be reset to via two button click on parameter)
  • f: minimum
  • f: maximum
  • f: stepsize
  • f: current value of parameter

Pressing the Save button in the menu sends an OSC message to the target application in the form of:

  • /k/init siii where the typetags deliver the following data:
  • s: device IP
  • i: device Port
  • i: width of device pixels
  • i: height of device pixels

The target application is supposed to use IP and Port to communicate back to the device and use width and height to map the touch data to a range preferred by the application.

When activated in the menu Kontrolleur will send touches and sensors on the following OSC addresses:

  • /touch ifff.... (touch ID, x, y, pressure)
  • /orientation fff
  • /acceleration fff
  • /magnetism fff

Credits

* Daniel Sauter et al for the ketai sensor library

Looking forward to Control for Android, which hopefully makes Kontrolleur obsolete...

Something went wrong with that request. Please try again.