@ctrl/plex
    Preparing search index...

    Class Show

    Represents a single Show (including all seasons and episodes).

    Hierarchy (View Summary)

    Index
    constructor
    _INCLUDES addedAt art? artBlurHash? audienceRating? audienceRatingImage? audioLanguage? autoDeletionItemPolicyUnwatchedLibrary? autoDeletionItemPolicyWatchedLibrary? banner? childCount collections commonSenseMedia? contentRating? contentRatingAge? duration? editionTitle? enableCreditsMarkerGeneration? episodeSort? fields flattenSeasons? genres grandparentArt? grandparentGuid? guid guids images index key labels languageOverride? lastRatedAt? lastViewedAt? leafCount librarySectionID? librarySectionKey? librarySectionTitle? listType live? locations METADATA_TYPE network? originallyAvailableAt? originalTitle? parent? parentGuid? player? players playlistItemID? playQueueItemID? processingState? producers rating? ratingKey? ratings roles seasonCount server session? sessionKey? sessions showOrdering? similar slug? studio? subtitleLanguage? subtitleMode? summary? TAG tagline? theme? thumb? thumbBlurHash? title? titleSort? transcodeSession? transcodeSessions type? TYPE ultraBlurColors? updatedAt? useOriginalTitle? user? usernames userRating? viewCount viewedAt? viewedLeafCount year? TAG TYPE
    actors artUrl artwork hasPreviewThumbnails hasVoiceActivity isFullObject isPlayed isWatched metadataDirectory thumbUrl
    addCollection addGenre addLabel addToWatchlist analyze audioStreams createPlayQueue defaultAdvanced delete download downloadSubtitle edit editAdvanced editContentRating editFields editions editOriginallyAvailableAt editSortTitle editStudio editSummary editTags editTitle episode episodes extras fixMatch getStreamURL getWebURL history hubs isChildOf isLocked iterParts lyricStreams markPlayed markUnplayed markUnwatched markWatched matches merge onDeck onWatchlist optimize play posters preference preferences rate refresh reload removeCollection removeFromWatchlist removeGenre removeLabel removeSubtitle searchSubtitles season seasons section setPoster split streamingServices subtitleStreams unmatch unwatched updateProgress updateTimeline uploadPoster uploadSubtitle videoStreams watched

    _INCLUDES

    _INCLUDES: {
        checkFiles: number;
        includeAllConcerts: number;
        includeBandwidths: number;
        includeChapters: number;
        includeChildren: number;
        includeConcerts: number;
        includeExternalMedia: number;
        includeExtras: number;
        includeFields: string;
        includeGeolocation: number;
        includeLoudnessRamps: number;
        includeMarkers: number;
        includeOnDeck: number;
        includePopularLeaves: number;
        includePreferences: number;
        includeRelated: number;
        includeRelatedCount: number;
        includeReviews: number;
        includeStations: number;
    } = ...
    addedAt: Date

    Datetime this item was added to the library.

    art?: string
    artBlurHash?: string
    audienceRating?: number

    Audience rating (usually from Rotten Tomatoes).

    audienceRatingImage?: string

    Key to audience rating image (rottentomatoes://image.rating.spilled).

    audioLanguage?: string

    Preferred audio language for this show, when set.

    autoDeletionItemPolicyUnwatchedLibrary?: number

    Delete unwatched episodes preference, when set on this show.

    autoDeletionItemPolicyWatchedLibrary?: number

    Delete watched episodes preference, when set on this show.

    banner?: string

    Key to banner artwork (/library/metadata//banner/)

    childCount: number

    Number of seasons, including specials.

    collections: Collection[]
    commonSenseMedia?: CommonSenseMedia

    Common Sense Media rating and advisory data, when returned by Plex.

    contentRating?: string

    Content rating (PG-13; NR; TV-G).

    contentRatingAge?: number

    Minimum age for the content rating, when Plex knows it.

    duration?: number

    Duration of show in milliseconds.

    editionTitle?: string

    Edition shared by a movie or inherited from a show's hierarchy.

    enableCreditsMarkerGeneration?: number

    Credits marker generation preference (-1 library default, 0 disabled, 1 enabled).

    episodeSort?: number

    Episode sort preference (-1 library default, 0 oldest first, 1 newest first).

    fields: Field[]
    flattenSeasons?: number

    Season display preference (-1 library default, 0 show, 1 hide).

    genres: Genre[]

    List of genre objects.

    grandparentArt?: string
    grandparentGuid?: string
    guid: string

    Plex GUID (com.plexapp.agents.imdb://tt4302938?lang=en).

    guids: Guid[]

    External GUID objects for this video item.

    images: Image[]

    Image tags for this video item.

    index: number

    Plex index (?)

    key: string

    Plex relative url of this metadata item.

    labels: Label[]
    languageOverride?: string

    Language override for metadata, when set on this item.

    lastRatedAt?: Date

    Datetime the user last rated this item.

    lastViewedAt?: Date

    Datetime item was last accessed.

    leafCount: number

    Unknown.

    librarySectionID?: number
    librarySectionKey?: string

    Library section key (/library/sections/1).

    librarySectionTitle?: string

    Library section title (Movies, TV Shows).

    listType: "video" = ...

    Hardcoded as 'video' (useful for search filters).

    live?: boolean

    Whether the active session is live TV.

    locations: string[]
    METADATA_TYPE: string = 'episode'
    network?: string

    TV network that aired the show.

    originallyAvailableAt?: Date

    Datetime show was released.

    originalTitle?: string

    Original title, often the foreign title.

    parent?: WeakRef<PlexObject>

    WeakRef to the parent object that this object is built from.

    parentGuid?: string

    BlurHash string for artwork image.

    player?: PlexSessionPlayer

    Client currently playing this item.

    players: PlexSessionPlayer[] = []

    Clients associated with this active playback.

    playlistItemID?: number

    Playlist item ID, only populated for items loaded from a Playlist.

    playQueueItemID?: number

    Queue-local item ID (only populated for PlayQueue items).

    processingState?: OptimizationState

    Current state while this item is being processed for an optimized-media group.

    producers: Producer[]
    rating?: number

    Show rating (7.9; 9.8; 8.1).

    ratingKey?: string
    ratings: Rating[]
    roles: Role[]

    List of role objects.

    seasonCount: number

    Number of seasons. Falls back to childCount when Plex omits it.

    server: PlexServer
    session?: PlexPlaybackSession

    Bandwidth allocation for the active playback, when one exists.

    sessionKey?: number

    Server-local key for an active playback session.

    sessions: PlexPlaybackSession[] = []

    Bandwidth allocations associated with this active playback.

    showOrdering?: string

    Episode ordering for the show (ex: aired, dvd, absolute), when set.

    similar: Similar[]
    slug?: string

    URL slug used by Plex.

    studio?: string

    Studio that created show (Di Bonaventura Pictures; 21 Laps Entertainment).

    subtitleLanguage?: string

    Preferred subtitle language for this show, when set.

    subtitleMode?: number

    Subtitle mode preference, when set on this show.

    summary?: string

    Summary of the artist, track, or album.

    TAG: string = 'Directory'
    tagline?: string

    Show tag line.

    theme?: string

    Key to theme resource (/library/metadata//theme/)

    thumb?: string

    URL to thumbnail image.

    thumbBlurHash?: string

    BlurHash string for thumbnail image.

    title?: string
    titleSort?: string

    Title to use when sorting (defaults to title).

    transcodeSession?: PlexTranscodeSession

    Active transcode associated with this playback, when Plex includes it.

    transcodeSessions: PlexTranscodeSession[] = []

    Transcodes associated with this active playback.

    type?: string
    TYPE: string = 'show'
    ultraBlurColors?: UltraBlurColorsData
    updatedAt?: Date

    Datetime this item was updated.

    useOriginalTitle?: number

    Original title preference (-1 library default, 0 disabled, 1 enabled).

    user?: PlexSessionUser

    Account currently playing this item.

    usernames: string[] = []

    Usernames associated with this active playback.

    userRating?: number

    User rating (2.0; 8.0).

    viewCount: number

    Count of times this item was accessed.

    viewedAt?: Date

    Datetime item was last viewed (history).

    viewedLeafCount: number

    Unknown.

    year?: number
    TAG: string | null = null

    xml element tag

    TYPE: string | null = null

    xml element type

    • get artUrl(): URL | undefined

      Returns URL | undefined

    • get hasPreviewThumbnails(): boolean

      Returns boolean

    • get hasVoiceActivity(): boolean

      Returns boolean

    • get isFullObject(): boolean

      Retruns True if this is already a full object. A full object means all attributes were populated from the api path representing only this item. For example, the search result for a movie often only contain a portion of the attributes a full object (main url) for that movie would contain.

      Returns boolean

    • get isPlayed(): boolean

      Returns boolean

    • get isWatched(): boolean

      Returns boolean

      True if this show is fully watched.

    • get metadataDirectory(): string | undefined

      Path relative to the Plex server data directory, using server-independent separators.

      Returns string | undefined

    • get thumbUrl(): URL | undefined

      Return the first first thumbnail url starting on the most specific thumbnail for that item.

      Returns URL | undefined

    • Tell Plex Media Server to performs analysis on it this item to gather information. Analysis includes:

      • Gather Media Properties: All of the media you add to a Library has properties that are useful to know–whether it's a video file, a music track, or one of your photos (container, codec, resolution, etc).
      • Generate Default Artwork: Artwork will automatically be grabbed from a video file. A background image will be pulled out as well as a smaller image to be used for poster/thumbnail type purposes.
      • Generate Video Preview Thumbnails: Video preview thumbnails are created, if you have that feature enabled. Video preview thumbnails allow graphical seeking in some Apps. It's also used in the Plex Web App Now Playing screen to show a graphical representation of where playback is. Video preview thumbnails creation is a CPU-intensive process akin to transcoding the file.
      • Generate intro video markers: Detects show intros, exposing the 'Skip Intro' button in clients.

      Returns Promise<void>

    • Edit an object.

      Parameters

      • changes: Readonly<Record<string, string | number>>

      Returns Promise<void>

    • Return the other editions with the same Plex GUID.

      Type Parameters

      Parameters

      • this: T

      Returns Promise<T[]>

    • Parameters

      • args: { title: string } | { episode: number; season: number }

      Returns Promise<Episode>

    • Parameters

      • Optionalquery: Record<string, string | number>

      Returns Promise<Episode[]>

    • Use match result to update show metadata.

      Parameters

      • options: { agent?: string; auto?: boolean; searchResult?: SearchResult } = {}

        Match options.

      Returns Promise<void>

    • Returns true if this object was built from a parent of the given class.

      Parameters

      • cls: new (...args: any[]) => PlexObject

      Returns boolean

    • Parameters

      • options: { agent?: string; language?: string; title?: string; year?: string } = {}

        Match options.

        Examples:

        1. video.matches()

        2. video.matches({ title: "something", year: "2020" })

        3. video.matches({ title: "something" })

        4. video.matches({ year: "2020" })

        5. video.matches({ title: "something", year: "" })

        6. video.matches({ title: "", year: "2020" })

        7. video.matches({ title: "", year: "" })

        8. The default behaviour in Plex Web = no params in plexapi

        9. Both title and year specified by user

        10. Year automatically filled in

        11. Title automatically filled in

        12. Explicitly searches for title with blank year

        13. Explicitly searches for blank title with year

        14. I don't know what the user is thinking... return the same result as 1

        For 2 to 7, the agent and language is automatically filled in

      Returns Promise<SearchResult[]>

    • Return the episode Plex currently considers on deck for this show.

      Returns Promise<Episode | undefined>

    • Set a personal rating from 0 to 10, or clear it with null.

      Parameters

      • rating: number | null

      Returns Promise<void>

    • Refreshing a Library or individual item causes the metadata for the item to be refreshed, even if it already has metadata. You can think of refreshing as "update metadata for the requested item even if it already has some". You should refresh a Library or individual item if:

      Returns Promise<void>

    • load full data / reload the data for this object from this.key.

      Parameters

      • Optionalekey: string
      • Optionalargs: Record<string, number | boolean>

      Returns Promise<void>

    • Parameters

      • titleOrIndex: string | number

      Returns Promise<Season>

    • Parameters

      • Optionalquery: Record<string, string | number>

      Returns Promise<Season[]>

    • Upload a poster from a URL or image bytes. Shorthand for artwork.upload().

      Parameters

      • options: { file?: undefined; url: string } | { file: Uint8Array; url?: undefined }

      Returns Promise<void>

    Settings
    Member Visibility

    On This Page
    Constructors
    Properties
    _INCLUDESaddedAtartartBlurHashaudienceRatingaudienceRatingImageaudioLanguageautoDeletionItemPolicyUnwatchedLibraryautoDeletionItemPolicyWatchedLibrarybannerchildCountcollectionscommonSenseMediacontentRatingcontentRatingAgedurationeditionTitleenableCreditsMarkerGenerationepisodeSortfieldsflattenSeasonsgenresgrandparentArtgrandparentGuidguidguidsimagesindexkeylabelslanguageOverridelastRatedAtlastViewedAtleafCountlibrarySectionIDlibrarySectionKeylibrarySectionTitlelistTypelivelocationsMETADATA_TYPEnetworkoriginallyAvailableAtoriginalTitleparentparentGuidplayerplayersplaylistItemIDplayQueueItemIDprocessingStateproducersratingratingKeyratingsrolesseasonCountserversessionsessionKeysessionsshowOrderingsimilarslugstudiosubtitleLanguagesubtitleModesummaryTAGtaglinethemethumbthumbBlurHashtitletitleSorttranscodeSessiontranscodeSessionstypeTYPEultraBlurColorsupdatedAtuseOriginalTitleuserusernamesuserRatingviewCountviewedAtviewedLeafCountyearTAGTYPE
    Accessors
    Methods