Configuration / Settings

All the TUIO settings are held in the UPDD Settings file and can be adjusted with the TUIO setting dialog or using the UPDD command line utility.

Given that TUIO servers communicates using UDP then the only TUIO specific configuration necessary for the TUIO server is the IP address, port number and message packet size. Since most usage cases for a TUIO server is to have it running locally on the same computer that the TUIO client programs are running on, a reasonable default configuration is for it to use localhost with the default TUIO IP address (, port number (3333) and packet size.

The UPDD TUIO Server utility accepts command line arguments to override the TUIO settings and define settings for the current TUIO session only (the setting file entries stay intact):


bind-address (Specify bind-address)


port (Specify port)

If either of the above arguments are missing the information is retrieved from tbupdd.ini if found otherwise uses defaults.

-i or --no-icon

option to run without an icon (i.e. as a daemon). – Linux and Mac only

-I or --force-icon

Force UPDD TUIO to have a system tray / menu bar icon

-h or –help

help (Displays usage text)


Mouse Emulation settings

With this version UPDD mouse emulation is on by default. This option can be used to enable / disable mouse emulation. 0 = off/disabled, 1 = on/enabled.

-n or


If Mouse Emulation is enabled all applications will receive mouse emulation clicks. Applications receiving touches via TUIO interface may not want to also receive mouse emulation clicks and this option is used to specify one or more process names that should not receive mouse emulation clicks.Whenever a process matching one of the names is ‘front most’ mouse emulation will be automatically disabled.

It's not case sensitive and under Windows it's not necessary to include the ".exe". Executables with spaces in their name should be enclosed in quotes.

Windows example: To run UPDD TUIO server with mouse emulation off in both QtTuioPaintDemo.exe and an executable named Touch App.exe, you would invoke the service with the command line:UPDD TUIO.exe -n QtTuioPaintDemo "Touch App"

Once a window from either of those apps becomes ‘front most’, mouse emulation will automatically turn itself off, regardless of the setting in the system tray menu.Switching to a different process will reset mouse emulation to the menu setting.

-r or --use-updd-rate

TUIO timestamp options

The TUIO server now timestamps TUIO frames. By default this is as close as possible to 60 frames per second as per the TUIO specification. This setting can be used to transmit the frames at the same rate they are received from the driver albeit this does not conform to the TUIO specification: 0 or off = 60 FPS, 1 or on = UPDD driver rate. Any application written to retrieve frame times should now receive valid timestamps. E.g. API call.

In our tests we achieved a TUIO data rate up to about 200 packets per second, although this speed will vary depending on hardware in use.

If UPDD TUIO is invoked under Mac OS X as a start up item and there is a requirement to invoke with a parameter then ordinarily there's no way to add arguments to OS X login items, but there is a way that it can be achieved, albeit in a roundabout fashion. The idea is to make an AppleScript to launch UPDD TUIO with the parameter, such as no menu bar icon, and then make the AppleScript a login item instead of UPDD TUIO itself. Here are some instructions:

1. In UPDD TUIO's settings dialog, turn off "Run UPDD TUIO at login"

2. Open Script

3. Copy/paste the following into a new script document, editing the path to UPDD as necessary:

do shell script "'/Applications/Utilities/UPDD TUIO' -i > /dev/null 2>&1 &"

Note that is only one line of code, just in case email formatting makes it look like two.

4. Save the AppleScript document

5. Open System Preferences > Users & Groups > Login Items

6. Add the AppleScript document to the list of login items