JellyfinLanguage: ISO 639-2 three-letter language codes used by Jellyfin Only includes languages supported by Roku OS locales

applyLiveDirectPlayFallback: Flags that a transcode retry is available for live streams attempting direct play. Live direct play may fail on Roku if the server overestimates compatibility. VideoPlayerView observes transcodeAvailable to retry with transcoding on error.

findBestAudioStreamIndex: Primary function for selecting the best audio stream

Selection priority when playDefault = true (Jellyfin: "Play default audio track regardless of language"):

1. Filter by IsDefault = true streams (ignore language preference)
2. If multiple IsDefault streams, use language preference as tiebreaker
3. If still multiple or no language match, apply hardware optimization
4. If no IsDefault streams exist, fall back to language preference → hardware optimization

Selection priority when playDefault = false:

1. Filter by language preference (completely ignore IsDefault flag)
2. If multiple language matches, apply hardware optimization
3. If no language matches, apply hardware optimization to all streams

Roku OS Language Fallback: When preferredLanguage is blank/empty, automatically uses the Roku device's OS language (from m.global.device.locale) as fallback for better out-of-box experience (see issue #179)

Hardware optimization:

• Prefer streams matching device's max channel capability
• Among matches, prefer direct-playable codecs
• Fall back intelligently based on channel counts

findDefaultSubtitleStreamIndex: Determine which subtitle stream will be auto-selected during playback Mirrors the selection logic in defaultSubtitleTrackFromVid() and sortSubtitles() (Subtitles.bs) for use on the render thread without requiring playback-specific dependencies (buildURL, etc.)

Selection logic (by subtitleMode): "none" → No subtitles "default" → First forced or default subtitle matching preferred language "always" → First non-forced subtitle matching preferred language; fallback to forced/default "onlyforced"→ First forced subtitle matching preferred language "smart" → First non-forced subtitle when audio language differs from preference; fallback to forced/default

Priority ordering: forced > default > normal; preferred language first within each category Text subtitles are tried first; non-text only used when playbackSubsOnlyText is false

findDirectPlayableStreamByChannelCount: Finds a direct-playable stream with specific channel count

getDeviceAudioCapabilities: Detects device audio codec and channel support

Strategy:

• Use combined check (no PassThru) for 6-channel and below (safe, checks both)
• ALWAYS verify 8-channel with PassThru: 1 (combined check can lie)
• Roku max native decode is 6 channels (varies by model)
• 8-channel requires HDMI passthrough to receiver/soundbar

maxChannels (integer: 2, 6, or 8) - Maximum supported audio channels supports8Channel (boolean) - True if HDMI passthrough supports 8-channel audio

getTranscodeReasons: Extracts the transcode reason codes from a Jellyfin transcoding URL. The server embeds reasons as a comma-separated TranscodeReasons query parameter. Used to detect VideoLevelNotSupported so a direct-play fallback can be attempted.

isStreamDirectPlayable: Checks if an audio stream can be directly played by the device

For 8-channel: MUST use PassThru: 1 (only HDMI passthrough, Roku can't decode 8-channel) For 6-channel and below: Use combined check (no PassThru) - checks both Roku and HDMI

mapRokuLocaleToJellyfinLanguage: Converts Roku locale codes to Jellyfin ISO 639-2 language codes

Maps Roku device locale (e.g., "en_US", "fr_CA") to Jellyfin's 3-letter language codes. Extracts base language from locale and maps to standard ISO 639-2 codes.

Supported Roku locales:

• en_US, en_GB, en_CA, en_AU → eng (English)
• es_ES, es_MX → spa (Spanish)
• pt_BR → por (Portuguese)
• fr_CA → fra (French)
• de_DE → deu (German)
• it_IT → ita (Italian)

resolvePlayDefaultAudioTrack: Resolves the playDefaultAudioTrack setting value

Checks JellyRock override setting first, then falls back to web client setting. Ensures a valid boolean is always returned.

selectBestStreamByHardware: Selects the best audio stream based on device capabilities

Priority:

1. Prefer streams matching device's max channel capability (for quality)
2. Among matching streams, prefer direct-playable codecs
3. Fall back intelligently based on channel counts

selectSubtitleByMode: Apply subtitle mode selection logic to sorted subtitle entries Mirrors defaultSubtitleTrack() in Subtitles.bs