ScriptPlayer+

A modern funscript video player with The Handy integration, Intiface / Buttplug / FunOSR multi-axis support, EroScripts browser login, and multi-language support.

English · 한국어 · 日本語 · 中文

---

Screenshots

v0.1.4 Preview	Device Settings

Audio Playback + Heatmap	Audio Playback

Timeline Settings	Windows Playback

Heatmap & Timeline	EroScripts Search

Settings	macOS

What's New In v0.1.5

v0.1.5 rolls the experimental multi-axis work into the main release with official FunOSR (Direct Serial / COM) support, Intiface / Buttplug raw TCode transport, adjustable one-line L0/L1/L2/R0/R1/R2 output, smoother timeline and heatmap playback updates, better Handy re-sync after timeline seeks, and the packaged Windows fixes from exp.7 / exp.8.

v0.1.5 Preview

• Download the stable release: ScriptPlayer+ v0.1.5

Features

• Video + Audio Player — Play local video files (MP4, MKV, AVI, WebM, MOV, WMV) and audio files (MP3, WAV, FLAC, M4A, AAC, OGG, OPUS, WMA)
• Artwork Detection For Audio — Automatically picks matching cover art from the media folder when available
• Playback Modes — Continuous playback, shuffle playback, and adjustable playback speed controls
• Funscript Support — Automatically loads matching .funscript files alongside local media
• Timeline Visualization — Real-time scrolling timeline showing script action points with speed-based colors
• Heatmap — Full-media intensity heatmap (green → yellow → orange → red → purple)
• Configurable Default View — Timeline and heatmap can be enabled or disabled by default from Settings
• The Handy Integration — Connect and sync The Handy device via HSSP protocol
  • Auto-connect & connection history
  • Script auto-upload to Handy servers
  • Time offset adjustment
  • Stroke range customization
  • Inverse stroke toggle
• Intiface / Buttplug Multi-Axis Support — Connect supported devices, map features to script axes, and send raw TCode when available
• FunOSR (COM) Support — Stream one-line TCode directly to compatible devices at an adjustable update rate
• EroScripts Integration — Search and download funscripts directly from EroScripts via in-app browser login (no API key needed)
  • Session-based login persisted locally
  • Direct download into the configured script storage folder
• Multi-Language — English, 한국어, 日本語, 中文
• Drag & Drop — Drop video or audio files directly into the player
• Folder Browser — Browse folders with subfolder grouping and script detection (green checkmark)
• Keyboard Shortcuts — Space, Arrow keys, F (fullscreen), M (mute), and more
• Cross-Platform — Windows (standalone), macOS (via GitHub Actions), and Linux x64 (build from source)

Installation

Windows

1. Download the latest Windows x64 build from Releases
2. Extract and run ScriptPlayerPlus.exe — no installation required
3. The main v0.1.5 build includes The Handy, Intiface / Buttplug, and official FunOSR device support

macOS

1. Download the latest macOS build from Releases
2. Extract and move ScriptPlayerPlus.app to Applications

Linux

Linux x64 builds can be created from source. The configured Linux package targets are AppImage and linux-unpacked.

Build from Source

git clone https://github.com/sioaeko/scriptplayer-plus.git
cd scriptplayer-plus
npm install

Development:

npm run electron:dev

Build Windows:

npm run build:win

Build macOS (requires macOS):

npm run build:mac

Build Linux:

npm run build:linux

Keyboard Shortcuts

Key	Action
Space / K	Play / Pause
← / →	Seek ±5s
Shift + ←/→	Seek ±10s
↑ / ↓	Volume ±5%
F	Toggle fullscreen
M	Toggle mute
Ctrl + ,	Open settings

Tech Stack

• Electron — Desktop application framework
• React + TypeScript — UI components
• Tailwind CSS — Styling
• Vite — Build tool
• Handy API v2 — Device communication
• Discourse API — EroScripts integration

License

PolyForm-Noncommercial-1.0.0

This project is distributed as source-available software for noncommercial use only. Commercial use requires separate permission from the copyright holder.

---

Built with Electron, React, and Tailwind CSS