Learn how funscripts work

A .funscript is a small JSON file of timed positions that tells a device where to be as a video plays. This funscript guide covers the file itself, the two ways to make one, every field in the format, and what to do when a script plays late, will not load or moves the device wrongly.

Checked against the app's code on 21 September 2026.

The four reference pages

  • What is a funscript?The file in plain terms: what is inside it, how a player and a device use it, and what it does not contain.
  • How to make a funscriptBy hand in an editor, or generated from the video with AutoScript Sync, then checked, saved and tried on a device.
  • The funscript format, field by fieldversion, inverted, range, actions and metadata, with a complete example and exactly how AutoScript Sync reads and writes each one.
  • Funscript troubleshootingA device that runs late, an Autoblow that will not connect, an Intiface device that is not found, a script that will not load.

Where these pages stop

The learn pages explain funscripts in general and say where AutoScript Sync behaves in a particular way. They describe the released app, version 2.121.1. Where something arrives in the next update, the page says so.

They do not describe other players or editors beyond the common conventions of the format. AutoScript Sync plays video in its own window and does not sync with external players.

Read next

  • Step-by-step guides to the appInstalling, activating, generating your first script, Live Track, AI Bulk Learn, device setup and the quality report.
  • The free funscript validatorChecks a file in your browser for broken JSON, unsorted or repeated times, out-of-range positions and moves too fast for a device. Nothing is uploaded.
  • How the analysis worksPose estimation, optical flow, depth and drift correction, for readers who want the engineering.

Try it on your own videos

The trial is the full app for one day; a licence is £14.99 once.