How-To Guides

Every feature, explained step by step — ordered from most to least important. Screenshots are from the real app with the key spots circled.

Jump to a guide

  1. Getting Started
  2. First-Run Tutorial
  3. Active Sources
  4. Find Source (Auto)
  5. Adding Custom Sources
  6. Predictive Movement
  7. Calibrate Delay
  8. Motor Kick-Start
  9. Multi-Toy Support
  10. Troubleshooter
  11. Boost
  12. Deadzone Limits
  13. Jitter Filter
  14. Endpoint Snap
  15. Invert
  16. Character Profiles
  17. Macro Switch
  18. Preset Strokes
  19. Activated Source Switch
  20. Debug Log & Filters
  21. Export OSC Session Log
  22. Hide, Show & Reorder Pages
  23. Settings
  24. License & Devices
Start Here

Getting Started

From purchase to a moving toy in a few minutes. OSCGetsHandy runs on Windows 10 / 11.

OSCGetsHandy with the Start button and the Connected status circled in red
Press Start, then wait for the status to say “Connected”.
  1. Purchase on Payhip — your license key arrives by email.
  2. Install and open Intiface Central, start its server, and make sure your toy shows as Connected inside it.
  3. Run OSCGetsHandy and enter your license key and the email you purchased with (see License & Devices).
  4. In VRChat: Action Menu → Options → OSC → Enabled.
  5. In OSCGetsHandy press Start. The status under the buttons should change to Connected — [your device].
  6. Pick the VRChat signal that moves your toy with Find Source (Auto), or just follow the first-run tutorial.
OSCGetsHandy advertises itself over OSCQuery, so VRChat finds it automatically — no manual port setup, and no clashes if you also run an app like VRCFT. If the status says No devices found, Intiface is open but your toy isn't connected inside it. Disconnected, retrying means the app can't reach Intiface — check that Intiface Central is open and its server is started. Still stuck? Use Help → Troubleshooter.
Closing the window asks whether to keep OSCGetsHandy running in the background (system tray). Don't run two copies at once — the app warns you if you try.
Start Here

First-Run Tutorial

A short guided walkthrough that opens the first time you launch the app: Welcome, Before You Start, Connect, Find Your Source, Jitter Filter, Predictive Movement and Motor Kick-Start.

The first step of the OSCGetsHandy tutorial, Welcome
The Find Your Source step of the tutorial listing the three built-in sources
  1. Follow the steps and press Next. Look for the [?] boxes if you want more detail.
  2. Use Skip Tutorial at any time to stop.
  3. Handy users can skip the toy-specific steps — The Handy works well with the default settings. Lovense and other toys continue through them.
  4. To play it again later: Help → Restart Tutorial.
Core

Active Sources

