gddlZddlmZddlmZddlmZddlmZm Z ddl m Z m Z m Z mZddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$Gd d e eZ%e jLGd d e%e eeeeeeeeeee e$Z'e jLGd de%eeeeeeeeeee!e$Z(e jLGdde%eeeeeeee" Z)e jLGdde%e eeeeeee# Z*e jLGdde%e eeZ+Gdde+Z,e jLGddee'Z-e jLGddee*Z.e jLGddee+Z/e jLGdde e'Z0e jLGdd e e*Z1e jLGd!d"e e+Z2y)#N)cached_property)Path) quote_plus)mediautils)PlayablePlexPartialObject PlexHistory PlexSession) BadRequest)AdvancedSettingsMixinSplitMergeMixinUnmatchMatchMixin ExtrasMixin HubsMixinPlayedUnplayedMixin RatingMixin ArtUrlMixinArtMixin LogoMixinPosterUrlMixin PosterMixin ThemeUrlMixin ThemeMixinMovieEditMixinsShowEditMixinsSeasonEditMixinsEpisodeEditMixinsWatchlistMixincXeZdZdZdZdZdZdZdZd dZ dZ dd Z dd Z dd Z y )Videoa Base class for all video objects including :class:`~plexapi.video.Movie`, :class:`~plexapi.video.Show`, :class:`~plexapi.video.Season`, :class:`~plexapi.video.Episode`, and :class:`~plexapi.video.Clip`. Attributes: addedAt (datetime): Datetime the item was added to the library. art (str): URL to artwork image (/library/metadata//art/). artBlurHash (str): BlurHash string for artwork image. fields (List<:class:`~plexapi.media.Field`>): List of field objects. guid (str): Plex GUID for the movie, show, season, episode, or clip (plex://movie/5d776b59ad5437001f79c6f8). images (List<:class:`~plexapi.media.Image`>): List of image objects. key (str): API URL (/library/metadata/). lastRatedAt (datetime): Datetime the item was last rated. lastViewedAt (datetime): Datetime the item was last played. librarySectionID (int): :class:`~plexapi.library.LibrarySection` ID. librarySectionKey (str): :class:`~plexapi.library.LibrarySection` key. librarySectionTitle (str): :class:`~plexapi.library.LibrarySection` title. listType (str): Hardcoded as 'video' (useful for search filters). ratingKey (int): Unique key identifying the item. summary (str): Summary of the movie, show, season, episode, or clip. thumb (str): URL to thumbnail image (/library/metadata//thumb/). thumbBlurHash (str): BlurHash string for thumbnail image. title (str): Name of the movie, show, season, episode, or clip. titleSort (str): Title to use when sorting (defaults to title). type (str): 'movie', 'show', 'season', 'episode', or 'clip'. updatedAt (datetime): Datetime the item was updated. userRating (float): Rating of the item (0.0 - 10.0) equaling (0 stars - 5 stars). viewCount (int): Count of times the item was played. c&||_tj|jj d|_|jj d|_|jj d|_|j|tj|_ |jj d|_ |j|tj|_|jj dd|_tj|jj d|_tj|jj d|_tj$t&|jj d |_|jj d |_|jj d |_d |_tj$t&|jj d |_|jj d|_|jj d|_|jj d|_|jj d|_|jj d|j8|_|jj d|_tj|jj d|_tj$t@|jj d|_!tj$t&|jj dd|_"y)/ Load attribute values from Plex XML response. addedAtart artBlurHashguidkey lastRatedAt lastViewedAtlibrarySectionIDlibrarySectionKeylibrarySectionTitlevideo ratingKeysummarythumb thumbBlurHashtitle titleSorttype updatedAt userRating viewCountrN)#_datar toDatetimeattribgetr$r%r& findItemsrFieldfieldsr'Imageimagesr(r*r+castintr,r-r.listTyper0r1r2r3r4r5r6r7floatr8r9selfdatas "/opt/Tautulli/lib/plexapi/video.py _loadDatazVideo._loadData1s8 ''  (BC ;;??5);;??=9nnT5;;7 KKOOF+ nnT5;;7 ;;??5"- ++DKKOOM,JK!,,T[[__^-LM % 3 @R0S T!%1D!E#';;??3H#I  C)EF{{y1 [[__W- ![[___=[[__W- djjAKKOOF+ ))$++//+*FG**UDKKOOL,IJCa)HIcD|r|jj|dSdS)zR Returns the full url for something. Typically used for getting a specific image. T) includeTokenN)_serverurlrHparts rJrPz Video.urlLs#<@t||48JdJrLc^|jj}td|jDd}|jdk7s|dk(r t d|jj |jdz}|jjd}|j|S)a Returns a list of :class:`~plexapi.library.Hub` objects. Augmentation returns hub items relating to online media sources such as Tidal Music "Track from {item}" or "Soundtrack of {item}". Plex Pass and linked Tidal account are required. c3RK|]}|jdk(r|j!yw)ztv.plex.provider.musicN)r(value).0services rJ z%Video.augmentation..Xs( $>WU[el  m n  n s )?B22B<cx|||d}|jdtj|}|j|S)a Search for on-demand subtitles for the video. See https://support.plex.tv/articles/subtitle-search/. Parameters: language (str, optional): Language code (ISO 639-1) of the subtitles to search for. Default 'en'. hearingImpaired (int, optional): Search option for SDH subtitles. Default 0. (0 = Prefer non-SDH subtitles, 1 = Prefer SDH subtitles, 2 = Only show SDH subtitles, 3 = Only show non-SDH subtitles) forced (int, optional): Search option for forced subtitles. Default 0. (0 = Prefer non-forced subtitles, 1 = Prefer forced subtitles, 2 = Only show forced subtitles, 3 = Only show non-forced subtitles) Returns: List<:class:`~plexapi.media.SubtitleStream`>: List of SubtitleStream objects. )languagehearingImpairedforcedrl)r(rjoinArgsra)rHrrrrqr(s rJsearchSubtitleszVideo.searchSubtitlesxsC(!.   *U^^F%;$<=s##rLc|jd}d|ji}|jj||jjj||S)a Download on-demand subtitles for the video. See https://support.plex.tv/articles/subtitle-search/. Note: This method is asynchronous and returns immediately before subtitles are fully downloaded. Parameters: subtitleStream (:class:`~plexapi.media.SubtitleStream`): Subtitle object returned from :func:`~plexapi.video.Video.searchSubtitles`. rlr()rq)r(rOr`rxput)rHsubtitleStreamr(rqs rJdownloadSubtitleszVideo.downloadSubtitlessR *%++, 3 5 5 9 9&I rLNc|$ tfd|jD}|jj |j |jjj|S#t$rtddddwxYw)a; Remove an upload or downloaded subtitle from the video. Note: If the subtitle file is located inside video directory it will be deleted. Files outside of video directory are not affected. Embedded subtitles cannot be removed. Parameters: subtitleStream (:class:`~plexapi.media.SubtitleStream`, optional): Subtitle object to remove. streamID (int, optional): ID of the subtitle stream to remove. streamTitle (str, optional): Title of the subtitle stream to remove. Nc3^K|]$}|jk(s|jk(r|&ywN)idr4)rVstreamstreamID streamTitles rJrXz(Video.removeSubtitles..s0&%699, v||0K&s*-zSubtitle stream with ID 'z ' or title 'z ' not found.) r]subtitleStreams StopIterationr rOr`r(rxdelete)rHrrrs ``rJremoveSubtitleszVideo.removeSubtitless  ! x!%&)-)=)=)?&" >--t||/D/D/K/KL ! x #|d<|j@|d<d |d<d |d<d |d<d |d <d |d!<| tCjD|z}|jjG||jjHjJ"|Scc} wcc}w)#a Create an optimized version of the video. Parameters: title (str, optional): Title of the optimized video. target (str, optional): Target quality profile: "Optimized for Mobile" ("mobile"), "Optimized for TV" ("tv"), "Original Quality" ("original"), or custom quality profile name (default "Custom: {deviceProfile}"). deviceProfile (str, optional): Custom quality device profile: "Android", "iOS", "Universal Mobile", "Universal TV", "Windows Phone", "Windows", "Xbox One". Required if ``target`` is custom. videoQuality (int, optional): Index of the quality profile, one of ``VIDEO_QUALITY_*`` values defined in the :mod:`~plexapi.sync` module. Only used if ``target`` is custom. locationID (int or :class:`~plexapi.library.Location`, optional): Default -1 for "In folder with original items", otherwise a :class:`~plexapi.library.Location` object or ID. See examples below. limit (int, optional): Maximum count of items to optimize, unlimited if ``None``. unwatched (bool, optional): ``True`` to only optimized unwatched videos. Raises: :exc:`~plexapi.exceptions.BadRequest`: Unknown quality profile target or missing deviceProfile and videoQuality. :exc:`~plexapi.exceptions.BadRequest`: Unknown location ID. Example: .. code-block:: python # Optimize for mobile using defaults video.optimize(target="mobile") # Optimize for Android at 10 Mbps 1080p from plexapi.sync import VIDEO_QUALITY_10_MBPS_1080p video.optimize(deviceProfile="Android", videoQuality=sync.VIDEO_QUALITY_10_MBPS_1080p) # Optimize for iOS at original quality in library location from plexapi.sync import VIDEO_QUALITY_ORIGINAL locations = plex.library.section("Movies")._locations() video.optimize(deviceProfile="iOS", videoQuality=VIDEO_QUALITY_ORIGINAL, locationID=locations[0]) # Optimize for tv the next 5 unwatched episodes show.optimize(target="tv", limit=5, unwatched=True) r)Location)Policy MediaSettingsz/playlists?type=42z/itemsmediaProcessingTargetzoptimized for mobilemobilezoptimized for tvtvzoriginal qualityoriginalr)zIUnknown quality profile target or missing deviceProfile and videoQuality.zCustom: zUnknown location ID "z " not in zlibrary:///directory/ /children library:///item/*) z Item[type]z Item[title]z Item[target]zItem[targetTagID]zItem[locationID]zItem[Location][uri]zItem[Policy][scope]zItem[Policy][value]zItem[Policy][unwatched]zItem[Device][profile]z!Item[MediaSettings][videoQuality]z$Item[MediaSettings][videoResolution]z$Item[MediaSettings][maxVideoBitrate]zItem[MediaSettings][audioBoost]z!Item[MediaSettings][subtitleSize]z!Item[MediaSettings][musicBitrate]z!Item[MediaSettings][photoQuality]z$Item[MediaSettings][photoResolution])method)&plexapi.libraryr plexapi.syncrr fetchItemr(rOlibrarytagstaglowerrr=r section _locations isinstanceShowSeasonruuidcreateriscopestrrUrD unwatched createVideo videoQualityvideoResolutionmaxVideoBitraterrr`rxr)rHr4target deviceProfiler locationIDlimitrrrrbackgroundProcessingr(tr targetTagIDrlocationlibraryLocationIDsuripolicyrq mediaSettingsrPs rJoptimizezVideo.optimizesZ -6#~~.BC%))*&1-1\\-A-A-F-FG^-_` qtt#``45X,-T  23Zhhv||~r2 M\5Ihi i F 6 /F,,. TASASAU$VXX[[$VV j( +#J / /4ZL J\I]^_ _ dT6N +)*z5K*L)MNCw||nF:dhh3G2HICui0 crddlm}m}m} |jj } ||jd} |r|n|j | _|j| _|j| _ |j| _ |jj| _ |jjj|j } d| j"dt%|j&| _|j+||| _| j/|| _| j3| ||S)ae Add current video (movie, tv-show, season or episode) as sync item for specified device. See :func:`~plexapi.myplex.MyPlexAccount.sync` for possible exceptions. Parameters: videoQuality (int): idx of quality of the video, one of VIDEO_QUALITY_* values defined in :mod:`~plexapi.sync` module. client (:class:`~plexapi.myplex.MyPlexDevice`): sync destination, see :func:`~plexapi.myplex.MyPlexAccount.sync`. clientId (str): sync destination, see :func:`~plexapi.myplex.MyPlexAccount.sync`. limit (int): maximum count of items to sync, unlimited if `None`. unwatched (bool): if `True` watched videos wouldn't be synced. title (str): descriptive title for the new :class:`~plexapi.sync.SyncItem`, if empty the value would be generated from metadata of current media. Returns: :class:`~plexapi.sync.SyncItem`: an instance of created syncItem. r)SyncItemrrNrr)clientclientId)rrrrrOr\rir4 rootTitlerE contentType METADATA_TYPE metadataTypemachineIdentifierr sectionByIDr,rrr(rrrrrsync) rHrrrrrr4rrrmyplex sync_itemrs rJrz Video.sync's& A@++-T\\40 #(%d.D.D.F "jj  $ !%!3!3 &*ll&D&D #,,&&2243H3HI)',,vj>R=ST !== : "/";";L"I {{9Vh{GGrL)enrrNNN)r)r)r)NrNF)NNNFN)__name__ __module__ __qualname____doc__rKrPrdrir~rrrrrrLrJr!r!sH<J6K0$$$6 0LP6;kZ#HrLr!ceZdZdZdZdZdZdZedZ edZ edZ edZ ed Z d Zd Zd Zd ZedZy)Movieul Represents a single Movie. Attributes: TAG (str): 'Video' TYPE (str): 'movie' audienceRating (float): Audience rating (usually from Rotten Tomatoes). audienceRatingImage (str): Key to audience rating image (rottentomatoes://image.rating.spilled). chapters (List<:class:`~plexapi.media.Chapter`>): List of Chapter objects. chapterSource (str): Chapter source (agent; media; mixed). collections (List<:class:`~plexapi.media.Collection`>): List of collection objects. contentRating (str) Content rating (PG-13; NR; TV-G). countries (List<:class:`~plexapi.media.Country`>): List of countries objects. directors (List<:class:`~plexapi.media.Director`>): List of director objects. duration (int): Duration of the movie in milliseconds. editionTitle (str): The edition title of the movie (e.g. Director's Cut, Extended Edition, etc.). enableCreditsMarkerGeneration (int): Setting that indicates if credits markers detection is enabled. (-1 = Library default, 0 = Disabled) genres (List<:class:`~plexapi.media.Genre`>): List of genre objects. guids (List<:class:`~plexapi.media.Guid`>): List of guid objects. labels (List<:class:`~plexapi.media.Label`>): List of label objects. languageOverride (str): Setting that indicates if a language is used to override metadata (eg. en-CA, None = Library default). markers (List<:class:`~plexapi.media.Marker`>): List of marker objects. media (List<:class:`~plexapi.media.Media`>): List of media objects. originallyAvailableAt (datetime): Datetime the movie was released. originalTitle (str): Original title, often the foreign title (転々; 엽기적인 그녀). primaryExtraKey (str) Primary extra key (/library/metadata/66351). producers (List<:class:`~plexapi.media.Producer`>): List of producers objects. rating (float): Movie critic rating (7.9; 9.8; 8.1). ratingImage (str): Key to critic rating image (rottentomatoes://image.rating.rotten). ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects. roles (List<:class:`~plexapi.media.Role`>): List of role objects. slug (str): The clean watch.plex.tv URL identifier for the movie. similar (List<:class:`~plexapi.media.Similar`>): List of Similar objects. sourceURI (str): Remote server URI (server:///com.plexapp.plugins.library) (remote playlist item only). studio (str): Studio that created movie (Di Bonaventura Pictures; 21 Laps Entertainment). tagline (str): Movie tag line (Back 2 Work; Who says men can't change?). theme (str): URL to theme resource (/library/metadata//theme/). ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object. useOriginalTitle (int): Setting that indicates if the original title is used for the movie (-1 = Library default, 0 = No, 1 = Yes). viewOffset (int): View offset in milliseconds. writers (List<:class:`~plexapi.media.Writer`>): List of writers objects. year (int): Year movie was released. r!moviecp tj||tj||tjt |j jd|_|j jd|_ |j|tj|_ |j jd|_|j|tj|_|j jd|_|j|tj$|_|j|tj(|_tjt,|j jd|_|j jd|_tjt,|j jdd|_|j|tj4|_|j|tj8|_|j|tj<|_|j jd |_ |j|tjB|_"|j|tjF|_ tjH|j jd d |_%|j jd |_&|j jd |_'|j|tjP|_)tjt |j jd|_*|j jd|_+|j|tjX|_-|j|tj\|_/|j jd|_0|j|tjb|_2|j jd|_3|j jd|_4|j jd|_5|j jd|_6|jo|tjp|_9tjt,|j jdd|_:tjt,|j jdd|_;|j|tjx|_=tjt,|j jd|_>y)r#audienceRatingaudienceRatingImage chapterSource contentRatingduration editionTitleenableCreditsMarkerGeneration-1languageOverrideoriginallyAvailableAt%Y-%m-%d originalTitleprimaryExtraKeyrating ratingImageslugsourcestudiotaglinethemeuseOriginalTitle viewOffsetryearN)?r!rKrrrCrFr<r=rrr>rChapterchaptersr Collection collectionsrCountry countriesDirector directorsrDrrrGenregenresGuidguidsLabellabelsrMarkermarkersMediar;rrrProducer producersrrRatingratingsRolerolesrSimilarsimilar sourceURIrrrfindItemUltraBlurColorsultraBlurColorsrrWriterwritersrrGs rJrKzMovie._loadDatas d#4&#jj @P0QR#';;??3H#I tU]]; ![[___=>>$0@0@A![[___=emm<enn= 3  (CD  KKOON;-2ZZT[[__Mlnr=s-t*nnT5;;7 ^^D%**5 nnT5;;7 $ 0B C~~dELL9 ^^D%++6 %*%5%5dkkooF]6^`j%k"![[___=#{{/@Aenn=jj (AB ;;??=9~~dELL9 ^^D%**5 KKOOF+ ~~dEMM: 2kkooh/ {{y1 [[__W- #}}T53H3HI % 3 @RTX0Y Z**S$++//,*JK~~dELL9 JJsDKKOOF$;< rLc|jSz Alias to self.roles. r rhs rJactorsz Movie.actorszzrLcb|jDcgc]}|s|jc}Scc}w)z This does not exist in plex xml response but is added to have a common interface to get the locations of the movie. Returns: List of file paths where the movie is found on disk.  iterPartsfilerQs rJ locationszMovie.locations%'+nn&6?d$ ???,,c:td|jDS)z1 Returns True if the movie has a credits marker. c3:K|]}|jdk(ywcreditsNr6rVmarkers rJrXz)Movie.hasCreditsMarker..G6;;)+Ganyrrhs rJhasCreditsMarkerzMovie.hasCreditsMarkerG$,,GGGrLc:td|jDS)? Returns True if any of the media has voice activity analyzed. c34K|]}|jywrhasVoiceActivityrVrs rJrXz)Movie.hasVoiceActivity..Be5))Br(rrhs rJr/zMovie.hasVoiceActivityBtzzBBBrLc:td|jDS)P Returns True if any of the media parts has generated preview (BIF) thumbnails. c3VK|]!}|jD]}|j#ywrpartshasPreviewThumbnailsrVrrRs rJrXz-Movie.hasPreviewThumbnails..*]QVQ\Q\]4,,],]')r3rhs rJr:zMovie.hasPreviewThumbnails]$**]]]rLc:|jd|jdS) Returns a filename for use in download. z ())r4rrhs rJ_prettyfilenamezMovie._prettyfilenames**R {!,,rLcd|jd}|j|tjdS)z; Returns a list of :class:`~plexapi.media.Review` objects. z?includeReviews=1r!clsrtag)r(rarReviewrHr(s rJreviewsz Movie.reviewss, +,s 7CCrLct|j|jd}|jj|S)zs Returns a list of :class:`~plexapi.video.Movie` objects for other editions of the same movie. )r'zid!)filters)r'r0rsearch)rHrLs rJeditionszMovie.editionss5 II>> ||~$$W$55rLcd}d|ji}|jj|||jjj|Sz* Remove the movie from continue watching. z#/actions/removeFromContinueWatchingr0)rqrr0rOr`rxrrHr(rqs rJremoveFromContinueWatchingz Movie.removeFromContinueWatchingC3t~~. 3vdll6K6K6O6OP rLctj|j}tt ddz |dz |dddz SL Returns the Plex Media Server data directory where the metadata is stored. MetadataMoviesrrmN.bundlersha1hashr'rrrH guid_hashs rJmetadataDirectoryzMovie.metadataDirectoryGNN499- 4 #h.1=9QR=/QX@YYZZrLN)rrrrTAGTYPErrKpropertyrrr)r/r:rCrJrNrSr_rrLrJrrMs-\ C DM'=R@@HHCC^^-D 6[[rLrceZdZdZdZdZdZdZdZe dZ e dZ d Z dd Z d Zdd ZdZddZdZdZddZe dZy )ra Represents a single Show (including all seasons and episodes). Attributes: TAG (str): 'Directory' TYPE (str): 'show' audienceRating (float): Audience rating (TMDB or TVDB). audienceRatingImage (str): Key to audience rating image (tmdb://image.rating). audioLanguage (str): Setting that indicates the preferred audio language. autoDeletionItemPolicyUnwatchedLibrary (int): Setting that indicates the number of unplayed episodes to keep for the show (0 = All episodes, 5 = 5 latest episodes, 3 = 3 latest episodes, 1 = 1 latest episode, -3 = Episodes added in the past 3 days, -7 = Episodes added in the past 7 days, -30 = Episodes added in the past 30 days). autoDeletionItemPolicyWatchedLibrary (int): Setting that indicates if episodes are deleted after being watched for the show (0 = Never, 1 = After a day, 7 = After a week, 100 = On next refresh). childCount (int): Number of seasons (including Specials) in the show. collections (List<:class:`~plexapi.media.Collection`>): List of collection objects. contentRating (str) Content rating (PG-13; NR; TV-G). duration (int): Typical duration of the show episodes in milliseconds. enableCreditsMarkerGeneration (int): Setting that indicates if credits markers detection is enabled. (-1 = Library default, 0 = Disabled). episodeSort (int): Setting that indicates how episodes are sorted for the show (-1 = Library default, 0 = Oldest first, 1 = Newest first). flattenSeasons (int): Setting that indicates if seasons are set to hidden for the show (-1 = Library default, 0 = Hide, 1 = Show). genres (List<:class:`~plexapi.media.Genre`>): List of genre objects. guids (List<:class:`~plexapi.media.Guid`>): List of guid objects. index (int): Plex index number for the show. key (str): API URL (/library/metadata/). labels (List<:class:`~plexapi.media.Label`>): List of label objects. languageOverride (str): Setting that indicates if a language is used to override metadata (eg. en-CA, None = Library default). leafCount (int): Number of items in the show view. locations (List): List of folder paths where the show is found on disk. network (str): The network that distributed the show. originallyAvailableAt (datetime): Datetime the show was released. originalTitle (str): The original title of the show. rating (float): Show rating (7.9; 9.8; 8.1). ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects. roles (List<:class:`~plexapi.media.Role`>): List of role objects. seasonCount (int): Number of seasons (excluding Specials) in the show. showOrdering (str): Setting that indicates the episode ordering for the show (None = Library default, tmdbAiring = The Movie Database (Aired), aired = TheTVDB (Aired), dvd = TheTVDB (DVD), absolute = TheTVDB (Absolute)). similar (List<:class:`~plexapi.media.Similar`>): List of Similar objects. slug (str): The clean watch.plex.tv URL identifier for the show. studio (str): Studio that created show (Di Bonaventura Pictures; 21 Laps Entertainment). subtitleLanguage (str): Setting that indicates the preferred subtitle language. subtitleMode (int): Setting that indicates the auto-select subtitle mode. (-1 = Account default, 0 = Manually selected, 1 = Shown with foreign audio, 2 = Always enabled). tagline (str): Show tag line. theme (str): URL to theme resource (/library/metadata//theme/). ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object. useOriginalTitle (int): Setting that indicates if the original title is used for the show (-1 = Library default, 0 = No, 1 = Yes). viewedLeafCount (int): Number of items marked as played in the show view. year (int): Year the show was released. Directoryshowepisodec tj||tjt|j j d|_|j j d|_|j j dd|_ tjt|j j dd|_ tjt|j j dd|_ tjt|j j d|_ |j|tj |_|j j d |_tjt|j j d |_tjt|j j d d |_tjt|j j d d |_tjt|j j dd |_|j|tj.|_|j|tj2|_tjt|j j d|_|j8j;dd|_|j|tj<|_|j j d|_ tjt|j j d|_!|jE|dd|_#|j j d|_$tjJ|j j dd|_&|j j d|_'tjt|j j d|_(|j|tjR|_*|j|tjV|_,tjt|j j d|j|_-|j j d|_.|j|tj^|_0|j j d|_1|j j d|_2|j j dd|_3tjt|j j d d |_4|j j d!|_5|j j d"|_6|jo|tjp|_9tjt|j j d#d |_:tjt|j j d$|_;tjt|j j d%|_<y&)'r#rr audioLanguager)&autoDeletionItemPolicyUnwatchedLibrary0$autoDeletionItemPolicyWatchedLibrary childCountrrrr episodeSortflattenSeasonsindexrr leafCountrtr)etagnetworkrrrr seasonCount showOrderingrrsubtitleLanguage subtitleModerrrviewedLeafCountrN)=r!rKrrCrFr<r=rrrirDrjrlrmr>rrrrrrrnrorrrrrpr(replacerrrrq listAttrsrrsr;rrrrrrr rtrur r rrrvrwrrr rrrrxrrGs rJrKzShow._loadData5s6 d##jj @P0QR#';;??3H#I ![[___bA6;jj !I3O7Q349JJ !GM5O1**S$++//,*GH>>$0@0@A![[___= 3  (CD -2ZZT[[__Mlnr=s-t* ::c4;;??=$+OP#jjdkkoo>NPT.UVnnT5;;7 ^^D%**5 ZZT[[__W%=> 88##K4nnT5;;7 $ 0B CC)EFf:F{{y1 %*%5%5dkkooF]6^`j%k"![[___=jj (AB ~~dELL9 ^^D%**5  ::c4;;??=$//+Z[ KKOON;~~dEMM: KKOOF+ kkooh/ $ 0BB G!JJsDKKOOND,QR{{y1 [[__W- #}}T53H3HI % 3 @RTX0Y Z$zz#t{{?P/QRJJsDKKOOF$;< rLc#>K|jD]}|ywr)seasons)rHseasons rJ__iter__z Show.__iter__bs lln FL c|jSrrrhs rJrz Show.actorsfrrLcFt|j|jk(S)z+ Returns True if the show is fully played. boolrxrqrhs rJisPlayedz Show.isPlayedkD((DNN:;;rLc v|jd}tt|j|tddS)z Returns show's On Deck :class:`~plexapi.video.Video` object or `None`. If show is unwatched, return will likely be the first episode. ?includeOnDeck=1OnDeckrENr(r]iterraEpisoderIs rJonDeckz Show.onDeckp6 *+D'IJDQQrLNc|jd}|(t|ts|j|t|S|t|tr-t|tr|}n|}|j|t|St d)ah Returns the season with the specified title or number. Parameters: title (str): Title of the season to return. season (int): Season number (default: None; required if title not specified). Raises: :exc:`~plexapi.exceptions.BadRequest`: If title or season parameter is missing. /children?excludeAllLeaves=1 title__iexactrpz-Missing argument: title or season is required)r(rrDrrr )rHr4r}r(rps rJr}z Show.seasonws} 67  Zs%;>>#vU>C C  :eS#9%%>>#vU>; ;HIIrLc h|jd}|j|tfd|ji|S)zG Returns a list of :class:`~plexapi.video.Season` objects in the show. rcontainer_size)r(rarrmrHkwargsr(s rJr|z Show.seasonss4 67tsFU4??UfUUrLc|jd}||j|t|S|||j|t||Std)a Find a episode using a title or season and episode. Parameters: title (str): Title of the episode to return season (int): Season number (default: None; required if title not specified). episode (int): Episode number (default: None; required if title not specified). Raises: :exc:`~plexapi.exceptions.BadRequest`: If title or season and episode parameters are missing. /allLeavesr parentIndexrpz:Missing argument: title or season and episode are required)r(rrr )rHr4r}rgr(s rJrgz Show.episodes] *%  >>#we>D D  G$7>>#wF'>R RUVVrLc P|jd}|j|tfi|S)zH Returns a list of :class:`~plexapi.video.Episode` objects in the show. rr(rarrs rJepisodesz Show.episodess* *%tsG6v66rLc(|j|||S)z/ Alias to :func:`~plexapi.video.Show.episode`. rg)rHr4r}rgs rJr=zShow.gets||E6733rLc&|jdSzB Returns list of watched :class:`~plexapi.video.Episode` objects. r) viewCount__gtrrhs rJwatchedz Show.watched}}1}--rLc&|jdSzD Returns list of unwatched :class:`~plexapi.video.Episode` objects. r)r9rrhs rJrzShow.unwatched}}q}))rLc g}|jD]b}|rEtjj|dt |j j dn|}||j||fi|z }d|S)a  Download all episodes from the show. See :func:`~plexapi.base.Playable.download` for details. Parameters: savepath (str): Defaults to current working dir. keep_original_name (bool): True to keep the original filename otherwise a friendlier filename is generated. subfolders (bool): True to separate episodes in to season folders. **kwargs: Additional options passed into :func:`~plexapi.base.PlexObject.getStreamURL`. zSeason )rrsrtjoinr seasonNumberzfilldownload)rHsavepathkeep_original_name subfoldersr filepathsrg _savepaths rJrz Show.downloads }} SGbl XW=Q=Q9R9X9XYZ9[8\/]^rzI ))))5GR6R RI SrLctj|j}tt ddz |dz |dddz SrWrXzTV ShowsrrmNrZr[r]s rJr_zShow.metadataDirectorysGNN499- 4 #j09Q<?Yqr]OSZB[[\\rLNNr)NFF)rrrrrarbrrKr~rcrrrr}r|rgrr=rrrr_rrLrJrrs9t C DM+=Z<<RJ*V W$7 4.* ]]rLrceZdZdZdZdZdZdZdZdZ e dZ e d Z d Z dd Zd ZddZdZdZdZddZdZe dZy )ra4 Represents a single Season. Attributes: TAG (str): 'Directory' TYPE (str): 'season' audienceRating (float): Audience rating. audioLanguage (str): Setting that indicates the preferred audio language. collections (List<:class:`~plexapi.media.Collection`>): List of collection objects. guids (List<:class:`~plexapi.media.Guid`>): List of guid objects. index (int): Season number. key (str): API URL (/library/metadata/). labels (List<:class:`~plexapi.media.Label`>): List of label objects. leafCount (int): Number of items in the season view. parentGuid (str): Plex GUID for the show (plex://show/5d9c086fe9d5a1001f4d9fe6). parentIndex (int): Plex index number for the show. parentKey (str): API URL of the show (/library/metadata/). parentRatingKey (int): Unique key identifying the show. parentSlug (str): The clean watch.plex.tv URL identifier for the show. parentStudio (str): Studio that created show. parentTheme (str): URL to show theme resource (/library/metadata//theme/). parentThumb (str): URL to show thumbnail image (/library/metadata//thumb/). parentTitle (str): Name of the show for the season. rating (float): Season rating (7.9; 9.8; 8.1). ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects. subtitleLanguage (str): Setting that indicates the preferred subtitle language. subtitleMode (int): Setting that indicates the auto-select subtitle mode. (-1 = Series default, 0 = Manually selected, 1 = Shown with foreign audio, 2 = Always enabled). ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object. viewedLeafCount (int): Number of items marked as played in the season view. year (int): Year the season was released. rer}rgctj||tjt|j j d|_|j j dd|_|j|tj|_ |j|tj|_tjt|j j d|_|j"j%dd|_|j|tj&|_tjt|j j d|_|j j d|_tjt|j j d|_|j j d |_tjt|j j d |_|j j d |_|j j d |_|j j d |_|j j d|_|j j d|_tjt|j j d|_|j|tj@|_!|j j dd|_"tjt|j j dd|_#|jI|tjJ|_&tjt|j j d|_'tjt|j j d|_(y)r#rrir)rprrq parentGuidr parentKeyparentRatingKey parentSlug parentStudio parentTheme parentThumb parentTitlerrvrwrrxrN))r!rKrrCrFr<r=rrir>rrrrrrDrpr(ryrrrqrrrrrrrrrrrrrvrwr rrrxrrGs rJrKzSeason._loadDatas| d##jj @P0QR![[___bA>>$0@0@A^^D%**5 ZZT[[__W%=> 88##K4nnT5;;7 C)EF++//,7 ::c4;;??=+IJ5$zz#t{{?P/QR++//,7 KKOON;;;??=9;;??=9;;??=9jj (AB ~~dELL9 $ 0BB G!JJsDKKOOND,QR#}}T53H3HI$zz#t{{?P/QRJJsDKKOOF$;< rLc#>K|jD]}|ywrr)rHrgs rJr~zSeason.__iter__s }} GM rc Fdjdj|jj|jj ddj dd|j j ddddd|jfDcgc]}|r|c}Scc}w Nz<{}>:/library/metadata/r)r -)rnr __class__rr(ryrrrHps rJ__repr__zSeason.__repr__s}} HH''  !5r:BB;PRS##++C5cr:;1T=N=N>#we>D D  Juc$:%%>>#wDJJe>T TIJJrLc P|jd}|j|tfi|S)zJ Returns a list of :class:`~plexapi.video.Episode` objects in the season. rrrs rJrzSeason.episodesDs* )$tsG6v66rLc&|j||S)z1 Alias to :func:`~plexapi.video.Season.episode`. r)rHr4rgs rJr=z Season.getIs||E7++rLc8|j|jS)z3 Return the season's :class:`~plexapi.video.Show`. rrrhs rJrfz Season.showM~~dnn--rLc&|jdSrrrhs rJrzSeason.watchedQrrLc&|jdSrrrhs rJrzSeason.unwatchedUrrLc bg}|jD]}||j||fi|z }|S)a Download all episodes from the season. See :func:`~plexapi.base.Playable.download` for details. Parameters: savepath (str): Defaults to current working dir. keep_original_name (bool): True to keep the original filename otherwise a friendlier filename is generated. **kwargs: Additional options passed into :func:`~plexapi.base.PlexObject.getStreamURL`. )rr)rHrrrrrgs rJrzSeason.downloadYsF }} RG )))(4FQ&Q QI RrLc8|jd|jS)rf - )rr4rhs rJrizSeason._defaultSyncTitlegs""#3tzzl33rLctj|j}tt ddz |dz |dddz Sr)rr\rrrr]s rJr_zSeason.metadataDirectoryksGNN4??3 4 #j09Q<?Yqr]OSZB[[\\rLr)NF)rrrrrarbrrKr~rrcrrrrgrr=rfrrrrir_rrLrJrrs> C DM=8 <<RK*7 ,..* 4]]rLrc6eZdZdZdZdZdZdZedZ edZ edZ edZ d Z d Zed Zed Zed ZedZedZedZedZedZedZedZdZdZdZdZedZy)ra4 Represents a single Episode. Attributes: TAG (str): 'Video' TYPE (str): 'episode' audienceRating (float): Audience rating (TMDB or TVDB). audienceRatingImage (str): Key to audience rating image (tmdb://image.rating). chapters (List<:class:`~plexapi.media.Chapter`>): List of Chapter objects. chapterSource (str): Chapter source (agent; media; mixed). collections (List<:class:`~plexapi.media.Collection`>): List of collection objects. contentRating (str) Content rating (PG-13; NR; TV-G). directors (List<:class:`~plexapi.media.Director`>): List of director objects. duration (int): Duration of the episode in milliseconds. grandparentArt (str): URL to show artwork (/library/metadata//art/). grandparentGuid (str): Plex GUID for the show (plex://show/5d9c086fe9d5a1001f4d9fe6). grandparentKey (str): API URL of the show (/library/metadata/). grandparentRatingKey (int): Unique key identifying the show. grandparentSlug (str): The clean watch.plex.tv URL identifier for the show. grandparentTheme (str): URL to show theme resource (/library/metadata//theme/). grandparentThumb (str): URL to show thumbnail image (/library/metadata//thumb/). grandparentTitle (str): Name of the show for the episode. guids (List<:class:`~plexapi.media.Guid`>): List of guid objects. index (int): Episode number. labels (List<:class:`~plexapi.media.Label`>): List of label objects. markers (List<:class:`~plexapi.media.Marker`>): List of marker objects. media (List<:class:`~plexapi.media.Media`>): List of media objects. originallyAvailableAt (datetime): Datetime the episode was released. parentGuid (str): Plex GUID for the season (plex://season/5d9c09e42df347001e3c2a72). parentIndex (int): Season number of episode. parentKey (str): API URL of the season (/library/metadata/). parentRatingKey (int): Unique key identifying the season. parentThumb (str): URL to season thumbnail image (/library/metadata//thumb/). parentTitle (str): Name of the season for the episode. parentYear (int): Year the season was released. producers (List<:class:`~plexapi.media.Producer`>): List of producers objects. rating (float): Episode rating (7.9; 9.8; 8.1). ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects. roles (List<:class:`~plexapi.media.Role`>): List of role objects. skipParent (bool): True if the show's seasons are set to hidden. sourceURI (str): Remote server URI (server:///com.plexapp.plugins.library) (remote playlist item only). ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object. viewOffset (int): View offset in milliseconds. writers (List<:class:`~plexapi.media.Writer`>): List of writers objects. year (int): Year the episode was released. r!rgc tj||tj||tjt |j jd|_|j jd|_ |j|tj|_ |j jd|_|j|tj|_|j jd|_|j|tj$|_tjt(|j jd|_|j jd|_|j jd|_|j jd|_tjt(|j jd |_|j jd |_|j jd |_|j jd |_|j jd |_|j|tj<|_tjt(|j jd|_ |j|tjB|_"|j|tjF|_$|j|tjJ|_ tjL|j jdd|_'|j jd|_(tjt(|j jd|_)|j jd|_*tjt(|j jd|_+|j|tjX|_-tjt |j jd|_.|j|tj^|_0|j|tjb|_2tjtf|j jdd|_4|j jd|_5|jm|tjn|_8tjt(|j jdd|_9|j|tjt|_;tjt(|j jd|_<|j jd|_=tjt(|j jd|_>|j jd|_?y) r#rrrrrgrandparentArtgrandparentGuidgrandparentKeygrandparentRatingKeygrandparentSluggrandparentThemegrandparentThumbgrandparentTitlerprrrrr parentYearr skipParentrkrrrrrrrN)@r!rKrrrCrFr<r=rrr>rrrrrrrrrrDrrrrrrrrrrrrprrrrrr;rrrrrrrrrrrr rrr r rrrrrr _parentKey_parentRatingKey _parentThumbrGs rJrKzEpisode._loadDatas d#4&#jj @P0QR#';;??3H#I tU]]; ![[___=>>$0@0@A![[___=enn= 3  (CD "kkoo.>?#{{/@A"kkoo.>?$)JJsDKKOODZ4[$\!#{{/@A $ 0B C $ 0B C $ 0B C^^D%**5 ZZT[[__W%=> nnT5;;7 ~~dELL9 ^^D%++6 %*%5%5dkkooF]6^`j%k"++//,7 ::c4;;??=+IJ;;??=9**S$++//,*GHenn=jj (AB ~~dELL9 ^^D%**5 **T4;;??<+MN2#}}T53H3HI**S$++//,*JK~~dELL9 JJsDKKOOF$;< ++//+6 % 3 @Q0R S KKOOM:rLcj|jr |jS|jrd|jSy)z9 Returns the parentKey. Refer to the Episode attributes. rN)rrrhs rJrzEpisode.parentKeys5 ???? "   '(<(<'=> >rLc2|j |jS|jrQ|jjdr6tjt |jj ddS|jr|jjSy)z? Returns the parentRatingKey. Refer to the Episode attributes. Nr/) rr startswithrrCrDsplit_seasonr0rhs rJrzEpisode.parentRatingKeysz  ,(( (   !2!2!=!=>R!S::c4#4#4#:#:3#?#BC C <<<<)) )rLcx|jr |jS|jr|jjSy)z; Returns the parentThumb. Refer to the Episode attributes. N)rrr2rhs rJrzEpisode.parentThumbs3   $$ $ <<<<%% %rLc|jr6|j*|j|jd|jSy)zX Returns the :class:`~plexapi.video.Season` object by querying for the show's children. Nz#/children?excludeAllLeaves=1&index=)rrrrhs rJrzEpisode._seasonsE   4#3#3#?>>T%8%8$99\]a]m]m\n"op prLc Fdjdj|jj|jj ddj dd|j j ddddd|jfDcgc]}|r|c}Scc}wr)rnrrrr(ryr seasonEpisoders rJrzEpisode.__repr__s}} HH''  !5r:BB;PRS((00c:3B?@$BTBTAUV"A    rcR|jd|jd|jS)rAr)rrr4rhs rJrCzEpisode._prettyfilename s+''(D,>,>+?s4::,OOrLc|jSrrrhs rJrzEpisode.actorsrrLcb|jDcgc]}|s|jc}Scc}w)z This does not exist in plex xml response but is added to have a common interface to get the locations of the episode. Returns: List of file paths where the episode is found on disk. rrQs rJrzEpisode.locationsrrc|jS)z Returns the episode number. rrhs rJ episodeNumberzEpisode.episodeNumberrrLct|jtr |jS|jr|jjSy)z& Returns the episode's season number. N)rrrDrrprhs rJrzEpisode.seasonNumber"s: d&& ,## # \\<<%% %rLcdt|jjddt|jjdS)zF Returns the s00e00 string containing the season and episode numbers. sre)rrrrrhs rJrzEpisode.seasonEpisode+sF3t(()//231S9K9K5L5R5RST5U4VWWrLc:td|jDS)z6 Returns True if the episode has a commercial marker. c3:K|]}|jdk(yw) commercialNr"r#s rJrXz.Episode.hasCommercialMarker..3sJ66;;,.Jr&r'rhs rJhasCommercialMarkerzEpisode.hasCommercialMarker0sJT\\JJJrLc:td|jDS)z2 Returns True if the episode has an intro marker. c3:K|]}|jdk(yw)introNr"r#s rJrXz)Episode.hasIntroMarker..8sEf6;;')Er&r'rhs rJhasIntroMarkerzEpisode.hasIntroMarker5sE EEErLc:td|jDS)z3 Returns True if the episode has a credits marker. c3:K|]}|jdk(ywr r"r#s rJrXz+Episode.hasCreditsMarker..=r%r&r'rhs rJr)zEpisode.hasCreditsMarker:r*rLc:td|jDS)r,c34K|]}|jywrr.r0s rJrXz+Episode.hasVoiceActivity..Br1r2r3rhs rJr/zEpisode.hasVoiceActivity?r4rLc:td|jDS)r6c3VK|]!}|jD]}|j#ywrr8r;s rJrXz/Episode.hasPreviewThumbnails..Gr<r=r3rhs rJr:zEpisode.hasPreviewThumbnailsDr>rLc8|j|jS)z7" Return the episode's :class:`~plexapi.video.Season`. rrhs rJr}zEpisode.seasonIrrLc8|j|jS)z5" Return the episode's :class:`~plexapi.video.Show`. )rrrhs rJrfz Episode.showMs~~d1122rLcl|jd|jd|jd|jS)rfrz - (z) )rrrr4rhs rJrizEpisode._defaultSyncTitleQs=''(D,<,<+=T$BTBTAUUWX\XbXbWcddrLcd}d|ji}|jj|||jjj|SrPrQrRs rJrSz"Episode.removeFromContinueWatchingUrTrLctj|j}tt ddz |dz |dddz Sr)rr\rrrr]s rJr_zEpisode.metadataDirectory\sINN4#7#78 4 #j09Q<?Yqr]OSZB[[\\rLN)rrrrrarbrrKrrrrrrrCrcrrrrrrrr)r/r:r}rfrirSr_rrLrJrrrs{-\ C DM.;`    P@@XXKKFFHHCC^^.3e]]rLrcHeZdZdZdZdZdZdZedZ dZ edZ y) Clipa Represents a single Clip. Attributes: TAG (str): 'Video' TYPE (str): 'clip' duration (int): Duration of the clip in milliseconds. extraType (int): Unknown. index (int): Plex index number for the clip. media (List<:class:`~plexapi.media.Media`>): List of media objects. originallyAvailableAt (datetime): Datetime the clip was released. skipDetails (int): Unknown. subtype (str): Type of clip (trailer, behindTheScenes, sceneOrSample, etc.). thumbAspectRatio (str): Aspect ratio of the thumbnail image. viewOffset (int): View offset in milliseconds. year (int): Year clip was released. r!clipctj||tj||||_t j |j jd|_t jt|j jd|_ t jt|j jd|_ t jt|j jd|_ |j|tj |_t j |j jdd|_t jt|j jd|_|j jd|_|j jd |_t jt|j jd d |_t jt|j jd |_y )r#r$r extraTyperprr skipDetailssubtypethumbAspectRatiorrrN)r!rKrr:rr;r<r=r$rCrDrrrpr>rrrrrrrrrGs rJrKzClip._loadData|sj d#4& ''  (BC  3  (CD C)EFZZT[[__W%=> ^^D%++6 %*%5%5 KKOO3 4j&B" ::c4;;??=+IJ{{y1 $ 0B C**S$++//,*JKJJsDKKOOF$;< rLcb|jDcgc]}|s|jc}Scc}w)z This does not exist in plex xml response but is added to have a common interface to get the locations of the clip. Returns: List of file paths where the clip is found on disk. rrQs rJrzClip.locationsrrc|jS)rArgrhs rJrCzClip._prettyfilenamerjrLctj|j}tt ddz |dz |dddz SrVr[r]s rJr_zClip.metadataDirectoryr`rLN) rrrrrarbrrKrcrrCr_rrLrJrrcsN  C DM=$@@[[rLrc(eZdZdZfdZdZxZS)Extraz< Represents a single Extra (trailer, behindTheScenes, etc). ctt| ||j}|j|_|j |_|j |_yr#N)superrrK_parentr,r-r.)rHrIparentrs rJrKzExtra._loadDatasG eT$T* & 7 7!'!9!9#)#=#= rLc:|jd|jdSr@)r4rrhs rJrCzExtra._prettyfilenames**R ~Q//rL)rrrrrKrC __classcell__)rs@rJrrsF>0rLrceZdZdZdZdZy) MovieSessionzh Represents a single Movie session loaded from :func:`~plexapi.server.PlexServer.sessions`. Tc\tj||tj||yr!)rrKr rGs rJrKzMovieSession._loadData  d#dD)rLNrrrr _SESSIONTYPErKrrLrJr(r(L*rLr(ceZdZdZdZdZy)EpisodeSessionzj Represents a single Episode session loaded from :func:`~plexapi.server.PlexServer.sessions`. Tc\tj||tj||yr!)rrKr rGs rJrKzEpisodeSession._loadData"$%dD)rLNr+rrLrJr/r/r-rLr/ceZdZdZdZdZy) ClipSessionzg Represents a single Clip session loaded from :func:`~plexapi.server.PlexServer.sessions`. Tc\tj||tj||yr!)rrKr rGs rJrKzClipSession._loadData  tT"dD)rLNr+rrLrJr3r3r-rLr3ceZdZdZdZdZy) MovieHistoryzm Represents a single Movie history entry loaded from :func:`~plexapi.server.PlexServer.history`. Tc\tj||tj||yr!)rrKr rGs rJrKzMovieHistory._loadDatar*rLNrrrr _HISTORYTYPErKrrLrJr7r7r-rLr7ceZdZdZdZdZy)EpisodeHistoryzo Represents a single Episode history entry loaded from :func:`~plexapi.server.PlexServer.history`. Tc\tj||tj||yr!)rrKr rGs rJrKzEpisodeHistory._loadDatar1rLNr9rrLrJr<r<r-rLr<ceZdZdZdZdZy) ClipHistoryzl Represents a single Clip history entry loaded from :func:`~plexapi.server.PlexServer.history`. Tc\tj||tj||yr!)rrKr rGs rJrKzClipHistory._loadDatar5rLNr9rrLrJr?r?r-rLr?)3rs functoolsrpathlibr urllib.parserplexapirr plexapi.baserr r r plexapi.exceptionsr plexapi.mixinsr rrrrrrrrrrrrrrrrrrr!registerPlexObjectrrrrrrr(r/r3r7r<r?rrLrJrIsc %# NN)xH 2xHv ^[ 8?,={IWb ij ^[^[BX] ?,={IWb ij X]X]vc] ;  im c]c]Lm] 8 im m]m]`<[ 8<[<[~ 0D 0  *; * * *[' * * *+t * * *; * * *[' * * *+t * *rL