External Player Launcher

Plugins
,
1
:placard: Summary This plugin adds support for launching videos in external media players from scene cards and scene detail pages.
:link: Repository https://github.com/esumaka/stash-plugin-repo/tree/main/plugins/external-player-launcher
:information_source: Source URL https://esumaka.github.io/stash-plugin-repo/main/index.yml
:open_book: Install How to install a plugin?

Features

  • Adds a player dropdown menu at the bottom of scene cards for quickly selecting an external player
  • When “Single player mode” is enabled, the dropdown is replaced with a single player button for one-click playback
  • Scene detail pages also support launching external players
  • Individual players can be shown or hidden in settings
  • Settings are browser-local, so different devices can have different configurations

Screenshots

Scene card:

scene-card01
scene-card01695Ă—400 81.3 KB

Scene card (single player mode):

scene-card02
scene-card021019Ă—427 136 KB

Scene detail:

scene-detail
scene-detail1366Ă—647 151 KB

Supported Players

Supported media players and operating systems:

:warning: Note: some players require additional tools to function properly

Player Windows Android iOS macOS Linux
IINA :white_check_mark:
Infuse :white_check_mark: :white_check_mark:
MPC-HC :white_check_mark: (requires mpc-protocol)
MPV :white_check_mark: (requires mpv-handler) :white_check_mark: :white_check_mark: :white_check_mark: (requires mpv-handler)
MX Player (Pro) :white_check_mark:
nPlayer :white_check_mark: :white_check_mark:
PotPlayer :white_check_mark:
VLC :white_check_mark: (requires vlc-protocol) :white_check_mark: :white_check_mark: :white_check_mark: (requires vlc-protocol) :white_check_mark: (requires vlc-protocol)

Installing the Plugin

  1. In Stash, go to Settings → Plugins
  2. Click Add Source and fill in the following:
    • Name: esumaka plugin repo
    • Source URL: https://esumaka.github.io/stash-plugin-repo/main/index.yml
  3. Click Confirm to add the source
  4. Select External Player Launcher from the Available Plugins list and click Install
  5. Refresh the Stash page for the plugin to take effect

Usage

  • Make sure you have a supported player installed — see Supported Players
  • Click the player icon at the bottom of a scene card and select your desired player from the dropdown menu
  • Alternatively, go to the scene detail page, click the “Players” tab, then click the desired player button
  • Your browser may show a dialog like “trying to open xxx?” — click “Open” to proceed

Warning

This plugin may conflict with other plugins that modify scene cards, which could cause player buttons to disappear or appear in incorrect positions.

1 Like
2

A couple feature requests that should hopefully be pretty easy to implement:

  • Instance-wide default settings. While it’s good that the specific players are client-specific, it’s generally the case that most of a particular user’s clients will share a baseline common set of applications. Being able to set global defaults would reduce the per-client configuration needed.
  • Per-client hiding. Allow a state where no players are enabled and the scene-card button is hidden. I want to be able to use VLC on my Windows machine without cluttering my Chromebook.