mirror of
https://github.com/stashapp/CommunityScripts.git
synced 2026-06-01 12:23:19 -05:00
127 lines
4.5 KiB
Markdown
127 lines
4.5 KiB
Markdown
# Group Details
|
|
|
|
https://discourse.stashapp.cc/t/group-details/6819
|
|
|
|
`Group Details` is a UI plugin for Stash group card.
|
|
|
|
## Screenshot
|
|
|
|
|
|
|
|
## What It Adds
|
|
|
|
- **Date line:** appends total duration (`H:MM:SS`) to the right side of the date row.
|
|
- **Chip list:** appends a resolution chip (PNG badge) to the end of `.card-popovers`.
|
|
- **Performer chip (optional):** when enabled, appends a performer-count chip with a hover popover.
|
|
- **Tooltips/popovers:** duration and resolution expose native `title` tooltips; performer chip opens a delayed hover popover.
|
|
|
|
## Data Source
|
|
|
|
Metrics are computed in-browser from GraphQL `findGroup` scene data (`id`, `title`, `files { duration height }`, `performers { id name image_path }`, `groups { group { id } scene_index }`).
|
|
|
|
## Scene Filtering
|
|
|
|
When **Include all scenes** is disabled (default), scenes are included only if `scene_index` is:
|
|
|
|
- `null`, or
|
|
- an integer in `0..89`
|
|
|
|
Exception: if the group has exactly **one scene**, scene-index filtering is bypassed for that group.
|
|
|
|
When **Include all scenes** is enabled, all returned scenes are included regardless of `scene_index`.
|
|
|
|
|
|
|
|
## Performer Metric (Optional)
|
|
|
|
When **Include performers** is enabled:
|
|
|
|
- The plugin builds a union of performers across all scenes included by the same filtering rules used for duration/resolution.
|
|
- A performer-count chip (`user` icon + count) is appended to `.card-popovers`.
|
|
- Hovering the chip opens a performer drawer styled to match Stash scene-card behavior:
|
|
- centered popover aligned to the chip
|
|
- fixed-size performer tiles with image + name badge
|
|
- centered wrapping rows (including centered final row)
|
|
- Hover behavior uses delayed open/close timing (`~200ms` enter and leave) and fade transitions to mimic native feel.
|
|
|
|
## Sorting
|
|
|
|
Duration tooltip scene lines are sorted by:
|
|
|
|
1. `scene_index` ascending (`null` sorts as `90`)
|
|
2. duration descending
|
|
3. scene `id` ascending (stable tie-break)
|
|
|
|
## Duration Metric
|
|
|
|
- Uses each included scene's **max file duration**.
|
|
- Card value is total duration displayed as `H:MM:SS`.
|
|
- Tooltip lists every included scene as:
|
|
- `N. Title H:MM:SS` when `scene_index` is present
|
|
- `Title H:MM:SS` when `scene_index` is null
|
|
|
|
## Resolution Metric
|
|
|
|
Average resolution uses vertical pixels (`height`) from each included scene's tallest file:
|
|
|
|
- For groups with **exactly one total file**, the duration gate is bypassed.
|
|
- Otherwise, only scenes with `duration > 360` are eligible.
|
|
- Resolution average is `round(sum(height) / count)`.
|
|
- Tooltip format is:
|
|
- `Resolution Average: <N>p`
|
|
- or `Resolution Average: —` when no eligible average exists.
|
|
|
|
Resolution chip empty/dash behavior:
|
|
|
|
- If there are no files (or single-file case with unusable height): render nothing.
|
|
- If `totalFileCount > 1` and no eligible average: render `—`.
|
|
|
|
## Resolution Badge Mapping
|
|
|
|
The plugin picks a PNG badge using a 2% tolerance (`>= 98%` of target resolution):
|
|
|
|
- `< 234` -> `144p.png`
|
|
- then highest match from:
|
|
- `240`, `360`, `480`, `720`, `1080`, `1440 (2k)`, `2160 (4k)`, `2880 (5k)`, `3160 (6k)`, `4320 (8k)`
|
|
|
|
## Assets And Build
|
|
|
|
Badges are authored as PNG files in `assets/` and embedded into `images.js` as base64 data URIs. The image.js provides base64 data back to the plugin and users can ultimately swap a logo on their plugin for further customiation if desired.
|
|
`images.js` is generated output and should not be hand-edited.
|
|
|
|
- Source files: `plugins/GroupDetails/assets/*.png`
|
|
- Generated file: `plugins/GroupDetails/images.js`
|
|
- Build script: `plugins/GroupDetails/build.sh`
|
|
|
|
### Regenerating `images.js`
|
|
|
|
From `plugins/GroupDetails/`:
|
|
|
|
```bash
|
|
bash build.sh
|
|
```
|
|
|
|
What `build.sh` does:
|
|
|
|
- validates that `assets/` exists and contains at least one `*.png`
|
|
- reads `assets/*.png`
|
|
- sorts filenames deterministically (stable diffs)
|
|
- rewrites `images.js` with `window.GroupDetailsImages = { ... }`
|
|
|
|
Commit both:
|
|
|
|
- the changed PNG files in `assets/`
|
|
- the regenerated `images.js`
|
|
|
|
## Updates Not Showing?
|
|
|
|
After editing plugin files, perform a **full page reload** (F5 / Ctrl+Shift+R). In-app navigation can keep an older script in memory.
|
|
|
|
## Gen AI Assisted Plugin Authorship
|
|
This plugin was generated with the help of Generative AI (Cursor).
|
|
|
|
Per the draft guidelines of [#678]
|
|
- ✅ LLM use is openly disclosed.
|
|
- ✅ Code is reviewed by a human.
|
|
- ✅ Human testing and validation was performed.
|
|
- ✅ You take full responsibility for the code (including license compliance). |