How to Set Up Multi-seat Touchscreens

From Userful Support
Jump to: navigation, search

This page contains documentation for an outdated product, Userful Multiplier.

Newer versions of this software are called Userful MultiSeat.

See documentation for Userful MultiSeat: There is no equivalent Userful MultiSeat documentation. Instead, please refer to Userful MultiSeat General Documentation

Copyright © 2007-2015 Userful Corporation. All rights reserved.
(Updated 2015.09.28)

Note: Touchscreen support has not yet been added to the latest Userful Multiplier release. The instructions below refer only to Userful Multiplier v320 or older.

If you require touchscreen support for a more recent version of Userful Multiplier please contact us with a description of your project and your needs, and we will do our best to accomodate.


This document describes how to setup and run multiple touchscreen stations from a single Linux computer using Userful's multi-seat Linux software.

Supported TouchScreen Devices

Userful supports a limited number of touchscreen devices. However, even if your touchscreen device is not on this list, it may still work.

The supported touchscreen devices include:

  • MicroTouch (3M) USB TouchScreen
    • Vendor ID: 0x0596, Product ID: 0x0001
  • Elo TouchSystems TouchScreen
    • Vendor ID: 0x04e7, Product ID: 0x0020
    • Vendor ID: 0x04e7, Product ID: 0x0050

Note: If your device is not on the list, connect your device and run the lsusb or lsusb -v command to determine the vendor and product ID of your USB touchscreen. Then try editing the config file /etc/X11/userful.Mxorg.conf to add the information on your device.


To successfully calibrate your touchscreen devices for use with Userful Multiplier™, all touchscreens must be connected to the computer and powered on before installation of the Multiplier software.

  • If a previous installation of Userful Multiplier™ was running without touchscreens, you will first need to re-create your configuration file. To do this simply delete /etc/X11/userful.Mxorg.conf then reboot your system.
  • The touchscreen calibration wizard assumes all touchscreens connected to the computer are of the same make and model.
  • If touchscreens will not be used for all stations, make sure that a touchscreen is connected to the first video head. The touchscreen calibration tool will use the touchscreen connected to the first video head as the basis for configuring all other touchscreens connected to the computer.
    • On the first boot after installing Userful Multiplier™, you will be prompted to press F1 on the first video head to start the calibration procedure. Only an "X" icon is displayed on the other heads.

When you are prompted to, press the F1 key on your keyboard and touch the screen connected to the first head. This will link the keyboard and touch-screen to the first video head.

Step 1 of 3: Calibrate Screen Size

To calibrate the size of your touchscreen, drag your finger around the outermost edges of the touchscreen.

Keep dragging your finger around the edges of the screen until the "Min" and "Max" value on the screen stop changing.

Step 2 of 3: Align Touch Points

This step fine-tunes the touchscreen. Touch the red square as it appears in each of the 9 key points on the screen.

Step 3 of 3: Verify Calibration

This step verifies the current calibration. Touch the screen and drag your finger to confirm that the pointer follows your finger.

  • Press Y on your keyboard to accept current calibration, or
  • Press N if the cursor does not follow your finger.

Horizontal (X-axis) Test (Optional)

Drag your finger horizontally across the screen.

  • Press Y on your keyboard if the pointer follows your finger, or
  • Press N to flip the X-axis.

Vertical (Y-axis) Test (Optional)

Drag your finger vertically up and down the screen.

  • Press Y on your keyboard if the pointer follows your finger, or
  • Press N to flip the Y-axis.

This concludes the touch-screen calibration process. If you wish to recalibrate the touchscreens at a later date, you may do so by deleting the /etc/X11/userful.Mxorg.conf file.