∿ playtronica / help

👐TouchMe — the touch-to-MIDI instrument

A small instrument that turns touch into music. Play alone, with a friend, or on water and flowers.


TouchMe top view, labelled — gold conductive pads on both sides, status LED in the middle, USB-C at the bottom

TouchMe is a small instrument with two gold pads. It turns skin, water, or flowers into sound. Touch both pads with bare skin and a note plays. The device measures the conductivity of whatever connects the two pads — your fingers, two people's hands, a glass of water, a wet leaf. A larger contact area produces a louder, brighter sound.

TouchMe is designed for shared play. The most surprising moment is when two people each hold one pad and touch each other — the circuit completes through both bodies, and the touch between them plays the music.

⚠️ Handle only the parts shown in this guide. Touch the gold conductive pads, the USB-C connector, and the electrode-patch clip points. Do not touch the narrow PCB bridge — it carries the microcontroller and surface-mount components. Even when the device is unplugged, do not touch solder joints, exposed chips, or the underside of the PCB. TouchMe is durable, but those areas can be damaged permanently.

⚠️ Not waterproof. Do not use with pacemakers. TouchMe is safe at USB voltage but the device should not be submerged, and people with pacemakers or other implanted medical devices should not use it as a precaution.

🛠️ Want to go deeper? When you are past the basics, see the TouchMe deep dive for MIDI mapping, custom scales, hardware tuning, and performance tips. The tuning page covers scale presets.

The two-person demo — the moment that defines TouchMe

This is the demonstration we run at every workshop. It is the simplest way to understand what TouchMe is.

  1. Two people stand next to TouchMe.
  2. Person A holds one gold pad with one hand. Bare skin.
  3. Person B holds the other gold pad with one hand. Bare skin.
  4. The two people touch each other — palm to palm, fingertip to forearm, anywhere bare skin meets bare skin. A note plays.
  5. The touch between the two people becomes the instrument. A high-five plays a short note. A long handshake plays a sustained note. A hug plays a chord.

The music does not come from the device. The music comes from the connection between two people. TouchMe makes it audible.

Three ways to play

Alone. Hold both pads with bare skin — one hand on each pad. A note plays as long as the circuit is complete. Move your fingers across the pads to change the volume and brightness.

With a friend. The two-person demo above. The most common workshop demonstration.

With objects. Clip an alligator wire from one of the pads to anything that conducts a small amount of electricity — a piece of fruit, a glass of water, a wet leaf, aluminium foil, a damp piece of paper. Touch the clipped object and the other pad simultaneously. The object becomes a key. See Objects you can play for the full list.

Quick start — first sound in 2 minutes

  1. Plug TouchMe into your computer with the USB cable from the box. No drivers are required on Mac or Windows. If your computer has only USB-A ports, see Adapters.
  2. Open synth.playtronica.com in Brave or Chrome. Safari and Firefox do not support Web MIDI. Open the browser after plugging in the device so the browser detects it on page load.
  3. Choose a synth. Avoid synths marked "Playtron only" (such as WebSID Commodore 64). The default Dots Piano is the most reliable starting point.
  4. Hold both gold pads with bare skin. A note plays. Try the two-person demo above.

What is in the box

  • TouchMe device
  • USB cable
  • 2 alligator clips — for connecting to objects beyond your skin
  • Storage envelope

Update the firmware

Update the firmware once per quarter, or when we ship a new release.

  1. Open settings.playtronica.com/#/touchme in Brave or Chrome.
  2. Click "Update Firmware". If a drive called RPI-RP2 appears on your computer, skip to step 4.
  3. Follow the on-screen instructions to put TouchMe into update mode.
  4. Upload the latest firmware. The device reboots automatically.

Reset TouchMe (factory wipe)

Use the reset only if the firmware update will not start, or after a hardware fault.

  1. Short the BOOT pins. Connect the two small BOOT contacts on the PCB with tweezers, a paper clip, or a jumper wire.
  2. Plug in USB-C with the BOOT pins still shorted.
  3. Wait for the RPI-RP2 drive to appear on your computer, then release the pins. The window is brief. If the drive does not appear, try again.
  4. Drag flash_nuke.uf2 onto the RPI-RP2 drive. Wait for the device to reboot.
  5. Open settings.playtronica.com/#/touchme and upload the latest firmware.

Test the MIDI signal with a monitor

A MIDI monitor shows whether TouchMe is sending any signal. Use it when you cannot tell whether the device or the synth is the problem.

Compatible monitors:

Steps:

  1. Plug in TouchMe first, then open MorningStar in Brave or Chrome. The browser scans for MIDI devices when the page loads. If you open the browser first, the device will not appear.
  2. Touch both pads and watch for messages on screen. You should see message type Note On and Note Off, a MIDI channel, a note number, and velocity 127. If messages appear, TouchMe is working. The problem is in your synth or browser.
  3. If TouchMe does not appear in the device list, close Brave or Chrome completely. Wait 5 seconds. Reopen the browser, reload MorningStar, and click the "Devices" button in the top right.
  4. If the device is listed but no messages appear, open Settings in MorningStar and confirm "Note On" is enabled. TouchMe sends only Note On and Note Off.
  5. If still no messages, try another computer. If no messages appear on any computer with any cable, the device is likely faulty. Email support@playtronica.com with the subject Defective #[order number].

Ask the community

🤝 Other Playtronica users have probably hit this before. The Playtronica Friends Facebook group has 4,400 members and is the fastest source of creative and technical help. Search the group's history first (use the magnifying glass at the top — try playtron mobile no sound, all leds lit, touchme biotron no sound, koala sampler midi, or whatever fits your problem). If your question is not already answered, post a new one with a [Device] prefix in the title. See the community page for what to ask there and what to email instead.

Still stuck

Email support@playtronica.com. We aim for 24 hours, but a reply may take up to 3 business days.

Related
Did this answer your question?
Your Device / TouchMe — the touch-to-MIDI instrumentEdit this page on GitHub →