H4 Subtitles

Requirements

1. H4-R1acceptedMUST

   The subtitle service and its configured providers MUST be open-source or open subtitle providers; the tool MUST NOT depend on a proprietary or closed subtitle service.

   locked by

   0.20.0 ○ open

2. H4-R2acceptedMUST

   The tool MUST wire Sonarr and Radarr and the subtitle providers via their APIs, and MUST NOT require the household to fetch subtitles by hand.

   locked by

   0.20.0 ○ open

3. H4-R3acceptedMUST

   The tool MUST fetch only the languages named in the household's language profile, in its preference order.

   locked by

   0.20.0 ○ open

4. H4-R4acceptedMUST

   If no language profile is set, the tool MUST enter a no-profile state and say so, and MUST NOT guess a language or fetch arbitrarily.

   locked by

   0.20.0 ○ open

5. H4-R5acceptedMUST

   The tool MUST prove the wiring: each provider's status, an assertion that Sonarr and Radarr are linked and a language profile is set, and a test fetch for a known item that completes.

   locked by

   0.20.0 ○ open

6. H4-R6acceptedMUST

   A configuration that cannot complete a test fetch MUST be reported as unproven, never as ready.

   locked by

   0.20.0 ○ open

7. H4-R7acceptedMUST

   An invalid provider credential MUST fail its check loudly and cause that provider to be skipped until re-proven.

   locked by

   0.20.0 ○ open

8. H4-R8acceptedMUST

   A rate-limited provider MUST be backed off from and reported as rate-limited, not presented as failed for lack of results.

   locked by

   0.20.0 ○ open

9. H4-R9acceptedMUST

   A provider outage MUST mark only that provider unavailable, leaving the others fetching.

   locked by

   0.20.0 ○ open

10. H4-R10acceptedMUST

    The tool MUST track the subtitles it places so a wrong or mistimed subtitle can be replaced rather than duplicated.

    locked by

    0.20.0 ○ open

11. H4-R11acceptedMUST

    A wanted language unavailable for an item MUST be reported as missing, and the tool MUST NOT substitute a different language.

    locked by

    0.20.0 ○ open

12. H4-R12acceptedMUST

    A household member MUST be able to flag a placed subtitle as wrong so it can be re-fetched.

    locked by

    0.20.0 ○ open

13. H4-R13acceptedMUST

    Removing a library item MUST NOT leave orphaned subtitle files that misrepresent the library.

    locked by

    0.20.0 ○ open

14. H4-R14acceptedMUST

    Triggering a fetch, listing missing languages, and running the wiring proof MUST each be reachable non-interactively.

    locked by

    0.20.0 ○ open