Skip to content

Media Player

Load an audio or video file alongside your funscript to hear or see the content while you edit. The player restricts playback to the current phrase — so you are always listening to exactly what you are changing.


Loading media

In the sidebar, find the Media file input below the funscript file input.

Paste the full path to your audio or video file. Supported formats:

Type Formats
Audio MP3, M4A, WAV, OGG, AAC
Video MP4, MKV, MOV, WEBM

FunscriptForge also attempts to auto-detect media by looking for a file with the same base name as your funscript in the same folder. If your funscript is myvideo.funscript and myvideo.mp4 is next to it, it loads automatically.


Phrase-locked playback

Once media is loaded and you open a phrase in the Phrase Editor, a player column appears to the right of the charts.

The player plays only within the current phrase boundaries — it loops from the phrase start to the phrase end. This keeps your attention focused on the section you are editing rather than the whole file.


Layout toggle

The player column takes up 1/4 of the Phrase Editor width. If you need more space for the charts, click 📹 Hide player above the charts. The charts expand to 3/4 width. Click again to restore.


Setting a split point with media

While the media player is open, you can click 📌 (pin) at any point during playback to drop a phrase split boundary at the current timestamp. This is the fastest way to split a phrase at a specific beat or scene change — play the content, hit pin when you hear it, and the split appears on the chart.

See Phrase Editor — Splitting a phrase → for details on working with splits.


Video format & smooth playback

FunscriptForge plays your video chapter by chapter while you edit. How quickly chapters switch depends on the video format:

Your video What happens Chapter switching
1080p (or smaller) H.264, standard frame rate Streamed straight from your file Instant — seeks within one continuous video
4K, HDR, variable frame rate, HEVC/AV1, 10-bit A downscaled (720p) preview is prepared A short load the first time you open each chapter

1080p H.264 is preferred but not required. A standard 1080p MP4 plays instantly with nothing to prepare. A 4K (or other heavy) source still works perfectly — FunscriptForge just makes a lightweight 720p preview so the embedded player stays smooth, which adds a brief load when you jump to a chapter. Your exported files are never affected; this is only about editor preview playback.

Tip: If you have a choice, point FunscriptForge at a 1080p H.264 version of your video for the snappiest editing. The funscript and analysis are identical either way — only preview playback feels different.


File size limits

Mode Limit
Local (desktop app) No limit — file is streamed from disk
Web mode 500 MB

For local use there is no cap. If you are running FunscriptForge in web mode (hosted) and your media file is larger than 500 MB, the player will not load it.


Troubleshooting

Player doesn't appear after loading media Check that the file path is correct and the file format is supported. See Troubleshoot the media player →.

Video loads but audio is silent Check your browser's audio permissions. Some browsers mute autoplay by default — click the audio/video element to unmute, or check your browser's site permissions.

Playback is out of sync The player uses the funscript timestamps directly. If the content and funscript are misaligned, use the Nudge transform to shift the phrase forward or backward to match.

Chapters take a few seconds to load This means your source is 4K (or HDR / variable-frame-rate / HEVC / AV1), so FunscriptForge is preparing a smooth 720p preview the first time you open each chapter. It's expected, and it only affects preview playback — your analysis and exports are unaffected. A 1080p H.264 version of the same video plays instantly. See Video format & smooth playback.