Stash Battle

dtt · January 8, 2026, 12:48pm


	Summary	Adds an ELO based ranking system for scenes.
	Repository	https://github.com/dtt-git/stash-battle/tree/main/plugins/stash-battle
	Source URL	https://dtt-git.github.io/stash-battle/main/index.yml
	Install	How to install a plugin?

Demo Video (NSFW)

Filtering demo on Ver 2.3.0 (NSFW)

Stash Battle

A head-to-head scene comparison plugin for Stash that uses an ELO-style rating system to help you rank your scenes.

Overview

Stash Battle presents you with two scenes side-by-side and asks you to pick the better one. Based on your choices, scene ratings are automatically updated using an ELO algorithm. Over time, this aims to build an accurate ranking of your entire library based on your personal preferences.

Features

Three Comparison Modes:
- Swiss – Fair matchups between similarly-rated scenes. Both scenes’ ratings adjust based on the outcome.
- Gauntlet – Place a scene in your collection. It climbs from the bottom, challenging each scene above it until it loses, then settles into its final position.
- Champion – Winner stays on. The winning scene keeps battling until it’s dethroned.
Filtering: Apply any filters on the scenes page before opening Battle. What you see on the scenes page is what you get in Stash Battle. By default, filtered scenes appear on the left (scenes to rate) and opponents come from your full library on the right.

Installation

Install at your own risk, nearly entirely vibe coded for myself but I review code and test as thoroughly as I can.

Recommend saving a backup of your database beforehand (Settings → Interface → Editing) just in case.

Source Index:

Add this repo’s source index: https://dtt-git.github.io/stash-battle/main/index.yml to Stash plugin sources
Checkbox the Stash Battle package and click Install

Manual Download:

Download the /plugins/stash-battle/ folder to your Stash plugins directory

Usage

Optional Step: Change Rating System Type to “Decimal” (Settings → Interface → Editing)

Navigate to Homepage or any Scenes page in Stash
(Optional) Apply any filters or search to narrow down which scenes you want to rate
Click " Battle " button in the nav menu
1. Screenshot 2026-02-28 145126477×516 6.78 KB
Choose your preferred comparison mode
Click on a scene (or use arrow keys) to pick the winner
Watch your rankings evolve over time!

As well you can open battle on a scene page which puts that scene into battle right away.

How It Works

The plugin uses an ELO-inspired algorithm where:

Beating a higher-rated scene earns more points than beating a lower-rated one
Losing to a lower-rated scene costs more points than losing to a higher-rated one
Ratings are stored in Stash’s native rating100 field (1-100 scale which is why changing to decimal rating system type is recommended)

Dynamic K-Factor: Rating changes scale based on a scene’s play_count (similar to chess ELO where new players’ ratings are more volatile):

Play Count	K-Factor	Behavior
0-2	12	New scenes adjust quickly to find their true rating
3-7	8	Settling in with moderate changes
8-14	6	Established scenes change more slowly
15+	4	Very stable ratings that resist large swings

In Gauntlet and Champion mode, only the active climber’s rating changes during a run (opponents are benchmarks). Climber wins use a high K-factor so placements move quickly.

lowgrade12 · January 11, 2026, 6:21am

How hard would it be to do this same thing for rating performers?

dtt · January 11, 2026, 5:42pm

I’d imagine not too hard if their data is similar to scenes and can be queried with the API as well

lowgrade12 · January 12, 2026, 2:53pm

i have something working that i forked from your repo. still doing some fine tuning.

kind of reminds me of the old Hot or Not so that’s what i ended up calling it

TenHundred · January 13, 2026, 5:57am

Hello. I saw your post and loved the idea. I found going through each new scene in my Stash and determining an accurate rank a bit tedious. It inspired me to make something that I could use in my own setup to rank my scenes in a more gamified way. So instead of using this custom ELO you’ve made (which I find would be preferable due to it’s higher precision), I simply use the built in decimal ranking system.

I implemented:

Similar gamemodes to yours. Including “Unranked” gamemode which follows the champion gamemode but with only new scenes so I can quickly establish ranks for new scenes
VIM keybinds for voting, skipping, etc
I prioritized screen width of each scene in the UI over explicit context, but I think more can be adjusted in the UI as I go on
I also by default play both scene’s audio and can isolate to one by hovering
A rank slider preview to show all neighbors of both current scenes and an animation to show how each scene adjusts based on the output of the vote
Matched the community Modern Dark theme in my design for continuity

Here is a demo video I made for context if it will upload (NSFW)

