Skip to content

tvOS: enabling subtitles silences the audio track #147

Description

@altaywtf

On Apple TV, turning subtitles on silences the audio track entirely.

Customer report

Reported 2025-09-23 via support: enabling subtitles in the tvOS app kills audio. The video keeps playing; the sound does not come back until subtitles are turned off again.

Never reproduced internally, never tracked. Surfaced by the audit behind putdotio/putio-web#954, which swept support conversations for TV problems with no engineering issue.

Why it is plausible

tvOS uses react-native-video's native AVPlayer chrome, so subtitle selection goes through Apple's combined Subtitles/Audio panel. Selecting a text track there can change the selected audio track when the media's track groups are ambiguous — a file with sidecar subtitles and multiple or oddly-labelled audio tracks is the shape most likely to trigger it.

That makes it likely to depend on the specific file, which is probably why it has not been seen internally.

Scope

  • Reproduce with a sidecar-subtitle file and with a multi-audio file
  • Determine whether audio is being deselected or muted, and by whom — AVPlayer's group selection, or the app
  • Fix, and cover it so a track-selection regression cannot ship silently

Acceptance criteria

  • Enabling subtitles never changes the audio track or its volume
  • Covered by a test over a file with sidecar subtitles and one with multiple audio tracks

Related: audio-track and subtitle selection on TV recurs across surfaces — roughly 10 support conversations mention subtitles broken or uncontrollable on a TV, and ~7 mention missing audio-track selection.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions