funscript.wiki
Article Talk History

FunGen

FunGen
Developerack00gar (GitHub)
LicenseNon-commercial
PlatformWindows, Linux (Python)
TypeAI-powered funscript generator
WebsiteGitHub
Based onYOLO object detection, FFmpeg

FunGen is an AI-powered, Python-based tool for automatically generating funscript files from video content using computer vision (specifically, the YOLO object detection framework). It aims to dramatically reduce the time required to create scripts by automating the motion detection and timing process.

Overview ยง

Traditional funscript creation is a time-intensive manual process: a scripter watches video frame-by-frame and places action points at precise moments. FunGen replaces this with automated analysis, detecting motion cues in video and generating corresponding funscript action sequences.

The tool includes:

  • YOLO-based tracking โ€” motion and object detection adapted for the scripting task
  • FFmpeg integration โ€” for video decoding and frame extraction
  • Modular filter pipeline โ€” post-processing filters to clean up generated scripts:
    • Autotune (Savitzky-Golay smoothing)
    • Amplify / clamp / invert
    • Resample
    • RDP simplification (remove redundant points)
    • Speed limiter (device safety)
  • Ultimate Autotune โ€” applied automatically after generation
  • GUI and CLI modes โ€” a graphical interface for single videos and a command line for batch/folder processing

Performance ยง

FunGen achieves faster-than-realtime processing on capable hardware. Benchmarks have shown:

  • ~60โ€“110 FPS for 8K 8-bit VR video (single-process)
  • ~160โ€“190 FPS in parallel mode

A full 8K VR scene (typically 30โ€“60 minutes) can be processed in 20โ€“30 minutes.

Limitations ยง

The quality of AI-generated scripts typically falls short of expert manual scripting, particularly for nuanced timing, multi-axis data, and scenes with unusual camera angles. Generated scripts are generally used as a starting point for manual refinement in OpenFunscripter.

FunGen is licensed for personal, non-commercial use only.

See also ยง

Tools

Categories: Tools