Create Your First Script
Step-by-step tutorial to create your first funscript with ScriptCompiler. Learn to script porn videos for The Handy, Autoblow, and other devices.
This tutorial walks you through creating a complete funscript from start to finish. You will learn best practices for each step of the process.
Before You Begin
Make sure you have:
- A modern web browser (Chrome, Firefox, Safari, or Edge)
- A video file you want to script (MP4, WebM, or OGG format)
- Some time to work through the tutorial (15-30 minutes for your first script)
Step 1: Load Your Video
Open ScriptCompiler and load your video using one of these methods:
- Load Video button - Click the Load Video button on the video player
- Drag and drop - Drag the video file directly onto the editor
The video loads in the video player area. Take a moment to watch through the video and identify the sections you want to script.
Step 2: Understand the Timeline
The timeline is where you create and edit your script. It displays time horizontally and position vertically:
- Horizontal axis (X) - Time, matching the video duration
- Vertical axis (Y) - Position from 0 (bottom) to 100 (top)
- Red cursor - Current playback position, synced with the video
- Blue dots - Action points that define your script
Timeline Navigation
- Pan - Middle-click and drag, or use horizontal scrolling
- Zoom - Hold Ctrl and scroll the mouse wheel
- Jump - Click anywhere on the Script Overview to jump to that position
Step 3: Add Action Points
Start adding points by clicking on the timeline canvas. Each click creates a new action point at that time and position.
Basic Point Workflow
- Navigate to a position in the video where you want to add a point
- Click on the timeline at the appropriate vertical position
- Repeat for each action in the scene
Selecting and Moving Points
- Select one - Click on a point
- Select multiple - Hold Shift and drag a box around points
- Add to selection - Hold Ctrl and click points
- Move points - Drag selected points to a new position
- Delete points - Select and press Delete
Step 4: Use Drawing Mode
Drawing mode lets you create smooth, natural patterns by drawing directly on the canvas.
- Click on the drawing panel on the right side of the editor to capture the cursor
- Position the video at the start of the section you want to script
- Start playing the video with Space
- Move the mouse up and down to create the pattern
- Press Ctrl to stop drawing and release the cursor
Points are created in real-time as you draw. The drawing panel shows your current position with a crosshair indicator.
Step 5: Fine-tune with Tools
Use the productivity tools to refine your script:
- Smoothing - Reduce the number of points while maintaining the curve shape
- Position Multiplier - Scale the intensity of selected points
- Align - Align points to top, middle, or bottom positions
- Distribute - Space points evenly in time
Access tools from the Tools Panel on the left side of the editor. Select the points you want to modify, then apply the tool.
Step 6: Preview on Device
Before exporting, preview how your script will feel on an actual device:
- Open the Device Emulator from the left panel
- Play the video with Space
- Watch the emulator to see the simulated device movement
The emulator uses physics-based simulation to accurately represent how devices handle your script, including acceleration and velocity limits.
Step 7: Export Your Script
When you are happy with your script, export it:
- Click File then Save As
- Enter a filename (the .funscript extension is added automatically)
- Click Save to download the file
The exported file can be used with any funscript-compatible player or device. Name the file to match your video for automatic script loading in most players.
Tips for Better Scripts
Start Simple
For your first scripts, focus on the main action and keep patterns simple. You can always add complexity as you become more comfortable with the tools.
Use the Script Overview
The Script Overview at the bottom shows a color-coded visualization of your entire script. Use it to identify gaps, check pacing, and navigate quickly.
Save Frequently
ScriptCompiler auto-saves your work, but it is good practice to save manually after significant changes using File then Save As.
Use Keyboard Shortcuts
Learning keyboard shortcuts significantly speeds up your workflow. Start with the basics (play, undo, delete) and gradually add more. See the full list in the Keyboard Shortcuts reference.
Watch Your Speed
The Script Overview uses colors to indicate speed. Very fast sections (red) may be difficult for devices to follow. Aim for a mix of speeds for a natural feel.