It looks like others are also inspired by your concept, and I look forward to seeing what others come up with to potentially implement into my own solution!

In the future I want to add:

A persistent solution to win/ loss for better matchups (right now I simply use browser local storage)
Filters for only matchmaking within certain whitelisted/ blacklisted tags at a time (new gamemode)

Maybe we should make a PR to the main Stash repo for more precise rankings (i.e. 0-1000)

panar · January 13, 2026, 6:35am

It would be cool if we can filter only scenes from specific studios or performers! Consider this in the next update!

Dining9093 · January 13, 2026, 10:15am

This is a great way to score scenes!

Could you make it work for images too?

dtt · January 13, 2026, 10:37pm

Nice!! I really like the ranked slider, maybe I’ll incorporate that sometime. I’m really glad to see all the people who find this a fun concept as well

I did have an unrated mode initially during development but scrapped it because it was starting to feel overengineered. I may add some sort of filtering in for it later.

Right now the Gauntlet mode is supposed to be the placement mode to find where a scene sits in the entire collection. Although no way to select specific scenes currently.

Unfortunately there’s no way to add custom metadata fields I think, originally I did have the W-L data also stored in LocalStorage but I wanted to be able to rank stuff from my phone as well so I got rid of any local persistence data for now.

That would improve the ELO system I’m doing a bit! I have a lot of videos that have same scores but I figured over time it would all naturally spread out good enough anyways.

dtt · January 13, 2026, 10:41pm

I may think about adding some filtering in the future, right now I’m only planning on adding match state persistence and changing the preview to open link instead of new tab because I have to open a separate window when using the plugin with through MultiFunPlayer.

But feel free to fork a version of your own or submit a PR!

EDIT: After thinking about it a bit filtering might be easier than I thought. I could just use the built in Stash filtering and just check for what you currently have filtered and apply that to the plugin. So I may tinker with that soon.

dtt · January 13, 2026, 10:44pm

Thanks! I don’t have any plans to make it work for images right now because I don’t use images on Stash

Maybe in the future I’ll make a big 2.0 update for it to work with everything and add filtering.

It doesn’t seem too hard to adapt what I have to work for other Stash data (see: Hot or Not), so I encourage you to try it for yourself

JAVegeta420 · January 13, 2026, 11:40pm

If you need a possible reference for this, I did something similar with a plugin I made where I grab the url params window.location.search and then parse that into the filter used in the GQL call. This is written specifically for filtering images within a gallery but it shouldn’t be too tough to adapt it to handle filtering a different object type:

github.com/stashapp/CommunityScripts

plugins/imageGalleryNavigation/imageGalleryNavigation.js

