Methods
(static) getItemBackdropUrl(item, size) → {string}
Generate a full backdrop URL with fallback chain. Fallback order: item backdrop, then 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, for example imageSize.POSTER_LG |
Full image URL string, or "" if no tag is available for that type
- 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, then 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, then parent primary, then series primary, then album 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, then item backdrop, then parent thumb, then 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