A source is a signal from your avatar that tells the toy how deep to go. VRChat sends lots of these all the time (they're called parameters) — here you choose which ones the toy follows.

Active Sources page with the Built-in card boxed and the Find source, Keywords buttons circled
Built-in sources on top, your custom sources underneath.
  1. Open Active Sources from the sidebar.
  2. Under Built-in, switch on what you want: All PenOthers (how deep your avatar is inside someone else), All TouchSelf (you touching your own avatar, e.g. with your hand) or All TouchOthers (someone else touching you).
  3. The number on the right of each row is its live value — 0.00 is nothing, 1.00 is fully in or fully touched. Watch it move to confirm the signal is arriving.
  4. Need another signal? Add a custom one — see Find Source (Auto) and Adding Custom Sources.
  5. Custom sources can be switched on/off with their toggle, dragged (or moved with ▲ ▼) to change priority, renamed with ✎ and removed with ✕.

Only one source at a time

It works best with only 1 source on. If several are on and more than one is active at the same moment, the toy follows only the one highest on the page: All PenOthers, then All TouchOthers, then All TouchSelf, then your custom sources from top to bottom. The Debug Log shows a “Now following” line when it switches.

The More than one source is on pop-up listing sources in priority order
A pop-up warns you when you press Start, or switch on another source, with several on.
Built-in sources work with any avatar, whatever its parts are named, so there's no setup. If two matching parts on one avatar are active at the same time, the newest signal wins and the toy can jitter — keep just one part active.
Core

Find Source (Auto)

Not sure which signal controls your toy? The app can find it for you — and it works with your headset on, because it talks to you with chimes.

Find Source (Auto) introduction with the wait slider and Start Test button circled
Turn your sound on and press Start Test.
Find Source (Auto) results listing three possible matches with the first Add button circled
Best matches first — click Add on the right one.
  1. Press Start in the main window and make sure OSC is on in VRChat — the app has to be running or nothing can be detected.
  2. Go to Active Sources and click Find source (auto).
  3. Turn your sound on. Use the Wait before the first chime slider to give yourself time to get into position, then press Start Test.
  4. 1st chime: hold still, with the source off. 2nd chime: turn your source on and keep touching it in a steady back-and-forth motion. 3rd chime: finished.
  5. The app lists the signals that moved only while you were touching, best match first. A ✓ keyword match means its name also looks like a depth signal — a good sign. Click Add next to the one that matches what you touched.
No clear match? Check the app is running and OSC is on; use a steady back-and-forth motion, not quick taps; try Longer touch (20s); and remember sources you've already added are hidden. If your avatar was just uploaded or changed, reset VRChat's OSC config (Action Menu → Options → OSC → Reset Config) and reload it.
Core

Adding Custom Sources

Four ways to add a signal that isn't one of the three built-in ones. All live on the Active Sources page.

Pick a Source to Add window with the first likely stroke signal circled
+ Sources list
All Avatar Parameters window with sort options and a ticked row circled
Parameter list
Add Manually window with the Wildcard option selected and an address typed in
+ Add manually
Keywords window showing Likely and Not Likely keyword lists
Keywords

+ Sources list

Click + Sources list. Signals are sorted into Likely Stroke, Likely Vibration and Not Likely. Click a row to add it. A likely vibration signal can be paired with Preset Strokes to make the Handy stroke whenever the avatar vibrates.

Parameter list

Click Parameter list to see every signal VRChat reports for your avatar, unfiltered, with live values. Sort by Moving first (the ones that react when you touch your avatar) or A to Z. A tick means it's already one of your sources — click any row to add it.

+ Add manually

If you know a signal's exact name (copied from the Debug Log, say), click + Add manually. Choose Source for that one exact signal, or Wildcard for a whole group of names — replace the part that changes with a star, e.g. OGB/Pen/*/TouchSelf matches TouchSelf on any avatar.

Keywords

The app guesses which signals are real depth signals from words in their names (like “Pen” or “Touch”). If your avatar uses other words, click Keywords and add your own to the Likely or Not Likely list. Built-in words can't be removed, and Check for New Keywords offers any added in an update without touching your own.

Missing a signal you expect? VRChat may have an out-of-date list. In VRChat open Action Menu → Options → OSC → Reset Config, then reload your avatar and press Refresh. Save List to File saves a list you can send to someone for help.
Recommended for Solace

Predictive Movement

Some toys, like the Lovense Solace, react a moment after they get a command. Predictive Movement learns the rhythm of your strokes and sends each move slightly early so the toy lines up with what you see.

Predictive Movement page with the Enabled switch, Send ahead by slider and Saved Presets circled
The small dot next to Enabled turns green while it is actively predicting.
  1. Open Predictive Movement and switch Enabled on.
  2. Set Send ahead by to roughly how late your toy reacts — measure it with Calibrate Delay, or tap a number on the Device Reference Sheet as a starting point. Too low and the toy still lags; too high and it moves before you do.
  3. Adjust Size tolerance and Speed tolerance only if it feels like it's fighting changes in your stroke. Higher adapts to your new movement faster; lower holds the old pattern longer and eases into changes.
  4. The first couple of strokes always pass straight through while it learns, and it works best with steady, repeating strokes. If you stop moving, it goes back to following you until it has learned your rhythm again.

Saved Presets

Under the sliders, press + Save current, name it (your toy's name works well) and it appears as a chip. Click the chip to load those settings again; ✎ renames it and ✕ deletes it. Handy when you swap between toys.

The Handy doesn't need this. It reacts fast, and leaving Predictive Movement on can make strokes shorter and jerkier. If a Handy connects while it's on, the app asks whether to turn it off.
The Predictive Movement is on pop-up with the Turn it off button circled
Recommended for Solace

Calibrate Delay

Measures how late your toy reacts and sets Send ahead by for you. It uses VRChat's Toggle Crouch, so you never need to click a button with a headset on. PC only for now — do it in PCVR or desktop mode first.

Calibrate delay card with the PC-only note, Start Calibration and Device Reference Sheet buttons circled
  1. In VRChat, set crouch to Toggle (the C key by default).
  2. Press Start in the main window and wait until your toy shows Connected. Turn Predictive Movement off while you calibrate.
  3. On the Predictive Movement page press Start Calibration. The toy goes to the bottom.
  4. In VRChat, press crouch. The app tells the toy to move.
  5. The moment you see or feel the toy move, press crouch again — which way it toggles doesn't matter.
  6. The toy goes back down. Repeat for 3 rounds in total. The average is applied to Send ahead by automatically.
Every unit is a little different, so measuring your own is always better than the Device Reference Sheet (a short list of delays other users have reported — click one to use it as a starting point).
Recommended for Solace

Motor Kick-Start

Some toys (like the Lovense Solace) aren't told where to go — they're told how fast, and the motor needs a moment to get going. Kick-Start asks for extra speed right after each change of direction so strokes feel snappier.

Motor Kick-Start page with the Enabled switch and the Burst strength and Burst length sliders circled
  1. Open Motor Kick-Start and switch Enabled on.
  2. Tune Burst strength first — a lower number means a stronger kick.
  3. Burst length is subtle and often barely noticeable — leave it at the default unless you want to fine-tune.
Leave this off for The Handy — it doesn't need it.
Core

Multi-Toy Support

Run more than one device at the same time — for example The Handy and a Lovense Solace — each with its own settings and its own live position bar.

Live Handy Position page with two toys and the Connected Toys list boxed in the sidebar
Every toy gets a bar; the sidebar lists them.
Toy Settings window for a Lovense Solace Pro with the Make this the Default toy button circled
Click a toy for its own settings.
  1. Connect all your toys inside Intiface Central, then press Start. They appear under CONNECTED TOYS in the sidebar (shown only when more than one is connected).
  2. The toy marked ★ is the Default toy. It follows every setting in the main window and is the only toy that can use Activated Source Switch.
  3. Click any other toy (⚙ click for settings) to open its Toy Settings. For each feature, tick Use different settings for this toy to give it its own values; untick it to follow the main window again.
  4. Under Sources for this toy, tick or untick sources to choose what moves it. At first it copies the Default toy; press Go back to following the Default toy to return. One source can move several toys at once.
  5. Press Make this the Default toy to change which toy is the main one — the app remembers your choice.
Troubleshooting

Troubleshooter

A one-click self-check of the whole chain: your license, Intiface, your toy, and what VRChat is sending.

The Help menu with Troubleshooter and Export OSC Session Log highlighted
Help → Troubleshooter
Troubleshooter results with a failing Toy check highlighted and the Copy Report button circled
Red items come with the likely cause and a fix.
  1. Open Help → Troubleshooter.
  2. Green ✓ is fine, yellow is worth a look, and red ✗ is a problem — click a row to read Why and How to fix.
  3. Fix the first red item first; the ones after it often clear up on their own.
  4. Press Run Again after each change. Copy Report copies the results (without your license key) so you can email them to Devviously@gmail.com.
It also warns you if more than one source is on, or if Predictive Movement is on with a Handy. A Common Problems list sits at the bottom of the window.
Optional

Boost

Some avatars never move all the way from 0% to 100%. Boost learns the range you've been using lately and stretches it, so strokes feel bigger — e.g. motion between 80% and 100% becomes about 40% to 100% at maximum.

Boost page with the Boost amount slider and Reset to 1.00 button circled
  1. Open Boost.
  2. Drag Boost amount up from 1.00 (off) toward 3.00 (biggest stretch). The preview shows what your avatar does versus what the toy does.
  3. Press Reset to 1.00 to switch it off.
Raise it if your toy barely moves on small touches. Keep it low if it reaches the ends too easily.
Optional

Deadzone Limits

Sets the lowest and highest point the toy is allowed to reach — it will never go below the Low limit or above the High limit. Keep strokes in a range that feels comfortable.

Deadzone Limits page with the Low limit and High limit sliders circled
  1. Open Deadzone Limits.
  2. Set Low limit and High limit (0.00 is the very bottom, 1.00 the very top). The Low limit can never go above the High limit.
If the toy bumps the ends of its stroke, raise the Low limit or lower the High limit a little.
Optional

Jitter Filter

VRChat's signal can wobble a tiny bit even when nothing is really moving, which makes the toy twitch. The filter ignores any change smaller than the Threshold.

Jitter Filter page with the Enabled switch and Threshold slider circled and a graph of red noisy and green smoothed lines
  1. Open Jitter Filter and switch Enabled on.
  2. Raise Threshold until the twitching stops — but no higher than needed, or small real movements get ignored too. The red line in the preview is what VRChat sends, the green line is what the toy gets.
Start at 0.10. If the toy still buzzes when you hold still, raise it a little.
Optional

Endpoint Snap

When the position gets close to the very top or bottom, Endpoint Snap sends it the whole way — so strokes actually reach the ends even if your avatar never quite reports a full stroke.

Endpoint Snap page with the Enabled switch and Snap zone slider circled
  1. Open Endpoint Snap and switch Enabled on.
  2. Set Snap zone — how close to an end counts as “close enough”. For example, 0.05 means anything within 5% of the top or bottom is sent all the way. Larger snaps more often.
Keep it small. Deadzone Limits still apply, and Endpoint Snap isn't used during Preset Strokes. It can also be set per toy — see Multi-Toy Support.
Situational

Invert

Flips the direction of the toy. Turn it on if the toy moves up when it should move down — for example if you hold or mount it the other way around.

Live Handy Position page with the Invert Off button circled and labelled Flip direction
  1. Press the Invert button at the top of the Live Handy Position page (it shows Invert On / Invert Off) — or use Settings → Invert (toy held upside down). Both are the same switch.
The Pop out ↗ button next to it opens a small always-on-top window with the same position bar, so you can watch it while you play.
Convenience

Character Profiles

A profile remembers all your settings (Boost, Deadzone, Predictive Movement, sources and so on) for one avatar, so they come back automatically whenever you use that avatar.

Character Profiles menu with Create New Profile and Profile Auto-Switch circled
  1. Open the Character Profiles menu at the top of the window.
  2. Detect Current Avatar finds the avatar you're wearing right now.
  3. Create New Profile saves your current settings as a profile linked to that avatar. Save to Loaded Profile updates it later; Rename and Delete manage it.
  4. Turn Profile Auto-Switch ON and the app loads the matching profile whenever you change into a linked avatar.
  5. The list at the bottom loads any profile by hand — the ✓ marks the one currently loaded.
Advanced

Macro Switch

A macro lets something you do in VRChat change a setting in the app. Each macro has a trigger (the VRChat signal to watch), a mode (when it fires) and an action (what it changes).

Macro Switch page listing three macros with + Add Macro circled
Your macros
Edit Macro window with the Pick Trigger button circled
Making a macro
  1. Open Macro Switch and press + Add Macro.
  2. Give it a Name, then press Pick Trigger… and choose the VRChat signal. Signals only appear after the app has seen them, so flip the toggle in VRChat once first, then press Refresh.
  3. Trigger Type: On/Off signal for a toggle or button, or Number from 0 to 1 for a slider — it counts as ON once it reaches the value you choose.
  4. Mode: Toggle turns the action on when the signal turns on and off when it turns off. One-Time fires once every time the signal changes — use it for actions that aren't on/off, like Raise Boost or Switch Profile.
  5. Action: most actions switch a feature on or off. Raise/Lower Boost changes Boost by the amount you choose, and Switch Character Profile loads one of your saved profiles. Press Save.
  6. Untick a macro to pause it, use ✎ to edit it and ✕ to delete it.
Advanced

Preset Strokes

Plays a steady up-and-down motion instead of following your avatar's real position. Handy for vibration-only signals, which have no depth to follow.

Preset Strokes page with the Enabled switch, Small stroke option and Stroke time slider circled
  1. Open Preset Strokes and switch Enabled on.
  2. Choose a style: Full stroke sweeps the whole range, Small stroke sweeps between the two limits you set under Small Stroke Range.
  3. Set Stroke time — how long one sweep takes one way, in milliseconds. Lower is faster; the fastest allowed is 50 ms.
  4. Make sure a source is active (see Adding Custom Sources) — it only plays while a source is sending data, stops where it is when the data goes quiet, and carries on in the same direction when data returns.
Turn this on when you want a steady motion without moving your avatar. It pairs well with a Likely Vibration source.
Experimental

Activated Source Switch

Helps when your avatar has several sources and the wrong one ends up controlling the toy. You pick a gesture in VRChat (for example, sitting down and standing up five times quickly); the app checks which of your custom sources was moving most just before, works out which one you're really touching, and locks the toy onto it.

Activated Source Switch page with the Enabled switch, Pick trigger button and Test Now and Unlock buttons circled
  1. Open Activated Source Switch and switch Enabled on.
  2. Press Pick trigger… and choose the VRChat signal that starts it, like Sit or Crouch (do the gesture in VRChat once first so the app sees it).
  3. Trigger type: Simple for an on/off signal, or Threshold for a gradual value (like a 0–100% wheel).
  4. Set Times it must switch on within this many seconds (for example 5 times within 3 seconds), and Look back — how many seconds the app looks back to decide which source you're touching.
  5. Press Test Now to run the switch right away. Press Unlock to release the lock so all your sources work normally again.
Only chooses between sources you added yourself (not the three built-in ones), and only controls the Default toy. While the trigger is OFF, your sources are paused — handy for things like “only when sitting”.
Troubleshooting

Debug Log & Filters

A live feed of what the app is doing and every signal it receives from VRChat. Use it to find a signal's name or work out why something isn't working.

Debug Log page showing a live colour-coded log with the Filters button circled
The Debug Log page
Choose what shows in the log window with category switches
Filters
  1. Open Debug Log from the sidebar and switch Show Debug Log on.
  2. Pause freezes the display so you can read or copy (lines that arrive meanwhile are still saved). Clear Log empties it. Save Log saves a text file. Pop out ↗ opens it in its own window.
  3. Filters chooses which kinds of line show — OSC IN, HANDY OUT, INTIFACE, ERROR, OSC and BRIDGE — and lets you hide a single noisy signal. Unticking hides it from now on; lines already in the log stay.
  4. Collect all debug data (on by default, recommended) writes the whole session to the log file as it happens, so nothing is cut off even if the app crashes.
  5. Log unmatched signals also shows signals the app isn't using — useful for finding the exact name for + Add manually or Macros.
  6. Save log file on close saves each session into a debug_logs folder next to the app (the newest 20 are kept). Press Open Folder to go there, and send the newest file to support if something went wrong.
Troubleshooting

Export OSC Session Log

Saves a record of everything in a session as a CSV file — handy for sending to support.

  1. Open Help → Export OSC Session Log.
  2. Choose where to save the file. A message confirms how many entries were saved and where.
  3. Email it to Devviously@gmail.com together with a description of what went wrong.
Convenience

Hide, Show & Reorder Pages

Hide the pages you never use and arrange the rest in the order you like.

The View menu with Reorganize and the Hide / Show Pages list highlighted
View menu
Drag to Reorder window with one page row and the Save Order button circled
Reorganize
  1. Open the View menu. Tick or untick a page under HIDE / SHOW PAGES — at least one page always has to stay visible.
  2. Choose Reorganize, drag a row (or use ▲ ▼) to move it, then press Save Order. Hidden pages still appear there marked “(Hidden)”.
  3. The sidebar's « button collapses it to a slim icon strip with a green or red dot on each icon — your choice is remembered.
Convenience

Settings

Open Settings from the menu bar.

Settings window with the Invert, haptics app and Intiface on another device switches circled
  1. Invert (toy held upside down) — the same switch as on the Live Handy Position page.
  2. Tell my avatar a haptics app is running — many avatars only switch on their touch and depth sensors once a haptics app says one is running. This sends that signal (OGB_ENABLED, the same one OscGoesBrrr sends): ON when your avatar is found, OFF when you press Stop or quit. If your avatar's sensors never react, make sure this is on.
  3. Use Intiface on another device (like my phone) — normally the app talks to Intiface Central on this PC. To use Intiface on your phone, switch this on, type the address shown in the Intiface mobile app (for example ws://192.168.1.50:12345), press Save, then press Stop and Start. Your PC and phone must be on the same network.
Account

License & Devices

Your license key is emailed to you after purchase. Each license can be used on a limited number of PCs at once.

The OSCGetsHandy activation screen with License Key and Email fields and the Activate button
First launch
The About and License window showing an Activated status and PCs using this license
Help → About / License
  1. On first launch, paste your License Key (it looks like XXXX-XXXX-XXXX-XXXX) and the Email you used at checkout, then press Activate.
  2. To check your status later: Help → About / License shows whether this PC is allowed to use the app and how many PCs your license is using. The check is online, so it needs an internet connection.
  3. Replaced a PC or reinstalled Windows and hit your limit? Email Devviously@gmail.com and a slot will be freed up.