Struct MediaItem 

pub struct MediaItem {

    pub id: String,
    pub title: String,
    pub name: Option<String>,
    pub artist: Option<String>,
    pub album: Option<String>,
    pub album_name: Option<String>,
    pub album_id: Option<String>,
    pub artist_items: Option<Vec<ArtistItem>>,
    pub artists: Option<Vec<String>>,
    pub primary_image_tag: Option<String>,
    pub image_id: Option<String>,
    pub item_type: Option<String>,
    pub playlist_id: Option<String>,
    pub duration: Option<f64>,
    pub artwork_url: Option<String>,
    pub media_type: MediaType,
    pub source: MediaSource,
    pub video_codec: Option<String>,
    pub needs_transcoding: bool,
    pub transport: Option<Transport>,
    pub video_width: Option<u32>,
    pub video_height: Option<u32>,
    pub subtitles: Vec<SubtitleTrack>,
    pub series_id: Option<String>,
    pub server_id: Option<String>,
}

Represents a media item that can be played

TRACES: UR-003, UR-004 | DR-002

Fields

id: String

Unique identifier

title: String

Display title

name: Option<String>

Name (alias for title - for frontend compatibility)

artist: Option<String>

Artist name(s) for audio

album: Option<String>

Album name for audio

album_name: Option<String>

Album name (alias - for frontend compatibility)

album_id: Option<String>

Album ID (Jellyfin ID) for remote transfer context

artist_items: Option<Vec<ArtistItem>>

Artist items with IDs for clickable links

artists: Option<Vec<String>>

Artists as array of strings (fallback when artist_items not available)

primary_image_tag: Option<String>

Primary image tag for artwork.

Legacy Jellyfin name; being replaced by image_id (same value). Dual-carried while the frontend migrates (docs/specs/frontend-domain-model.md).

image_id: Option<String>

Neutral image identifier the frontend resolves to a URL — replaces primary_image_tag.

item_type: Option<String>

Item type (Audio, Movie, Episode, etc.)

playlist_id: Option<String>

Playlist ID (Jellyfin ID) for remote transfer context

duration: Option<f64>

Duration in seconds

artwork_url: Option<String>

URL or path to artwork image

media_type: MediaType

Type of media

source: MediaSource

Source of the media

video_codec: Option<String>

Video codec (e.g., “h264”, “hevc”) for video media

needs_transcoding: bool

Whether the video requires server-side transcoding

transport: Option<Transport>

How this item’s stream is fetched, as the backend decided it.

Carried on the queue item so a later seek/reload does not have to guess. None for items queued by a path that never negotiated (audio tracks, direct URLs) and for anything queued before this field existed, where the caller falls back to needs_transcoding — every transcode this app requests is HLS (DR-140), so that fallback is exact rather than a guess.

TRACES: UR-003, UR-004, UR-079 | DR-225, DR-230

video_width: Option<u32>

Video width in pixels

video_height: Option<u32>

Video height in pixels

subtitles: Vec<SubtitleTrack>

Available subtitle tracks

series_id: Option<String>

Series ID (for TV show episodes) - used for series audio preferences

server_id: Option<String>

Server ID - used for series audio preferences

Implementations

impl MediaItem

pub fn playable_url(&self) -> String

The URL or path an engine should open.

TRACES: UR-081 | DR-245

impl MediaItem

pub fn jellyfin_id(&self) -> Option<&str>

Get the Jellyfin item ID if available

Trait Implementations

impl Clone for MediaItem

fn clone(&self) -> MediaItem

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MediaItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MediaItem

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&MediaItem> for MergedMediaItem

fn from(item: &MediaItem) -> Self

Converts to this type from the input type.

impl NamedType for MediaItem

fn sid() -> SpectaID

fn named_data_type( type_map: &mut TypeCollection, generics: &[DataType], ) -> NamedDataType

this is equivalent to [Type::inline] but returns a [NamedDataType] instead.

fn definition_named_data_type(type_map: &mut TypeCollection) -> NamedDataType

this is equivalent to [Type::definition] but returns a [NamedDataType] instead.

impl PartialEq for MediaItem

fn eq(&self, other: &MediaItem) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MediaItem

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Type for MediaItem

fn inline(type_map: &mut TypeCollection, generics: Generics<'_>) -> DataType

Returns the definition of a type using the provided generics.

fn reference(type_map: &mut TypeCollection, generics: &[DataType]) -> Reference

Generates a datatype corresponding to a reference to this type, as determined by its category. Getting a reference to a type implies that it should belong in the type map (since it has to be referenced from somewhere), so the output of definition will be put into the type map.

impl Flatten for MediaItem

impl StructuralPartialEq for MediaItem