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.
Related¶
- Phrase Editor → — editing context for the player
- Nudge → — shift a phrase in time to fix sync
- Troubleshoot media player →