Methods
(static) getItemBackdropUrl(item, size) → {string}
Generate a full backdrop URL with fallback chain. Fallback order: item backdrop → parent backdrop
| Name | Type | Description |
|---|---|---|
item | object | JellyfinBaseItem content node |
size | object | { width, height } object; use device UI resolution (m.global.device.uiResolution) |
Full image URL string, or "" if no image is available
- Type:
- string
(static) getItemImageUrl(item, imageTypeopt, sizeopt) → {string}
Generate an image URL from a JellyfinBaseItem for a specific image type. This is the base function used by the typed convenience functions below.
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
item | object | JellyfinBaseItem content node | ||
imageType | string | <optional> | "Primary" | Jellyfin image type string: "Primary", "Thumb", "Logo", "Backdrop" |
size | object | <optional> | imageSize.DEFAULT | Size constant from imageSize namespace, e.g. imageSize.POSTER_LG |
Full image URL string, or "" if no tag is available for that type
- Type:
- string
(static) getItemParentBackdropUrl(item, size) → {string}
Generate a backdrop URL that prefers the parent (series/show) backdrop over the item's own. Use this for sub-item views (season episode lists, etc.) to maintain visual continuity with the parent detail screen. Both screens will resolve to the same series backdrop URL, which lets BackdropFader deduplicate the transition and avoid flickering. Fallback order: parent backdrop → item's own backdrop
| Name | Type | Description |
|---|---|---|
item | object | JellyfinBaseItem content node (typically a Season) |
size | object | { width, height } object; use device UI resolution (m.global.device.uiResolution) |
Full image URL string, or "" if no image is available
- Type:
- string
(static) getItemParentWidePosterUrl(item, sizeopt) → {string}
Generate a wide art URL preferring the parent (series/show) wide images over the item's own. Skips item-level Thumb and Backdrop entirely; resolves directly from parent fields. Use this for episodes when the user prefers show art over episode screenshots. Fallback order: parent thumb → parent backdrop
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
item | object | JellyfinBaseItem content node (typically an Episode or Recording) | ||
size | object | <optional> | imageSize.WIDE_MD | { width, height } object; use slot dimensions |
Full image URL string, or "" if no parent wide image is available
- Type:
- string
(static) getItemPosterUrl(item, sizeopt) → {string}
Generate a poster (portrait) URL with fallback chain. Fallback order: item primary → parent primary → series primary
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
item | object | JellyfinBaseItem content node | ||
size | object | <optional> | imageSize.POSTER_LG | Size constant from imageSize namespace (default: imageSize.POSTER_LG) |
Full image URL string, or "" if no image is available
- Type:
- string
(static) getItemThumbnailUrl(item, sizeopt) → {string}
Generate a thumbnail URL (wide, smaller size). Delegates to getItemWidePosterUrl with a smaller default size.
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
item | object | JellyfinBaseItem content node | ||
size | object | <optional> | imageSize.WIDE_SM | Size constant from imageSize namespace (default: imageSize.WIDE_SM) |
Full image URL string, or "" if no image is available
- Type:
- string
(static) getItemWidePosterUrl(item, sizeopt) → {string}
Generate a wide/landscape URL with fallback chain. Fallback order: item thumb → item backdrop → parent thumb → parent backdrop
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
item | object | JellyfinBaseItem content node | ||
size | object | <optional> | imageSize.WIDE_MD | Size constant from imageSize namespace (default: imageSize.WIDE_MD) |
Full image URL string, or "" if no image is available
- Type:
- string
(static) getProgramImageUrl(programItem, channelItem, sizeopt) → {string}
Generate an image URL for a Live TV program, falling back to the channel image. Accommodates the two-phase load constraint: program and channel are separate API calls.
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
programItem | object | JellyfinBaseItem for the program | ||
channelItem | object | JellyfinBaseItem for the channel (may be invalid if not yet loaded) | ||
size | object | <optional> | imageSize.WIDE_MD | Size constant from imageSize namespace (default: imageSize.WIDE_MD) |
Full image URL string, or "" if no image is available
- Type:
- string