Feature request: Stash integration for synced funscript playback

[MeinWesen]

Summary

Please add support for Stash as a local video source for automatic funscript (and optionally HWL) streaming/sync, similar to the existing Howl Sync Kodi add-on.

Stash is a much more common local adult video library than Kodi for this use case. It already associates .funscript files with scenes (same basename as the video), serves them over HTTP, and has first-class interactive/funscript plumbing.

Why this would help

Howl already does the hard part well:

• Real-time funscript → estim conversion, including multi-axis scripts
• Remote API (/load_funscript, /start_player, /stop_player, /seek, remote latency)
• One-way player sync via the Kodi add-on

What’s missing is the same convenience for people whose library already lives in Stash. Right now the choices are copying scripts to the phone and starting playback by hand, or routing everything through Kodi even when Stash is the player.

What Stash already provides

• Funscripts next to videos: video.mp4 + video.funscript
• Scene endpoint that serves the script: /scene/{id}/funscript
• Interactive metadata / heatmaps after a scan
• UI plugin hook PluginApi.utils.InteractiveUtils.interactiveClientProvider so a plugin can own play/pause/seek/script-load
• Existing community plugins for extra funscript features (multi-script, offset, Buttplug, etc.)

Suggested implementation

A Stash plugin in the same style as Howl Sync for Kodi:

1. User configures Howl phone IP + remote access key in the plugin
2. On scene play, plugin fetches the scene funscript (and/or .hwl if present)
3. Plugin POSTs it to Howl /load_funscript (or /load_hwl)
4. Plugin mirrors Stash player events to Howl:
   • play → /start_player
   • pause/stop → /stop_player
   • seek / timeupdate → /seek
5. Howl’s existing Remote latency setting handles estim/video offset, same as Kodi

Optional extras:

• Prefer / pass through multi-axis scripts when Stash has more than a single stroke axis
• Fall back to sidecar .funscript / .hwl next to the video file
• Config for Howl host, port 4695, access key, and an extra offset

Expected behaviour

Same as Kodi Howl Sync:

• Play a Stash scene that has a matching funscript
• Howl loads that script automatically (no copy to the phone)
• Skip/pause/stop in Stash keep Howl in sync
• Latency is tunable in Howl

Environment

• Howl on Android with “Allow remote access” enabled
• Stash on the same LAN
• Funscripts already scanned/attached in Stash

[Amethyst-Sysadmin]

I don't personally have the time to write or maintain Howl add-ons for additional apps. People are very split in what software they prefer to use for media playback. Somebody will want an add-on for Stash, somebody will want one for VLC, somebody on Linux will want one for MPV or Haruna. It would be a never-ending task to make them all and keep them up to date as the relevant software evolves.

I chose to do a Kodi add-on because I wanted to play videos on my bedroom TV, which is hooked up to an Nvidia Shield (Android TV media box). And because it runs on a very wide variety of platforms. It can be used on Windows, Mac, Linux, Android, Android TV etc. so is accessible to nearly all users in at least some form. Of course it's not perfect, and won't suit everyone.

Add-ons are definitely a case where it's appropriate for other developers to build things, and add support for the apps they use personally and are familiar with. I think the existing documented remote API provides all the functionality needed. There should be no reason that developers can't create similar add-ons for whatever apps they want (provided the app has suitable hooks to create add-ons in the first place).