Opening .funscript Files: Compatible Players & Apps

What is inside a .funscript file, which players open the scripts HaptiQ exports (DeoVR, HereSphere, XBVR, ScriptPlayer), and how to play one in HaptiQ.

What is a .funscript file?

A .funscript file is a small JSON text file that tells a toy where to be and when. It holds no video and no audio, only a list of timed positions, so it is tiny and opens in any text editor. A file HaptiQ exports looks like this:

{"version": "1.0", "inverted": false, "range": 100, "actions": [{"at": 0, "pos": 0}, {"at": 500, "pos": 100}], "metadata": {}}

Because the format is plain timed positions, the same file plays on very different hardware. A stroker follows each position; a vibration toy follows how fast the script is moving, since a funscript has no intensity channel.

How players use a funscript

A player keeps the script in step with the video: as the video plays, it sends the toy the position the script asks for at that moment. The usual convention is to keep the script next to its video with the same base name, for example clip.mp4 and clip.funscript, so the player can find it. Check your player's own documentation for how it loads scripts and connects toys.

Players that work with HaptiQ's .funscript files

HaptiQ outputs a standard .funscript, and its exported scripts work with third-party players including DeoVR, HereSphere, XBVR and ScriptPlayer.

DeoVR

DeoVR is a free VR player with broad format support up to 8K, available on PC, Quest and Pico. Reliable haptic sync in DeoVR is tied to a third-party (SLR) subscription, so check what your account includes before you rely on it for scripts.

HereSphere

HereSphere is a paid VR video player, a one-time purchase on Steam, built for high-quality VR video rendering. It runs in VR headsets rather than on phones or the web, and it has direct-to-device pairing for the hardware it supports.

XBVR

HaptiQ's exported .funscript files also work with XBVR. Keep each script next to its video with a matching name so your library stays organised.

ScriptPlayer

ScriptPlayer is a free, open-source (GPL-3.0) player for Windows, long established in the community and extensible through community forks. It plays scripts; it does not generate them.

Playing a script in HaptiQ itself

You do not need a separate player to check a script. HaptiQ's Player page loads a video file and a .funscript (or .json) and plays the script on your connected toy with Sync to devices:

  1. Connect your toy on Devices: press Connect toy in Chrome or Edge on a computer or Android phone, use the HaptiQ Android app, use Bluefy on iPhone, or connect The Handy over Wi-Fi with its connection key.
  2. Open the Player, load the video and the script.
  3. Press play. Playback speed goes from 0.5x to 2x, and there is a loop toggle.
  4. Shortcuts: Space plays and pauses, the Left and Right arrows seek 5 seconds, M mutes and L toggles loop.

With The Handy, HaptiQ uploads the script to the toy by default and the Handy plays it in sync on its own (HSSP); if that cannot start, or the speed is not 1x, HaptiQ streams position commands instead (HDSP).

Single-axis and multi-axis scripts

A standard .funscript has one position channel, usually the stroke. Multi-axis rigs use T-code, and HaptiQ's T-code support covers 8 axes: L0 stroke, L1 surge, L2 sway, R0 twist, R1 roll, R2 pitch, V0 vibration and A0 auxiliary. A T-code command is the axis, a value from 0 to 999 and an interval in milliseconds, such as L0500I100.

HaptiQ Pro can export multi-axis data as one funscript per axis, as T-code text or as CSV, and import T-code or CSV back. The multi-axis guide covers this in detail.

Creating and editing .funscript files

HaptiQ's editor imports .funscript and .json files, so you can open a script from anywhere, fix it and export it again.

Troubleshooting

The script will not open in HaptiQ

HaptiQ imports files ending in .funscript (the editor and Player also accept .json). If you pick a file that is not a valid funscript (a video chosen by mistake, a non-JSON file or a damaged script), HaptiQ checks the file first and shows a plain message saying what you picked and what to do, instead of loading it.

The toy moves, but late

Steady lag is what a sync offset fixes. Run Device Doctor's Sync calibration: it measures how late the toy acts and saves that as the toy's sync offset, so HaptiQ sends commands that many milliseconds early. Lag that comes and goes is signal trouble: move closer, charge the toy, and keep 2.4 GHz Wi-Fi traffic away from it.

Connected, but nothing moves

Run Device Doctor: it sends a test command and asks whether you felt it. Also check that the part of the script you are playing actually moves; a flat section of a funscript produces genuine stillness.

The script plays but feels too fast or too jerky

Open it in HaptiQ's editor and apply the speed limiter or anti-jerk plugin, which cap the maximum speed, or a smoothing plugin to remove small jitter. Then export it again; the original file is not changed until you save the new one.

Bluetooth is not available

Web Bluetooth works in Chrome and Edge, not Firefox or Safari, and Intiface Central does not get around this. On iPhone, use Bluefy today; the HaptiQ iPhone app is coming to the App Store.

Try HaptiQ

HaptiQ turns VR and 2D POV videos into standard .funscript files you can keep, edit and play anywhere. The Free plan gives you 2 full-quality scripts, then 1 free script every month. Start free or see the plans.

Frequently asked questions

Can I open a .funscript file without the matching video?

Yes, as a file: it is plain JSON text with timed positions, so any text editor opens it, and HaptiQ's editor imports .funscript and .json files. To feel it in sync you play it together with its video, for example on HaptiQ's Player page.

Why does my .funscript work in one player but not another?

Each player loads scripts and connects toys in its own way, so check its documentation first. In HaptiQ, run Device Doctor: it checks the toy connection, runs a feel test and calibrates the sync offset.

Do I need to convert a .funscript to another format?

Not for HaptiQ or the players it works with: HaptiQ outputs a standard .funscript. For multi-axis rigs, HaptiQ Pro can also export T-code text or CSV and import them back.

Can I use .funscript files on Mac or Linux?

Yes. HaptiQ runs in Chrome or Edge on Windows, Mac, Linux and ChromeOS (on Linux, Bluetooth needs a Chrome setting). Third-party players vary: ScriptPlayer is Windows-only, and HereSphere runs in VR headsets.

What's the difference between single-axis and multi-axis .funscript?

A standard .funscript has one position channel, usually the stroke. Multi-axis scripts add axes in T-code: L1 surge, L2 sway, R0 twist, R1 roll, R2 pitch, V0 vibration and A0 auxiliary, alongside L0 stroke. Your hardware decides which axes it can use.

Create a free HaptiQ account to generate a funscript from your own video.