Class Episode

Hierarchy

  • Video
    • Episode

Constructors

constructor

Properties

METADATA_TYPE TYPE _INCLUDES addedAt art? artBlurHash? chapterSource? chapters collections contentRating directors duration grandparentArt? grandparentKey grandparentRatingKey grandparentTheme grandparentThumb grandparentTitle guid index key lastViewedAt? librarySectionID? listType markers media originallyAvailableAt parent? parentIndex parentKey parentRatingKey parentThumb parentTitle players playlistItemID? rating ratingKey? server session sessionKey summary thumb thumbBlurHash? title? titleSort? transcodeSessions type? updatedAt? usernames viewCount? viewOffset? viewedAt writers year? TAG TYPE

Accessors

artUrl isFullObject isWatched thumbUrl

Methods

addCollection addGenre addLabel analyze delete edit extras fixMatch getWebURL hasCreditsMarker hasIntroMarker history isChildOf locations markUnwatched markWatched matches posters rate refresh reload removeCollection removeGenre removeLabel season seasonEpisode seasonNumber section setPoster show unmatch uploadPoster

Constructors

constructor

  • new Episode(server, data, initpath?, parent?): Episode

  • Parameters

    • server: PlexServer
    • data: any
    • Optionalinitpath: string
    • Optionalparent: PlexObject

    Returns Episode

Properties

METADATA_TYPE

METADATA_TYPE: string = 'episode'

TYPE

TYPE: string = 'episode'

_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

addedAt: Date

Datetime this item was added to the library.

Optionalart

art?: string

OptionalartBlurHash

artBlurHash?: string

BlurHash string for artwork image.

OptionalchapterSource

chapterSource?: string

Unknown (media).

chapters

chapters: Chapter[]

collections

collections: Collection[]

contentRating

contentRating: string

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

directors

directors: Director[]

duration

duration: number

Duration of episode in milliseconds.

OptionalgrandparentArt

grandparentArt?: string

grandparentKey

grandparentKey: string

Key to this episodes :class:~plexapi.video.Show.

grandparentRatingKey

grandparentRatingKey: string

Unique key for this episodes :class:~plexapi.video.Show.

grandparentTheme

grandparentTheme: string

Key to this episodes :class:~plexapi.video.Show theme.

grandparentThumb

grandparentThumb: string

Key to this episodes :class:~plexapi.video.Show thumb.

grandparentTitle

grandparentTitle: string

Title of this episodes :class:~plexapi.video.Show.

guid

guid: string

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

index

index: number

Episode number.

key

key: string

plex relative url

OptionallastViewedAt

lastViewedAt?: Date

Datetime item was last accessed.

OptionallibrarySectionID

librarySectionID?: number

listType

listType: "video" = ...

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

markers

markers: Marker[]

media

media: Media[]

originallyAvailableAt

originallyAvailableAt: Date

Datetime episode was released.

Optional Readonlyparent

parent?: WeakRef<any>

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

parentIndex

parentIndex: number

Season number of episode.

parentKey

parentKey: string

Key to this episodes :class:~plexapi.video.Season.

parentRatingKey

parentRatingKey: string

Unique key for this episodes :class:~plexapi.video.Season.

parentThumb

parentThumb: string

Key to this episodes thumbnail.

parentTitle

parentTitle: string

Name of this episode's season

players

players: any

(:class:~plexapi.client.PlexClient): Client objects playing this item (for active sessions).

OptionalplaylistItemID

playlistItemID?: number

(int): Playlist item ID (only populated for :class:~plexapi.playlist.Playlist items).

rating

rating: number

Movie rating (7.9; 9.8; 8.1).

OptionalratingKey

ratingKey?: string

Readonlyserver

server: PlexServer

session

session: any

(:class:~plexapi.media.Session): Session object, for a playing media file.

sessionKey

sessionKey: any

(int): Active session key.

summary

summary: string

Summary of the artist, track, or album.

thumb

thumb: string

URL to thumbnail image.

OptionalthumbBlurHash

thumbBlurHash?: string

BlurHash string for thumbnail image.

Optionaltitle

title?: string

OptionaltitleSort

titleSort?: string

Title to use when sorting (defaults to title).

transcodeSessions

transcodeSessions: any

(:class:~plexapi.media.TranscodeSession): Transcode Session object if item is being transcoded (None otherwise).

Optionaltype

type?: string

OptionalupdatedAt

updatedAt?: Date

Datetime this item was updated.

usernames

usernames: any

(str): Username of the person playing this item (for active sessions).

OptionalviewCount

viewCount?: number

Count of times this item was accessed.

OptionalviewOffset

viewOffset?: number

View offset in milliseconds.

viewedAt

viewedAt: any

(datetime): Datetime item was last viewed (history).

writers

writers: Writer[]

Optionalyear

year?: number

StaticTAG

TAG: string = 'Video'

xml element tag

StaticTYPE

TYPE: string = null

xml element type

Accessors

artUrl

  • get artUrl(): URL

  • Returns URL

isFullObject

  • 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

isWatched

  • get isWatched(): boolean

  • Returns True if this video is watched.

    Returns boolean

