Stream Queue

Plugins
,
1
:placard: Summary Create multiple playlist queues for external media players like VLC
:link: Repository https://github.com/codddarrr/stashapp-plugins-repo/tree/main/plugins/stream-queue
:information_source: Source URL https://codddarrr.github.io/stashapp-plugins-repo/main/index.yml
:open_book: Install How to install a plugin?

This plugin adds a multi-playlist queue system for external media players. Right-click on any scene to add it to numbered streams, then export as M3U8 playlists for VLC, mpv, IINA, or any compatible player.

Main features:

  • Multiple independent streams - Configure 1-10 separate playlist queues
  • Right-click context menu - Add scenes to different streams with one click
  • Floating management panel - Real-time view of all your queues with drag support
  • M3U8 playlist export - Industry-standard format compatible with VLC and other players
  • Theme-agnostic - Works with all Stash themes and layouts (wall view, card view, etc.)
  • Persistent storage - Queues survive page reloads (localStorage)
  • Authentication support - Works with Authelia, Stash API keys, or internal network access
  • Modern UI - GPU-accelerated animations with glassmorphism design

Installation:

Plugin source URL: https://codddarrr.github.io/stashapp-plugins-repo/main/index.yml

Add it in Settings → Plugins → Available Plugins, then install “Stream Queue”

Configuration:

After installing, go to Settings → Plugins → Stream Queue and configure:

  • Number of Streams (default: 1): How many separate queues (1-10)
  • Button Size (default: 32): Size of queue buttons in pixels
  • Show Queue Panel (default: true): Show/hide floating panel
  • Auto-download Playlist (default: false): Auto-download M3U8 on scene add
  • Button Color Hue (default: 260): Color for buttons (0-360 degrees)
  • Max Queue Size (default: 0): Max scenes per queue (0 = unlimited)
  • Streaming Path Pattern (default: /scene/{id}/stream): URL pattern for streams
  • Stash API Key: For users with Stash authentication enabled
  • Stream Base URL: Override URL for internal network access (e.g., http://192.168.1.100:9999)

How it works:

  1. Browse any Stash page with scenes (scenes, performers, tags, studios)
  2. Right-click on a scene thumbnail/card
  3. Click a stream number (1, 2, 3, etc.) from the context menu
  4. Scene is added to that queue
  5. Use the floating panel to manage queues and download M3U8 playlists
  6. Open the downloaded M3U8 file in VLC to play all queued scenes in order

The floating panel can be dragged anywhere on screen and minimized when not needed.

Authentication setup:

The plugin supports three authentication approaches:

Option 1: Authelia Bypass (recommended for Authelia users)
Configure your Authelia to bypass authentication for /scene/*/stream endpoints. See the
README for example YAML configuration.

Option 2: Stream Base URL (recommended for local network)
Set the Stream Base URL to your internal IP (e.g., http://192.168.1.100:9999) to bypass proxy authentication entirely. VLC connects directly to Stash on your local network.

Option 3: Stash API Key (for Stash native auth)
If Stash has its own authentication enabled, generate an API key and add it in plugin settings.

Use cases:

  • Triple Queue: “Watch Now” / “Watch Later” / “Favorites”
  • Mood-Based: Different queues for different moods or contexts
  • Category Separation: Organize by studio, performer, or content type
  • Simple Queue: Single stream for sequential watching

GitHub: GitHub - codddarrr/stashapp-plugins-repo

Let me know if you run into any issues or have suggestions.