[Windows] Preview .funscript files directly in Windows Explorer

[amango134]

FunscriptPreviewHandler is an open-source Windows Explorer extension that lets you preview your .funscript files without opening them in a separate application.

Features

• Renders .funscript heatmap directly in Windows Explorer’s preview pane
• Metadata is also rendered for convenience
• Integrates with Windows Explorer

Installation

Regular Users (Recommended)

Simply download and run FunscriptPreviewHandler-Setup.exe from the Releases page. The installer handles everything automatically.

Advanced Users

If you prefer manual installation, individual DLL files are provided:

• FunscriptPreviewHandler.dll
• Newtonsoft.Json.dll
• SharpShell.dll

You will need to launch SharpShell Server Manager and install the FunscriptPreviewHandler.dll manually by clicking File > Load Server... inside Server Manager.

Note: Manual installation is only recommended if you understand Windows shell extensions and registry requirements.

How to Use

1. Install using the setup file
2. Open Windows Explorer
3. Navigate to a folder containing .funscript files
4. Select a .funscript file
5. The preview will appear in the preview pane (typically on the right side)
6. If you don’t see the preview pane, press Alt+P or go to View → Preview pane

System Requirements

• Windows 10 or 11
• .NET Framework 4.7.2 or newer

Source Code

The project is open source (MIT license) and available on GitHub.

Feedback

If you encounter any issues or have suggestions for improvement, please open an issue on GitHub or reply to this thread.

I hope you find this useful! Cheers. PS: This was inspired by @smeedler’s request for a way to see .funscript files without opening OFS.

Changelog

v1.0.2 - Theme toggle and resizeable metadata panel

v1.0.1 - Show extra metadata (performers, video URL, etc.) if available

v1.0.0 - Initial Release

[Rosethorn (Rose)]

This is a neat concept, although I hope some experienced coders can go over it and locate any flaws. (Or alternatively properly make a similar project without an over-reliance on LMMs.)
Letting LLMs handle the coding means you might not have a firm grasp of issues that may be present.

[amango134]

I probably shouldn’t have used the term vibe-coding and LLMs loosely in the post. I’ve removed it from the post to avoid future confusion.

LLMs helped a bunch overall, tho I’ve read over what was written.

It is relatively straightforward; heatmap rendering logic was largely ported from @defucilis funMapper.ts (LLMs do great porting over maths) and metadata is read from the .funscript file and rendered in a second box under the heatmap.

[Rosethorn (Rose)]

That’s fair, as long as you’ve proofread the output and are aware of how everything functions I don’t have an issue with it.
LLMs can shortcut some research and typing, but it’s important to be familiar with the structure and potential issues.

[amango134]

agreed!

[amango134]

new release is now available: v1.0.1 - Show extra metadata (performers, video URL, etc.) if available

Screenshot:

[amango134]

new release is now available: v1.0.2

• Added dark/light mode and theme toggle.
• Made metadata panel resizable with a draggable handle.
• Theme and height changes saved in Registry.
• Registry key removed when uninstalling