Check if a specific value is inside of an array

Computes a broadcast program's elapsed-time percentage. Programs are live broadcasts, not streamed media — so "progress" is wall-clock elapsed, not UserData.PlayedPercentage. Returns 0 (not 100) for finished programs because JRPoster only cleanly removes the VideoProgressBar child when playedPercentage = 0.

displayToast: Display a transient toast notification via the scene-level Toast component.

Filters an array of nodes, excluding any whose nodeKey value appears in excludeArray

Traverses up the node hierarchy to find a parent node of a specific type This is useful for finding the main component when handling button events

Traverses up the node hierarchy to find a parent node that has a specific field This is useful for finding the main component when handling button events

convert iso date string to a human readable date string eg. "March 13th, 2014"

Format time as 12 or 24 hour format based on system clock setting NOTE: This is NOT used by app's clock, only for displaying time in dialogs

Returns the current API version from global state with a safe default of 2. Works in both class and non-class contexts (components, namespaces, functions). This is the single source of truth for reading m.global.server.apiVersion.

Returns the item selected or -1 on backpress or other unhandled closure of dialog.

Returns the Jellyfin index of the first audio stream in the streams array

getFirstVideoStream: Finds the first video stream in MediaStreams array MediaStreams[0] is not always a video stream - it could be subtitle or audio

getGlobalSplashScreenSetting: Gets the global splash screen setting from registry or default

Reads from global registry first. If not found (user never changed it), reads default from settings.json (single source of truth). Works before user login since global settings are device-wide.

Converts ticks to minutes

Converts a Jellyfin audio stream index to a Roku audioTrack Track identifier. For MKV direct play, Roku exposes tracks using 1-based MKV track numbers that include ALL track types (video, audio, subtitle). Jellyfin's stream Index is 0-based and also counts all track types, so Roku Track = Jellyfin Index + 1.

When availableAudioTracks is provided (populated by Roku during active playback), matches by language with ordinal disambiguation: among same-language Jellyfin streams (in original order), find the position N of the chosen index, then return the Nth same-language Roku track. This avoids returning the wrong track when multiple streams share a language (e.g. main + commentary, both English — issue #500). Falls back to Index + 1 mapping when availableAudioTracks is not available or no ordinal match can be found (e.g., before playback starts or for non-MKV containers).

Returns "am" or "pm" for 12h clock, empty string for 24h.

Search string array for search value. Return if it's found

take an incomplete url string and use it to make educated guesses about the complete url. then tests these guesses to see if it can find a jf server returns the url of the server it found, or an empty string

injectApiParams: Pure function to inject default image parameters and version-specific fields Separated from ApiClient for testability without network I/O

Returns whether or not all items in passed array are valid

isChainValid: Returns whether or not all the properties in the passed property chain are valid. Stops evaluating at first found false value

accepts the raw json string of /system/info/public and returns a boolean indicating if ProductName is "Jellyfin Server"

Returns true if the string is a loopback, such as 'localhost' or '127.0.0.1'

Returns whether or not passed value is valid

Returns whether or not passed value is valid and not empty Accepts a string, or any countable type (arrays and lists)

Returns an array from a url = [ url, proto, host, port, subdir+params ] If port or subdir are not found, an empty string will be added to the array Proto must be declared or array will be empty

Maps a Jellyfin server version string to an API version integer used by the SDK dispatcher. V1: Covers pre-10.9 servers (10.7.x, 10.8.x) — uses /Users/{userId}/ path prefix V2: Covers 10.9+ servers — endpoints moved to top-level, userId passed as query param Returns 1 if serverVersion is empty/invalid (safe fallback to legacy paths)

resolveSplashScreen: Resolves whether to show the splash screen on User Select screen

Checks JellyRock global setting. If "disabled", never shows splash. Otherwise follows server branding configuration. Ensures a valid boolean is always returned.

Rounds number to nearest integer

Converts seconds to a human readable timestamp. Used for progress bar during playback eg. 3661 seconds = "01:01:01"

Takes an array of data, shuffles the order, then returns the array uses the Fisher-Yates shuffling algorithm

startLoadingSpinner: Start a loading spinner and attach it to the main JRScene. Displays an invisible ProgressDialog node by default to disable keypresses while loading.

Converts ticks to number of minutes eg. 3661 totalSeconds = 61

convert value to boolean and return value

this is the "educated guess" logic for inferServerUrl that generates a list of complete url's as candidates for the tests in inferServerUrl. takes an incomplete url as an arg and returns a list of extrapolated full urls.

Returns whether or not a version number (e.g. 10.7.7) is greater or equal to some minimum version allowed (e.g. 10.8.0)