Introducing Stash Sorter – Advanced Multi-field & Random Sorting for StashApp

[efirlus]

Hi everyone,

I’m excited to share Stash Sorter, a tool I (obviously Claude) developed to overcome some of the current limitations in StashApp's native sorting system.

While StashApp is an incredible platform, I found myself needing more complex sorting options (like multi-field, interleaved, or additional field sorting) that aren't currently possible through the UI.

Why an external script? (The Technical Limitation)

According to an analysis by Claude Code, the current Stash GraphQL schema is architecturally limited to single-field sorting. As shown in the schema below:

input FindFilterType {
  sort: String                  # Only a single field allowed!
  direction: SortDirectionEnum  # ASC or DESC
  # ...
}

enum SceneSortEnum {
  DATE
  RATING
  PLAY_COUNT
  # ...
}

To support native multi-sort, the backend would need a major overhaul, changing the schema to an array-based input and rewriting the Go backend's SQL generation logic:

# The required (but currently unavailable) structure:
input FindFilterType {
  sorts: [SortInput!]  # Requires an array for multi-sorting
}

input SortInput {
  field: SceneSortEnum
  direction: SortDirectionEnum
}

How Stash Sorter Works

Since a core backend change is a massive undertaking, I built this tool to handle the logic externally. It fetches data via Pure GraphQL, processes complex sorting algorithms (Multi-field, Interleaved, Randomize) on the client side, and updates your Stash views accordingly.

Key Features:

• Multi-field Sorting: Sort by Rating, then Date, then Resolution simultaneously.
• Interleaved Sorting: Mix different performers or tags evenly.
• Less Dependencies: Built with pure GraphQL calls (no stashapp-tools required) for maximum compatibility.

I am not a professional developer (this project was fully orchestrated by Claude Code), so I might not be able to provide deep technical support. However, I’ve made the repository public for anyone who wants to Fork and contribute.

Check it out here: stashsorter

Fork to make it better are more than welcome!

[DogmaDragon]

You can claim the topic https://discourse.stashapp.cc/t/stash-sorter/4838.

[efirlus]

Please just add that, "If there are any parts you'd like to improve, I strongly encourage you to fork the project directly, rather than using requests or replies to me, my repository, or the post. :)"