c1a022430


      
              per_page: -1,
              sort: searchParams.has("sortby") ? searchParams.get("sortby") : "title",
              direction: searchParams.has("sortdir")
                ? searchParams.get("sortdir").toUpperCase()
                : "ASC",
            };
          
            return findFilter;
          }
          
          function getImageFilter(galleryID, searchParams) {
            var imageFilter = {
              galleries: { value: galleryID, modifier: "INCLUDES_ALL" },
            };
          
            if (searchParams.has("c")) {
              searchParams.getAll("c").forEach((cStr) => {
                // Parse filter condition string.
                cStr = cStr.replaceAll("(", "{").replaceAll(")", "}");
                cObj = JSON.parse(cStr);

TenHundred · January 14, 2026, 4:15am

Nice!! I really like the ranked slider, maybe I’ll incorporate that sometime. I’m really glad to see all the people who find this a fun concept as well

I’m glad you like it too. The animations there are proving a pain. I’m working on implementing an infinite horizontal scroll for selecting scenes from there to rank but it’s also proving a pain getting the fine details right.

I did have an unrated mode initially during development but scrapped it because it was starting to feel overengineered. I may add some sort of filtering in for it later.

Right now the Gauntlet mode is supposed to be the placement mode to find where a scene sits in the entire collection. Although no way to select specific scenes currently.

Yes various sorting filters for tags, unranked scenes, performers, etc could be a nice addition.

Unfortunately there’s no way to add custom metadata fields I think, originally I did have the W-L data also stored in LocalStorage but I wanted to be able to rank stuff from my phone as well so I got rid of any local persistence data for now.

I wasted some time today attempting to write a Python back-end to write to an sqlite DB win/ loss stats. Writing to DB went fine but it’s just not capable to read from the DB synchronously I guess. I ended up abandoning this.

I had the same conclusion with local browser storage. It didn’t satisfy me that it wouldn’t persist across browsers/ sessions. The only solution I could think of for now is writing something like JSON to the details section of the scene, but that’s finicky and not preferable. I found out there are custom fields for performers, adding this to scenes would be helpful too.

That would improve the ELO system I’m doing a bit! I have a lot of videos that have same scores but I figured over time it would all naturally spread out good enough anyways.

Yeah I think it’s kind of a niche request and most users don’t require this much precision.

I don’t mean to hijack your plugin post. I am thinking maybe it is good to just bounce ideas of each other to improve. But please let me know if it would be better for me to discuss elsewhere. But here’s the v2 of my version I’m working on I thought I’d share.

The new features I implemented are:

Easy tagging scenes modal popup (I don’t know if there is already a good plugin for tagging better but I found the native interface slow)
A statistics page demonstrating the nature of my rankings. I think the zero-sumness is important to properly space each scene from another instead of inflating and having a bunch in the range of 8-10 which I found was happening back when I was manually rating. As you can see I need to do some more ranking to smooth my curve.
Major/ minor votes. Major vote asserts 2x the amount of ELO as a minor. For faster sorting of scenes which one feels strongly about
Top tags (Just more visualization for myself)
Better modal popups, UI refinements, and keybinds

Demo V2 (NSFW)

dtt · January 14, 2026, 3:15pm

Are you planning on releasing it? It would be better to create your own plugin thread so it doesn’t get noisy here

TenHundred · January 14, 2026, 5:03pm

Are you planning on releasing it? It would be better to create your own plugin thread so it doesn’t get noisy here

Haha no not particularly. It’s more so just for personal use and I just wanted to share for the purposes of sharing and discussing.

Yeah I totally understand and will refrain from bogging down this specific thread.

I’m excited to see how this plugin develops and am happy to assist in terms of feedback or even maybe some PRs when I get the chance!

dtt · January 25, 2026, 2:17am

Updated to Ver 2.0.0:

Added filtering
- Uses the current set Stash filter for the left side challenger pool. It should match whatever query and filters you have on the scenes page
Changed “Click to open video” to be a redirect instead of opening in a new tab
Added LocalStorage state persistence
- When opening and closing the modal now it should retain the state so you don’t accidentally lose your progress
Modal open button now appears on scene pages

Things should be much easier now especially for MFP users like myself.

spaceyuck · January 26, 2026, 7:40am

Hi,

I love the idea of this, but it is effectively unusable for me, because it is very very slow, it takes like 15 to 30 seconds to load the next pair of scenes.

The bottleneck seems to be the following GraphQL query, which if I read that correctly pulls the entire scene list each time:

{
“query”: "\n query FindScenesByRating($filter: FindFilterType, $scene_filter: SceneFilterType) {\n findScenes(filter: $filter, scene_filter: $scene_filter) {\n scenes {\n \n id\n title\n date\n rating100\n paths {\n screenshot\n preview\n }\n files {\n duration\n path\n }\n studio {\n name\n }\n performers {\n name\n }\n tags {\n name\n }\n \n }\n }\n }\n ",
“variables”: {
“filter”: {
“direction”: “DESC”,
“per_page”: -1,
“sort”: “rating”
},
“scene_filter”: null
}
}

It takes 10 to 20 seconds per call, is called twice, and has a response size of around 20 MB. I have around 20K scenes.

Is it really necessary to pull the entire scene list on every load, when at most two entries got changed by the last rating?

bliks6 · January 26, 2026, 2:35pm

Updated to the latest version and it’s a heck of a lot slower than prior versions. I didn’t do a deep dive like the commenter above me, but I’ve noticed it loads slower. I would be happy to provide extra details if required. Latest stable version of stash and plugin.

Also, any plans on updating the scene battle plugin or is that someone else’s baby? You’ve made some slick improvements to the idea!

dtt · January 27, 2026, 6:10am

Sorry about that!

Will put out a fix tomorrow. Definitely don’t need to pull the list every time. I was just quickly throwing features on for myself and my library is way smaller (less than 900) so I didn’t notice a slowdown.

I’ll be more thorough with future updates since I’m realizing it’s not just me using this anymore.

dtt · January 27, 2026, 6:13am

I’m not sure what you mean, are you asking if I have future updates planned?

bliks6 · January 27, 2026, 1:09pm

I’m an idiot and got plugins mixed up. That’s what I get for posting before having my coffee. Ignore me and have a great day!

I deleted my other post by accident.