You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: plugins/StashRandomButton/README.md
+19-5Lines changed: 19 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,23 @@
1
1
# Stash Random Button Plugin
2
2
3
-
https://discourse.stashapp.cc/t/randombutton/1809
3
+
[Plugin thread on Discourse](https://discourse.stashapp.cc/t/randombutton/1809)
4
4
5
-
Adds a "Random" button to the image & scenes page to quickly navigate to a random scene.
5
+
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).
6
6
7
7
## Features
8
-
- Adds a "Random" button to the Stash UI.
9
-
- Selects a random scene via GraphQL query.
8
+
9
+
- Adds a "Random" button to the Stash UI navigation bar.
10
+
- Supports random navigation for:
11
+
-**Scenes** (global and within performer, studio, tag, group)
12
+
-**Images** (global and within a gallery)
13
+
-**Performers** (global)
14
+
-**Studios** (global)
15
+
-**Groups** (global)
16
+
-**Tags** (global)
17
+
-**Galleries** (global)
10
18
- Lightweight, no external dependencies.
19
+
- Uses Stash's GraphQL API.
20
+
- Simple, robust, and easy to maintain.
11
21
12
22
## Installation
13
23
@@ -30,11 +40,15 @@ Adds a "Random" button to the image & scenes page to quickly navigate to a rando
30
40
- The button should appear on those pages.
31
41
32
42
## Usage
33
-
Click the "Random" button in the navigation bar to jump to a random image or scene depending on the tab.
43
+
Click the "Random" button in the navigation bar to jump to a random entity (scene, image, performer, studio, group, tag, or gallery) depending on your current page.
44
+
- On internal entity pages (e.g., performer, studio, group, tag, gallery), the button picks a random scene or image from inside that entity.
34
45
35
46
## Requirements
36
47
- Stash version v0.27.2 or higher.
37
48
38
49
## Development
39
50
- Written in JavaScript using the Stash Plugin API.
40
51
- Edit `random-button.js` to customize and reload plugins in Stash.
52
+
53
+
## Changelog
54
+
- 2.0.0: Major upgrade! Now supports random navigation for performers, studios, groups, tags, galleries, and images (global and internal).
0 commit comments