Open App

ScriptCompiler Bridge

The Bridge is a lightweight local app that unlocks native features like motion tracking, scene detection, audio analysis, and local video library.

What is the Bridge?

The Bridge is a small application that runs in the background on your computer. It acts as a local server that ScriptCompiler connects to for features that a web app cannot do on its own, such as reading local files, running computer vision tracking, and analyzing audio.

Once installed, it starts automatically with Windows and sits quietly in your system tray. You do not need to interact with it during normal use.

Why is it needed?
Web browsers restrict access to your file system and cannot run native computer vision libraries. The Bridge runs natively on your machine and provides ScriptCompiler with a local API to work around these limitations.

What it Enables

The Bridge unlocks or enhances several features in ScriptCompiler:

Feature Description
Local Video Library Browse, search, and load video files from a folder on your computer, with thumbnails and automatic funscript detection (requires Bridge)
Script Sniper Enhanced motion tracking using native OpenCV for improved performance. Script Sniper also works without the Bridge using OpenCV.js in the browser.
Scene Detection Automatically detects scene cuts in your video to help with navigation and chapter creation (requires Bridge)
Audio Analysis Enhanced beat detection, tempo tracking, and section analysis for Music Scripter. Music Scripter also works without the Bridge.
Thumbnail Pregeneration Pre-caches video thumbnails for faster timeline tooltip previews. A progress bar appears during caching.
Auto-save to Local Library When editing a script loaded from the local video library, changes are saved back to the original file automatically.
Native File Dialogs Open and save files using your operating system's native file browser

Installation

  1. Click the Bridge button in the ScriptCompiler header
  2. In the dialog that opens, click Download Now
  3. Run the downloaded installer and follow the prompts
  4. The Bridge starts automatically after installation and connects to ScriptCompiler right away
  5. You will see the ScriptCompiler Bridge icon appear in your system tray

On subsequent boots, the Bridge starts automatically with Windows. You do not need to launch it manually.

Verify it is running
Click the Bridge button in the header. If connected, it shows the version, port, and a list of available capabilities. You can also look for the icon in your Windows system tray.

Setting Up Your Video Folder

To use the Local Video Library you need to point the Bridge at the folder where your videos are stored.

  1. Right-click the Bridge icon in the system tray
  2. Click Set Video Folder...
  3. Browse to and select your video folder
  4. The Bridge scans the folder and builds a library

The Bridge looks for video files with these extensions: .mp4, .webm, .mkv, .avi, .mov, .wmv, .flv, .m4v.

It also checks for a matching .funscript file next to each video. If one exists, the video is marked with a Funscript badge in the Local Video Library.

One folder
The Bridge currently supports one configured video folder. All videos inside that folder and its subfolders are included in the library.

System Tray Menu

Right-click the Bridge icon in the system tray to access the menu:

Item Description
ScriptCompiler Bridge v[version] Shows the installed version (not clickable)
Port: 9876 Shows which port the Bridge is listening on (not clickable)
Video Folder: [path] Shows the currently configured folder (not clickable)
Set Video Folder... Opens a folder picker to change the video folder
Refresh Library Rescans the video folder to pick up new or removed files
Quit Closes the Bridge

How it Connects

The Bridge listens on http://127.0.0.1:9876 by default. ScriptCompiler checks this address automatically when the page loads. No configuration is required on the ScriptCompiler side.

The Bridge only accepts connections from localhost and scriptcompiler.com. It cannot be reached from other computers on your network.

Updates

The Bridge checks GitHub for a newer version once on startup. When an update is available, ScriptCompiler shows a notification in the Bridge dialog (click the Bridge button in the header to see it). From there you can apply the update directly: the Bridge downloads the installer, launches it silently, and closes itself so the new version installs cleanly.

Troubleshooting

ScriptCompiler says Bridge is not connected

  • Check that the Bridge icon is visible in the system tray
  • If the icon is missing, launch the Bridge from the Start Menu
  • Refresh the ScriptCompiler page after the Bridge starts
  • Check that no firewall or antivirus is blocking port 9876

Local Video Library is empty

  • Make sure you have set a video folder via the system tray menu
  • Check that the folder contains supported video formats
  • Try clicking Refresh in the Local Video Library to rescan

Script Sniper or audio analysis is slower than expected

  • These features work in the browser but perform better with the Bridge connected
  • Check the Bridge indicator in ScriptCompiler to verify the connection
  • Restart the Bridge if it was recently updated