Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
This branch is 62 commits behind tito:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
PyMT - A Multitouch Framework for Python


About 0.5

This is beta, so keep in mind that it might not work as intended at all times.
You can post bug reports and feature requests on our Google Project page :

If you need more help, you can discuss on mailing list :

  * Google Group :
  * Email        :

We also have an IRC channel :

  * Server  :
  * Channel : #pymt


PyMT is a python module for developing multi-touch enabled media rich
applications. Currently the aim is to allow for quick and easy interaction
design and rapid prototype development.

PyMT is written in python, based on OpenGL and supports different input methods
like Mouse, Dual Mouse, TUIO, WiiMote, WM_TOUCH, HIDtouch etc.

PyMT is actively being developed by a community and free to use. It operates on
all major platforms (Linux, OSX, Windows).


Depending on your operating system you can follow one of the following guides
to install PyMT and the dependencies:


If you chose to install all the dependencies (see below) yourself, you can invoke
the setup script as follows to install pymt systemwide for python:

  python install


Since we abstract from the libraries that we use, some dependencies are
optional and may be used instead of others. A list of dependencies and what
we use them for is

Here is what works best:

  * python (>= 2.6, < 3.0) -
  * PyOpenGL >= 3.0.1
  * Pygame
  * PIL
  * GST + PyGST
  * Cython

Dcoumentation, Examples & Tutorials

There is an API reference included in doc. Check the doc/README about how
to build the documentation. It's also available online at :

There is some simple example apps in the examples folder that should get
you started for now. Additionally you may want to take a look at our wiki
at :



  # show/hide fps
  show_fps = (0|1)

  # set log level
  log_level = (debug|info|warning|error|critical)

  # detection time of double tap (in milliseconds)
  double_tap_time = <integer>

  # max distance allowed for double tap (normalized in range 0 - 1000)
  double_tap_distance = <integer>

  # detection time of retain touch (in milliseconds)
  retain_time = <integer>

  # max distance allowed for retain touch (normalized in range 0 - 1000)
  retain_distance = <integer>

  # max distance to detect jittering (normalized in range 0 - 1000)
  jitter_distance = <integer>

  # list of device to ignore jittering
  jitter_ignore_devices = <devicename>,...

  # log directory
  log_dir = <string>

  # log name (can use format string from strftime)
  log_name = <string>

  # activate logging on file
  log_enable = (0|1)

  # GL error check (disable to have more speed)
  gl_error_check = (0|1)

  # ignore list
  ignore = [(xmin, ymin, xmax, ymax), ...]

  # INTERNAL, NEVER TOUCH TO config_version !!
  config_version = <integer>


  # default layout of keyboard
  layout = (azerty|qwerty)


  # activate fullscreen
  fullscreen = (0|1)

  # width of window
  width = <integer>

  # height of window
  height = <integer>

  # force vsync
  vsync = (0|1)

  # force fbo type
  fbo = (hardware|software|force-hardware)

  # opengl line smooth
  line_smooth = (0|1)

  # show cursor on fullscreen
  show_cursor = (0|1)


  # example of input provider instance
  yourid = providerid,parameters

  # example for tuio provider
  default = tuio,
  mytable = tuio,


  # activate record of frames
  enabled = (0|1)

  # prefix to use for dump
  prefix = <string>

  # format of dump image
  format = <jpeg|png>


  # mtlist control

  # maximum distance to trigger down/up on child (pixels)
  list_trigger_distance = <int>

  # friction (factor, 1 = no friction)
  list_friction = <int>

  # friction when a bound have been hit
  list_friction_bound = <int>

  # keyboard type
  keyboard_type = <real|virtual>


  # modulename= to activate a module
  # you can have a list of module with :
  # python -m list
  # example:

Other python/MT resources

Another image tracker we are working on.

THE resource and research community for open source multi touch and other
natural user interfaces.


A multitouch python framework







No packages published