T-Code (OSR2 / SR6 / SSR1 / DIY)

Connect open-source DIY strokers that speak the T-Code protocol (OSR2, SR6, SSR1) to ToyControl over USB. Requires the ToyControl Helper.

T-Code is the language used by community DIY strokers: the OSR2, the SR6, the SSR1, and other community builds. They connect by USB cable, not Bluetooth, which is something a browser cannot do on its own. ToyControl needs the ToyControl Helper running to find them.

Before you start

Install the ToyControl Helper on your computer (see the next section). It is the system-tray app that bridges USB serial to the browser.
Plug the T-Code stroker into your computer by USB cable.
The Helper should show as running (a small icon in the system tray, and a green dot in the ToyControl sidebar's Helper chip).

Install the Helper

Download the Helper for your computer:
- macOS: ToyControl-Helper.dmg
- Windows: ToyControl-Helper.exe
- Linux: ToyControl-Helper.AppImage
(ToyControl also shows a Download Helper button when you add a T-Code device.)
Install it, then open it.
First launch: allowing the unsigned Helper. The Helper is not yet code-signed, so your computer warns that it is from an unidentified developer. This is expected and safe. To allow it, just once:
- macOS: in your Applications folder, right-click (or hold Control and click) ToyControl Helper and choose Open, then click Open again. On newer macOS, instead open the Apple menu > System Settings > Privacy & Security, scroll to Security, and click Open Anyway.
- Windows: if you see "Windows protected your PC", click More info, then Run anyway.
- Linux: make the AppImage executable (right-click > Properties > Permissions > allow executing, or chmod +x ToyControl-Helper.AppImage), then run it. For USB access you may also need to join the dialout group.

Full details are on the Helper app page.

Connect the stroker

Open ToyControl at toycontrol.app in Chrome or Edge.
Click the + in the Devices section.
Pick T-Code (OSR2 / SR6 / SSR1 / DIY) from the catalog.
ToyControl asks the Helper to list connected USB-serial devices. Pick yours from the list.
Click Connect.
The stroker appears in the sidebar with a green dot.

Test it

Click Test toy at the bottom. The stroker should run a short pattern. Make sure the toy is mounted safely before testing; T-Code strokers move with real force.

Notes by model

OSR2 is the most common community stroker: the main stroke plus a twist (rotation) axis, with the OSR2+ adding roll and pitch for up to four axes. For a full OSR2 walkthrough, including per-axis range controls and multi-axis scripts, see connecting and configuring the OSR2.
SR6 is a six-axis successor; the extra axes (rotation, pitch, yaw) are exposed where the script provides them. For a full SR6 walkthrough, including per-axis range controls and multi-axis scripts, see connecting and configuring the SR6.
SSR1 is a single-axis belt-driven stroker built around a gimbal brushless motor. It is much quieter than the OSR family.

Troubleshooting

No devices listed. The Helper must be running. Check the Helper chip in the ToyControl sidebar.
The stroker is listed but won't connect. Try a different USB port or a different USB cable (some are charge-only).
Motion is jerky. T-Code's motion smoothness depends on script quality and firmware tuning. Try slower scripts or Patterns to compare.