A funscript is a small text file that tells an interactive toy, usually a stroker, where to move at each moment of one specific video. A player reads the file alongside the video and sends the movements to the toy. The legal ways to get one are a site or studio that sells scripted videos, a toy maker’s own library, or scripting a video you own yourself.
This guide is based on official pages read on Nov 10, 2026: the Buttplug project’s format notes, The Handy’s store page, the EroScripts guidelines and our fact files for the toys and sites named. I have not scripted or synced a video myself.
Key takeaways
- One script, one video. A funscript only matches the exact video, cut and length it was made for.
- It is just data. A funscript holds positions and timestamps, not video. You still need the video from a legal source.
- Your toy decides. Strokers like The Handy and the Autoblow AI Ultra list funscript support; other toys may use their own sync systems instead.
- Legal sources: paid VR and studio memberships with scripts, the toy maker’s own library, and scripts you write for videos you own.
- Skip pirated sources. A script for a pirated video is still a pirated video.
What is inside a funscript
According to the Buttplug project’s format notes, a funscript is a JSON file with the .funscript ending. Its core is a list of “actions”. Each action has two numbers: at, a timestamp in milliseconds, and pos, the position the toy should be in at that moment. The player moves the toy from one position to the next in time with the video.
A script can carry extra details, such as the author or a licence, if the editing tool adds them. Some players and multi-axis devices also read extra files for other movements, named with suffixes such as .twist or .roll, per the MultiFunPlayer documentation.
For local files, the usual rule is simple: the script sits in the same folder as the video and has the same name. my-video.mp4 pairs with my-video.funscript.
Which toys and players read funscripts
Toys. The Handy 2’s store page says it “works with funscript”, and the Autoblow AI Ultra lets you “upload your own preferred adult video and a funscript”. Kiiroo’s Keon pages describe sync through its FeelConnect app and partner sites rather than funscript files. Lovense uses its own apps and site integrations. Check your exact model before you buy scripts. The basics are in how to sync a toy with porn.
Players. The Handy’s help center lists the Handyverse web player and the VR players HereSphere, DeoVR (with a SexLikeReal subscription) and Pigasus. On a PC, free tools such as MultiFunPlayer read local scripts and drive many toys. See HereSphere vs DeoVR and MultiFunPlayer and Intiface.
Where to get funscripts legally
Paid sites with interactive scenes
The cleanest route is a site that sells the video and the script together. SexLikeReal shows a premium tier called “Bundle with Scripts” next to “Videos Only” on its join page, per our fact file, and its interactive page lists The Handy 2 and Kiiroo Keon models. The Handy’s store page names “60+” partner sites, including SexLikeReal, BaDoinkVR, CzechVR, RealJam VR and VR Bangers. Some deliver the script inside their own player instead of as a file you download.
The toy maker’s own library
- The Handy. The help center describes Ohdoki’s script database, which it said covered “1000+ videos” when we checked on Oct 27, 2026, plus the Handyverse player.
- Autoblow. Its FAQ describes a free synced library for the AI Ultra, given as “more than 750” videos in one place and 600+ in another.
- Kiiroo. FeelConnect, which Kiiroo says is free with no subscription, receives “official interaction data built into the video” on supported sites.
Games with built-in sync
Interactive games can ship their own sync. Dezyred runs choose-your-path VR scenes and syncs with The Handy, per our test drive.
Scripting it yourself
You can write a funscript for a video you bought or recorded. The Buttplug notes name OpenFunscripter and JoyFunScripter as tools. It is slow work: you mark positions frame by frame. Keep self-made scripts for your own use unless the video’s owner allows otherwise.
Community forums: read the rules first
The Handy’s store page mentions “a community of 30,000+ on EroScripts and Discord”. EroScripts is a forum where people share scripts. Its guidelines, read on Nov 10, 2026, require members to be 18+ and say moderators may remove content at any time. They also allow some content categories that this site’s rules exclude, hidden by default. For that reason I don’t link to it or recommend it here. If you use any forum, take only scripts for videos you have bought from the studio.
What to avoid
- Free “script packs” bundled with videos. If a download includes the video, it is almost certainly unlicensed.
- Tube sites hosting studio scenes. Uploads without the studio’s licence are piracy, scripted or not.
- Real people without consent. Never script or share content of real people who didn’t agree to it.
- Apps asking for your toy’s key from unknown sites. On The Handy, the connection key gives control of the device. Treat it like a password.
Steps: playing your first funscript
- Check your toy supports funscripts on the maker’s own page.
- Get a scripted video from a paid site, the maker’s library or your own collection.
- Name the files to match if you play locally: same folder, same name,
.funscriptending. - Pick a player that supports your toy: a site’s own player, Handyverse, HereSphere, DeoVR or a desktop tool.
- Connect the toy with its key, Bluetooth or a hub such as Intiface Central.
- Start at low speed and adjust the player’s offset if the toy runs ahead or behind.
Common mistakes
- Script and video don’t match. A different cut, intro or frame rate puts the whole script out of step.
- Wrong file name. Local players won’t find a script that is named differently from the video.
- Toy can’t do the movement. Multi-axis scripts need multi-axis hardware; a single-axis stroker ignores the extras.
- Assuming every scripted site supports your toy. Check the site’s list for your exact model.
- Max speed on the first try. Fast scripts can be uncomfortable; most players let you cap speed or range.
| # | Service | Score | From | |
|---|---|---|---|---|
| #1 | 9.5 | $26.99/month | Visit site | |
| #2 | 8.5 | €276.60 | Visit site | |
| #3 | 8.0 | $199.95 | Visit site |
FAQ
What is a funscript file?
A JSON file with a .funscript ending that lists positions and timestamps for one video. A player reads it and moves an interactive toy in step with the video.
Where can I get funscripts legally?
From paid sites that sell scripted scenes (SexLikeReal shows a "Bundle with Scripts" tier), from toy makers' libraries such as The Handy's script database or Autoblow's free library, or by scripting videos you own.
Are funscripts free?
Some are. Autoblow's library is free for its owners, and scripts you write yourself cost nothing. Studio scripts usually come with a paid membership.
Do funscripts work with Lovense or Kiiroo?
Lovense and Kiiroo sync mainly through their own apps and partner sites. Some third-party tools can drive them from scripts, but check your exact model and app first.
How do I make a funscript?
With an editor such as OpenFunscripter, by marking positions along the video's timeline. Script only videos you own or have permission to use.
