RandomButton

Plugins
, , , , , , ,
1

:red_exclamation_mark: Notice
If you are the author of this plugin, you can claim this topic by clicking > at the bottom of this post. Select Something Else as a reason and leave a comment explaining you want to claim the topic. Include a link to your git profile or pull request showing ownership of the plugin.
:placard: Summary Adds a button to quickly jump to a random scene, image, performer, studio, group, tag, or gallery, both on overview and internal entity pages.
:link: Repository https://github.com/stashapp/CommunityScripts/tree/main/plugins/StashRandomButton
:information_source: Source URL https://stashapp.github.io/CommunityScripts/stable/index.yml
:open_book: Install How to install a plugin?

Stash Random Button Plugin

Adds a “Random” button to the Stash UI, letting you instantly jump to a random scene, image, performer, studio, group, tag, or gallery—including random “internal” navigation (e.g. a random scene inside a studio).

Features

  • Adds a “Random” button to the Stash UI navigation bar.
  • Supports random navigation for:
    • Scenes (global and within performer, studio, tag, group)
    • Images (global and within a gallery)
    • Performers (global)
    • Studios (global)
    • Groups (global)
    • Tags (global)
    • Galleries (global)
  • Lightweight, no external dependencies.
  • Uses Stash’s GraphQL API.
  • Simple, robust, and easy to maintain.

Installation

  1. Download the Plugin
    git clone https://github.com/Nightyonlyy/StashRandomButton.git
  2. Copy to Stash Plugins Folder
    • Move the StashRandomButton folder to:
      • Windows: %USERPROFILE%\.stash\plugins\
      • Linux/Mac: ~/.stash/plugins/
    • Ensure it contains:
      • random-button.js
      • random-button.yml
      • random_button.css
  3. Reload Plugins
    • In Stash, go to Settings > Plugins and click “Reload Plugins”.
    • The button should appear on those pages.

Usage

Click the “Random” button in the navigation bar to instantly jump to a random item, with behavior depending on your current page:

  • Scenes:

    • On the main scenes page, the button selects a random scene from all scenes in your library.
    • On a performer, studio, tag, or group scenes page, it picks a random scene from within that entity.
    • When viewing a scene’s detail page, clicking “Random” again selects a random scene from all scenes (not just from the previous filter).

  • Groups:

    • On the main groups page, the button picks a random group.
    • Inside a group (group’s scenes page), it selects a random scene from within that group.

  • Galleries & Images:

    • On the main galleries page, the button picks a random gallery.
    • Inside a gallery (gallery’s page), it selects a random image from that gallery.
    • When viewing an individual image (image detail page), the button selects a random image from all images in the database, not just from the current gallery.

  • Performers:

    • On the main performers page, it picks a random performer.
    • Inside a performer’s page (performer’s scenes), it selects a random scene from that performer.
    • When viewing a scene’s detail page, clicking “Random” again picks a random scene from all scenes.

  • Studios:

    • On the main studios page, the button picks a random studio.
    • Inside a studio’s page (studio’s scenes), it selects a random scene from that studio.
    • When viewing a scene’s detail page, clicking “Random” again selects a random scene from all scenes.

  • Tags:

    • On the main tags page, it picks a random tag.
    • Inside a tag’s page (tag’s scenes), it selects a random scene from that tag.
    • When viewing a scene’s detail page, clicking “Random” again picks a random scene from all scenes, regardless of tag.

Tip: The Random button always selects from the full library when you are on a detail (scene or image) page, regardless of how you navigated there.

Requirements

  • Stash version v0.27.2 or higher.

Changelog

  • 2.0.1:
    • The Random button now works on scene and image detail pages: when viewing an individual scene or image, clicking “Random” selects a random scene or image from the entire database.
    • Improved context awareness for the Random button on all major Stash entities (scenes, performers, studios, tags, groups, galleries, images).
    • When inside a group, tag, studio, performer, or gallery, the button picks a random scene or image from within that entity.
    • When on a group, tag, studio, performer, or gallery detail page (not listing scenes/images), the Random button selects a random group, tag, studio, performer, or gallery respectively.
    • Updated documentation.
  • 2.0.0: Major upgrade! Now supports random navigation for performers, studios, groups, tags, galleries, and images (global and internal).
  • 1.1.0: Initial public release with support for random scenes.
2
3