yolo/arr
3
0
Fork 0
Code Issues 12 Pull Requests Actions Packages Projects Releases Wiki Activity

Return seasons and episodes newest-first #162

New Issue
Closed
opened 2026-08-24 11:23:47 +01:00 by naps62-yolo · 1 comment
naps62-yolo commented 2026-08-24 11:23:47 +01:00
Owner
Copy Link
Copy Source

Seasons come back oldest-first, so a series detail page opens on specials and
season 1 while the current season sits furthest from the eye. Same for episodes
within a season.

What to change

Per the amended design, seasons within a series and episodes within a season
are returned newest-first. Change the ordering in the API rather than in the
SPA — it is the canonical shape and every consumer should see it.

The queries live in crates/arr-api/src/series.rs: the season list, the
episode list that hangs off it, and the per-series file listing if it orders by
season.

Done looks like

  • GET /api/series/{id}/seasons returns the highest season number first, with
    season 0 wherever descending numeric order puts it.
  • Episodes within each season are highest-number first.
  • The SPA renders the new order with no client-side sorting added.
  • crates/arr-compat still serves Jellyseerr correctly. Check whether the shim
    assumes ascending order anywhere and fix it if so.
  • Tests assert the direction.

Non-goals

  • No UI toggle between ascending and descending.
  • Movie and release ordering are untouched.

Depends on: #159

Seasons come back oldest-first, so a series detail page opens on specials and season 1 while the current season sits furthest from the eye. Same for episodes within a season. ## What to change Per the amended design, seasons within a series and episodes within a season are returned newest-first. Change the ordering in the API rather than in the SPA — it is the canonical shape and every consumer should see it. The queries live in `crates/arr-api/src/series.rs`: the season list, the episode list that hangs off it, and the per-series file listing if it orders by season. ## Done looks like - `GET /api/series/{id}/seasons` returns the highest season number first, with season 0 wherever descending numeric order puts it. - Episodes within each season are highest-number first. - The SPA renders the new order with no client-side sorting added. - `crates/arr-compat` still serves Jellyseerr correctly. Check whether the shim assumes ascending order anywhere and fix it if so. - Tests assert the direction. ## Non-goals - No UI toggle between ascending and descending. - Movie and release ordering are untouched. --- Depends on: #159
naps62-yolo added this to the Feedback pass milestone 2026-08-24 11:23:47 +01:00
naps62-yolo added the difficulty/easyarea/apitype/featurephase/6-tv labels 2026-08-24 11:23:47 +01:00
naps62-yolo added a new dependency 2026-08-24 11:23:53 +01:00
#159 Amend DESIGN.md for the feedback pass
naps62-yolo commented 2026-08-24 12:09:58 +01:00
Author
Owner
Copy Link
Copy Source

Out of scope, left alone: GET /api/series/{id}/files orders by media_files.path, not by season/episode number. Path sort puts Season 01 before Season 02, so the files section still reads oldest-first and does not follow §9.6. Worth a follow-up if that listing should match the new direction.

Out of scope, left alone: `GET /api/series/{id}/files` orders by `media_files.path`, not by season/episode number. Path sort puts Season 01 before Season 02, so the files section still reads oldest-first and does not follow §9.6. Worth a follow-up if that listing should match the new direction.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/api
arr-api
 area/ci
CI and test harness
 area/compat
arr-compat
 area/core
arr-core
 area/daemon
arr-daemon
 area/db
arr-db
 area/dl
arr-dl
 area/indexer
arr-indexer
 area/infra
workspace and tooling
 area/meta
arr-meta
 area/parse
arr-parse
 area/probe
arr-probe
 area/subs
arr-subs crate: providers, extraction, translation, sync
 area/web
web/
 difficulty/easy
bounded, obvious approach, few files
 difficulty/hard
subtle correctness or cross-cutting
 difficulty/moderate
multiple files, judgement, an interface to design
 difficulty/trivial
one file, mechanical, no design decisions
 phase/1-skeleton
workspace, CI, config, database, empty API and SPA
 phase/2-logic
parsing and policy engine, pure, no network
 phase/3-sourcing
TMDB and Prowlarr, read-only
 phase/4-movies
movies end to end
 phase/5-ui
search, buckets, library views, queues
 phase/6-tv
seasons, episodes, tracking, derived status
 phase/7-people
owner tags and notifications
 phase/8-compat
Jellyseerr shim
 phase/9-subtitles
build order: subtitles, DESIGN.md §15
 type/bug
type/chore
type/feature
type/test
No labels area/api difficulty/easy phase/6-tv type/feature
Milestone
No items
No Milestone Feedback pass
Projects
Clear projects
No projects
Assignees
Clear assignees
hermes (Hermes (agent)) naps62 (Miguel Palhas) naps62-yolo (naps62-yolo (agent))
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Depends on
#159 Amend DESIGN.md for the feedback pass
yolo/arr
Reference: yolo/arr#162