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

Add the missing-subtitles queue #202

New Issue
Closed
opened 2026-08-24 21:28:40 +01:00 by naps62-yolo · 1 comment
naps62-yolo commented 2026-08-24 21:28:40 +01:00
Owner
Copy Link
Copy Source

Add a missing-subtitles queue alongside the no-PT-source queue, so subtitle
failures are visible instead of silent.

It lists media files with an unsatisfied wanted language and why, from the
attempt rows (#186): no candidate found, translation failed, waiting on budget
(#197), sync rejected (#194), provider unreachable. Grouped by title, not one
row per episode — a season that failed is one entry, the same restraint §9.5
applies to notifications.

Each entry offers the actions that resolve it: manual search, manual translate,
retry. All of them are #199 calls.

Nothing here notifies. §9.5's three events stand unchanged.

area/web: through the impeccable skill, matching the existing queues view.

Depends on: #196, #199

Add a missing-subtitles queue alongside the no-PT-source queue, so subtitle failures are visible instead of silent. It lists media files with an unsatisfied wanted language and why, from the attempt rows (#186): no candidate found, translation failed, waiting on budget (#197), sync rejected (#194), provider unreachable. Grouped by title, not one row per episode — a season that failed is one entry, the same restraint §9.5 applies to notifications. Each entry offers the actions that resolve it: manual search, manual translate, retry. All of them are #199 calls. Nothing here notifies. §9.5's three events stand unchanged. `area/web`: through the `impeccable` skill, matching the existing queues view. Depends on: #196, #199
naps62-yolo added this to the Subtitles milestone 2026-08-24 21:28:40 +01:00
naps62-yolo added the area/webdifficulty/moderatephase/9-subtitlestype/feature labels 2026-08-24 21:28:40 +01:00
naps62-yolo added a new dependency 2026-08-24 21:29:28 +01:00
#196 Close the subtitle gap in the reconcile loop
naps62-yolo added a new dependency 2026-08-24 21:29:28 +01:00
#199 Serve the subtitle API
naps62-yolo commented 2026-08-25 03:17:12 +01:00
Author
Owner
Copy Link
Copy Source

Implemented the missing-subtitles queue: GET /api/queues/subtitles, grouped by title like /api/queues/attention — one row per movie, one row per series. Each gap carries language + why, reusing reason_of's vocabulary from #201 (no_candidates, capped, failed + last_failure as detail), plus a sync_rejected gap for a subtitle that exists but whose alass sync was rejected (#194) — read straight off subtitle_files.sync_rejected, not the attempt table. Gaps for a language no longer in wanted_languages are dropped, matching #201's bound. Episodes in a series collapse into one season row when every one of them carries the identical gap (§9.5's restraint applied to subtitles); episodes with differing gaps stay listed individually.

Frontend: a third deck-group lane, "missing subtitles", added to the existing queues view (web/index.html, web/src/main.ts, web/src/queues.ts) alongside "no pt source" and "needs decision", built through the impeccable skill. It reuses the same markup/classes as its two siblings and missingChipLabel for chip text (extended with a sync_rejected → "sync flagged" label). Each row opens the title's own detail page, where the existing #203 fetch/translate panel already carries the resolving actions (manual search, manual translate, retry-by-searching-again) — the queue does not duplicate a candidate picker. Verified live in a browser against seeded gap data: renders correctly, wraps chips cleanly at both desktop and mobile widths, and the OPEN action lands on the panel with the same gap already shown.

Branch: subtitles/202-subs-queue. just ci passed (683/683 tests, lint and token-gate clean) through the gate, run once at the end.

Findings

  • Pre-existing gap, not touched here: nothing deletes a subtitle_attempts row when an operator narrows wanted_languages in /settings (#198) — the row just sits there. I bounded the new queue by the current wanted set (matching #201's missing_for) so it doesn't show stale entries, but the underlying row is still never cleaned up; #201's title-detail page has the same latent staleness if a language is re-added later with old attempt history. Might be worth a follow-up issue for a cleanup step in the settings-update handler or the reconcile loop.
Implemented the missing-subtitles queue: `GET /api/queues/subtitles`, grouped by title like `/api/queues/attention` — one row per movie, one row per series. Each gap carries language + why, reusing `reason_of`'s vocabulary from #201 (`no_candidates`, `capped`, `failed` + `last_failure` as `detail`), plus a `sync_rejected` gap for a subtitle that exists but whose `alass` sync was rejected (#194) — read straight off `subtitle_files.sync_rejected`, not the attempt table. Gaps for a language no longer in `wanted_languages` are dropped, matching #201's bound. Episodes in a series collapse into one season row when every one of them carries the identical gap (§9.5's restraint applied to subtitles); episodes with differing gaps stay listed individually. Frontend: a third `deck-group` lane, "missing subtitles", added to the existing queues view (`web/index.html`, `web/src/main.ts`, `web/src/queues.ts`) alongside "no pt source" and "needs decision", built through the `impeccable` skill. It reuses the same markup/classes as its two siblings and `missingChipLabel` for chip text (extended with a `sync_rejected` → "sync flagged" label). Each row opens the title's own detail page, where the existing #203 fetch/translate panel already carries the resolving actions (manual search, manual translate, retry-by-searching-again) — the queue does not duplicate a candidate picker. Verified live in a browser against seeded gap data: renders correctly, wraps chips cleanly at both desktop and mobile widths, and the OPEN action lands on the panel with the same gap already shown. Branch: `subtitles/202-subs-queue`. `just ci` passed (683/683 tests, lint and token-gate clean) through the gate, run once at the end. ## Findings - Pre-existing gap, not touched here: nothing deletes a `subtitle_attempts` row when an operator narrows `wanted_languages` in `/settings` (#198) — the row just sits there. I bounded the new queue by the current wanted set (matching #201's `missing_for`) so it doesn't show stale entries, but the underlying row is still never cleaned up; #201's title-detail page has the same latent staleness if a language is re-added later with old attempt history. Might be worth a follow-up issue for a cleanup step in the settings-update handler or the reconcile loop.
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/web difficulty/moderate phase/9-subtitles type/feature
Milestone
No items
No Milestone Subtitles
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
#196 Close the subtitle gap in the reconcile loop
yolo/arr
#199 Serve the subtitle API
yolo/arr
Reference: yolo/arr#202