thumbUrl

  • get thumbUrl(): URL

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

    Returns URL

Methods

addCollection

  • addCollection(collections): Promise<void>

  • Add a collection(s).

    Parameters

    • collections: string[]

    Returns Promise<void>

addGenre

  • addGenre(genres): Promise<void>

  • Add a genre(s).

    Parameters

    • genres: string[]

    Returns Promise<void>

addLabel

  • addLabel(labels): Promise<void>

  • Add a label(s).

    Parameters

    • labels: string[]

    Returns Promise<void>

analyze

  • analyze(): Promise<void>

  • 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>

delete

  • delete(): Promise<any>

  • Delete a media element. This has to be enabled under settings > server > library in plex webui.

    Returns Promise<any>

edit

  • edit(changeObj): Promise<void>

  • Edit an object.

    Parameters

    • changeObj: Record<string, string | number>

      Obj of settings to edit. Example: {'type': 1, 'id': movie.ratingKey, 'title.value': 'New Title', 'collection[0].tag.tag': 'Super', 'collection.locked': 0}

    Returns Promise<void>

extras

  • extras(): Promise<Extra[]>

  • Returns Promise<Extra[]>

fixMatch

  • fixMatch(searchResult?, auto?, agent?): Promise<void>

  • Use match result to update show metadata.

    Parameters

    • OptionalsearchResult: SearchResult

      Search result

    • auto: boolean = false

      True uses first match from matches, False allows user to provide the match

    • agent: string = ''

      (str): Agent name to be used (imdb, thetvdb, themoviedb, etc.)

    Returns Promise<void>

    See

    PartialPlexObject.matches

getWebURL

  • getWebURL(base?): string

  • Parameters

    • Optionalbase: string

    Returns string

hasCreditsMarker

  • hasCreditsMarker(): Promise<boolean>

  • Returns True if this episode has a credits marker

    Returns Promise<boolean>

hasIntroMarker

  • hasIntroMarker(): Promise<boolean>

  • Returns True if this episode has an intro marker

    Returns Promise<boolean>

history

  • history(maxresults?, mindate?): Promise<HistoryMetadatum[]>

  • Get Play History for a media item.

    Parameters

    • maxresults: number = 9999999

      Only return the specified number of results (optional).

    • Optionalmindate: Date

      Min datetime to return results from.

    Returns Promise<HistoryMetadatum[]>

isChildOf

  • isChildOf(cls): boolean

  • Returns True if this object is a child of the given class.

    Parameters

    • cls: any

    Returns boolean

locations

  • locations(): string[]

  • Returns string[]

markUnwatched

  • markUnwatched(): Promise<void>

  • Mark video as unwatched.

    Returns Promise<void>

markWatched

  • markWatched(): Promise<void>

  • Mark video as watched.

    Returns Promise<void>

matches

  • matches(agent?, title?, year?, language?): Promise<SearchResult[]>

  • Parameters

    • Optionalagent: string

      Agent name to be used (imdb, thetvdb, themoviedb, etc.)

    • Optionaltitle: string

      Title of item to search for

    • Optionalyear: string

      Year of item to search in

    • Optionallanguage: string

      Language of item to search in

      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[]>

posters

  • posters(): Promise<Poster[]>

  • Returns list of available Poster objects.

    Returns Promise<Poster[]>

rate

  • rate(rate): Promise<void>

  • Parameters

    • rate: number

    Returns Promise<void>

refresh

  • refresh(): 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>

reload

  • reload(ekey?, args?): Promise<void>

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

    Parameters

    • Optionalekey: string
    • Optionalargs: any

    Returns Promise<void>

removeCollection

  • removeCollection(collections): Promise<void>

  • Remove a collection(s).

    Parameters

    • collections: string[]

    Returns Promise<void>

removeGenre

  • removeGenre(genres): Promise<void>

  • Remove a genre(s).

    Parameters

    • genres: string[]

    Returns Promise<void>

removeLabel

  • removeLabel(labels): Promise<void>

  • Remove a label(s).

    Parameters

    • labels: string[]

    Returns Promise<void>

season

  • season(): Promise<Season>

  • Returns Promise<Season>

seasonEpisode

  • seasonEpisode(): Promise<string>

  • Returns Promise<string>

seasonNumber

  • seasonNumber(): Promise<number>

  • Returns this episodes season number.

    Returns Promise<number>

section

  • section(): Promise<Section>

  • Returns Promise<Section>

setPoster

  • setPoster(poster): Promise<Episode>

  • Set the poster for a Plex object.

    Parameters

    • poster: Poster

      The poster object to select.

    Returns Promise<Episode>

show

  • show(): Promise<Show>

  • Returns Promise<Show>

unmatch

  • unmatch(): Promise<any>

  • Unmatches metadata match from object.

    Returns Promise<any>

uploadPoster

  • uploadPoster(url?, file?): Promise<void>

  • I haven't tested this yet. It may not work.

    Parameters

    • Optionalurl: string
    • Optionalfile: Uint8Array

    Returns Promise<void>

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods