ljddlZddlZddlZddlZddlZddlZddlmZmZmZddl m Z m Z m Z m Z ddlZ ddlZddlmZddlmZ ddlZddlmZmZmZmZmZmZmZmZddlm Z m!Z!ddl"m#Z#dd l$m%Z%m&Z&m'Z'm(Z(dd l)m*Z*dd l+m,Z,dd l-m.Z.dd l/m0Z0m1Z1ddl2m3Z4Gdde Z5Gdde Z6Gdde Z7Gdde Z8Gdde Z9Gdde Z:Gdde Z;Gdde Z<Gdd Z=Gd!d"Z>d+d#Z?d$Z@Gd%d&e ZAGd'd(e ZBGd)d*e ZCy#e$rdZYwxYw#e$rdZYwxYw),N)datetime timedeltatimezone) parse_qsl urlencodeurlsplit urlunsplit) serialization)ed25519) BASE_HEADERSCONFIGTIMEOUTX_PLEX_ENABLE_FAST_CONNECTX_PLEX_IDENTIFIERlog logfilterutils) PlexObjectcached_data_property) PlexClient) BadRequestNotFound UnauthorizedTwoFactorRequired)LibrarySection) PlexServer)PlexSonosClient)SyncItemSyncList)_codescfeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZfd ZdZdZdZedZedZedZ e!dZ"dZ#d Z$d[d!Z%d"Z&d\d#Z'd$Z(d%Z)d&Z*d'Z+d(Z,d)Z- d]d*Z. d]d+Z/ d]d,Z0d-Z1d.Z2d^d/Z3d^d0Z4d1Z5d2Z6d3Z7d4Z8d5Z9 d_d6Z:d7Z;d8Zd;Z?d<Z@d=ZAd>ZBd?ZCd@ZDd\dAZEd\dBZFd\dCZGdDZHd\dEZIdFZJdGZKdHZLdadIZMdJZNdKZOdLZPdMZQdNZRdOZSdPZTdbdQZUe!dRZVdSZWdTZXdUZYdVZZdWZ[dXZ\dYZ]xZ^S)c MyPlexAccounta MyPlex account and profile information. This object represents the data found Account on the myplex.tv servers at the url https://plex.tv/api/v2/user. You may create this object directly by passing in your username & password (or token). There is also a convenience method provided at :class:`~plexapi.server.PlexServer.myPlexAccount()` which will create and return this object. Parameters: username (str): Plex login username if not using a token. password (str): Plex login password if not using a token. token (str): Plex authentication token instead of username and password. session (requests.Session, optional): Use your own session object if you want to cache the http responses from PMS. timeout (int): timeout in seconds on initial connect to myplex (default config.TIMEOUT). code (str): Two-factor authentication code to use when logging in with username and password. remember (bool): Remember the account token for 14 days (Default True). Attributes: key (str): 'https://plex.tv/api/v2/user' adsConsent (str): Unknown. adsConsentReminderAt (str): Unknown. adsConsentSetAt (str): Unknown. anonymous (str): Unknown. authToken (str): The account token. backupCodesCreated (bool): If the two-factor authentication backup codes have been created. confirmed (bool): If the account has been confirmed. country (str): The account country. email (str): The account email address. emailOnlyAuth (bool): If login with email only is enabled. experimentalFeatures (bool): If experimental features are enabled. friendlyName (str): Your account full name. entitlements (List): List of devices your allowed to use with this account. guest (bool): If the account is a Plex Home guest user. hasPassword (bool): If the account has a password. home (bool): If the account is a Plex Home user. homeAdmin (bool): If the account is the Plex Home admin. homeSize (int): The number of accounts in the Plex Home. id (int): The Plex account ID. joinedAt (datetime): Date the account joined Plex. locale (str): the account locale mailingListActive (bool): If you are subscribed to the Plex newsletter. mailingListStatus (str): Your current mailing list status. maxHomeSize (int): The maximum number of accounts allowed in the Plex Home. pin (str): The hashed Plex Home PIN. profileAutoSelectAudio (bool): If the account has automatically select audio and subtitle tracks enabled. profileDefaultAudioLanguage (str): The preferred audio language for the account. profileDefaultSubtitleLanguage (str): The preferred subtitle language for the account. profileAutoSelectSubtitle (int): The auto-select subtitle mode (0 = Manually selected, 1 = Shown with foreign audio, 2 = Always enabled). profileDefaultSubtitleAccessibility (int): The subtitles for the deaf or hard-of-hearing (SDH) searches mode (0 = Prefer non-SDH subtitles, 1 = Prefer SDH subtitles, 2 = Only show SDH subtitles, 3 = Only shown non-SDH subtitles). profileDefaultSubtitleForced (int): The forced subtitles searches mode (0 = Prefer non-forced subtitles, 1 = Prefer forced subtitles, 2 = Only show forced subtitles, 3 = Only show non-forced subtitles). protected (bool): If the account has a Plex Home PIN enabled. rememberExpiresAt (datetime): Date the token expires. restricted (bool): If the account is a Plex Home managed user. roles: (List) Lit of account roles. Plexpass membership listed here. scrobbleTypes (List): Unknown. subscriptionActive (bool): If the account's Plex Pass subscription is active. subscriptionDescription (str): Description of the Plex Pass subscription. subscriptionFeatures: (List) List of features allowed on your Plex Pass subscription. subscriptionPaymentService (str): Payment service used for your Plex Pass subscription. subscriptionPlan (str): Name of Plex Pass subscription plan. subscriptionStatus (str): String representation of ``subscriptionActive``. subscriptionSubscribedAt (datetime): Date the account subscribed to Plex Pass. thumb (str): URL of the account thumbnail. title (str): The title of the account (username or friendly name). twoFactorEnabled (bool): If two-factor authentication is enabled. username (str): The account username. uuid (str): The account UUID. z6https://plex.tv/api/servers/{machineId}/shared_serverszhttps://plex.tv/api/home/usersz,https://plex.tv/api/home/users?title={title}z6https://plex.tv/api/home/users?invitedEmail={username}zAhttps://plex.tv/api/servers/{machineId}/shared_servers/{serverId}z'https://plex.tv/api/servers/{machineId}z(https://plex.tv/api/v2/sharings/{userId}z'https://plex.tv/api/home/users/{userId}z5https://plex.tv/api/v2/home/users/restricted/{userId}z#https://plex.tv/api/v2/users/signinz$https://plex.tv/api/v2/users/signoutz$https://plex.tv/api/v2/user/webhooksz8https://plex.tv/api/v2/user/{userUUID}/settings/opt_outsz https://plex.tv/api/v2/pins/linkz+https://plex.tv/api/v2/user/view_state_synczhttps://plex.tv/api/v2/pingzhttps://vod.provider.plex.tvzhttps://music.provider.plex.tvz!https://discover.provider.plex.tvz!https://metadata.provider.plex.tvzhttps://plex.tv/api/v2/userc6tj|xstjd|_|xst j |_|xst|_ g|_ d|_ |j|||||\}} tt|?||| y)Nzauth.server_tokenr)r add_secretr get_tokenrequestsSession_sessionr_timeout _sonos_cache_sonos_cache_timestamp_signinsuperr"__init__) selfusernamepasswordtokensessiontimeoutcoderememberdatainitpath __class__s ;/DATA/.local/lib/python3.12/site-packages/plexapi/myplex.pyr/zMyPlexAccount.__init__s**5+SFJJ?R4ST 58#3#3#5 *7 &'#h$'Rh mT+D$Ac`|jr'|j|j|jfS|xstjd|xstjd|d}|r||d<|j|j |j j||}||j fS)Nzauth.myplex_usernamezauth.myplex_password)loginr2 rememberMeverificationCode)methodr8r5)r&querykeyr r%SIGNINr)post)r0r1r2r6r7r5payloadr8s r;r-zMyPlexAccount._signins ;;::dhh'1 1C,B!C FFJJ/E$F"  *.G& 'zz$++dmm.@.@wX_z`T[[  r<cd|j|j|jjS)zE Sign out of the Plex account. Invalidates the authentication token. rA)rBSIGNOUTr)deleter0s r;signoutzMyPlexAccount.signouts#zz$,,t}}/C/CzDDr<ctj|jjd|_g|_|jjd|_|jjd|_|jjd|_|jjd|_ |j|_ tjt|jjd|_tjt|jjd|_|jjd|_|jjd |_tjt|jjd |_tjt|jjd |_|jjd |_tjt|jjd |_tjt|jjd|_tjt|jjd|_tjt|jjd|_tjt2|jjd|_tjt2|jjd|_tj8|jjd|_|jjd|_tjt|jjd|_|jjd|_ tjt2|jjd|_!|jjd|_"tjt|jjd|_#tj8|jjd|_$tjt|jjd|_%|jjdjMdDcgc]}tjt2|c}|_'|jjd|_(|jjd|_)tjt|jjd |_*|jjd!|_+|jjd"|_,|j[d#}tjt|jjd$|_.|jjd%|_/|jjd&|_0|jjd'|_1|jjd(|_2tj8|jjd)xsd*d+|_3|j[d,}tjt|jjd-|_4|jjd.|_5|jjd/|_6tjt2|jjd0|_7tjt2|jjd1|_8tjt2|jjd2|_9d*|_:y*cc}w)3/ Load attribute values from Plex XML response. authToken adsConsentadsConsentReminderAtadsConsentSetAt anonymousbackupCodesCreated confirmedcountryemail emailOnlyAuthexperimentalFeatures friendlyNameguest hasPasswordhome homeAdminhomeSizeidjoinedAtlocalemailingListActivemailingListStatus maxHomeSizepin protectedrememberExpiresAt restricted scrobbleTypes,thumbtitletwoFactorEnabledr1uuid subscriptionactivesubscriptionDescriptionpaymentServiceplanstatus subscribedAtNz%Y-%m-%d %H:%M:%S %ZprofileautoSelectAudiodefaultAudioLanguagedefaultSubtitleLanguageautoSelectSubtitledefaultSubtitleAccessibilitydefaultSubtitleForces);rr$attribr%r& _webhooksrPrQrRrSrOrcastboolrTrUrVrWrXrYrZr[r\r]r^intr_r` toDatetimerarbrcrdrerfrgrhrisplitrjrlrmrnr1rofindsubscriptionActiverrsubscriptionPaymentServicesubscriptionPlansubscriptionStatussubscriptionSubscribedAtprofileAutoSelectAudioprofileDefaultAudioLanguageprofileDefaultSubtitleLanguageprofileAutoSelectSubtitle#profileDefaultSubtitleAccessibilityprofileDefaultSubtitleForcesservices)r0r8xrprws r; _loadDatazMyPlexAccount._loadDatasI**4;;??;+GH ++//,7$(KKOO4J$K!#{{/@A5"'**T4;;??CW3X"YD$++//+*FG{{y1 [[__W- "ZZdkkooo.NO$)JJtT[[__E[5\$]! KKOON;ZZdkkoog&>?  ::dDKKOOM,JKJJtT[[__V%<= D$++//+*FG 3  (CD **S$++//$"78(()DE kkooh/ !&D$++//BU2V!W!%1D!E ::c4;;??=+IJ;;??5)D$++//+*FG!&!1!1$++//BU2V!W**T4;;??<+HI:>++///:Z:`:`ad:ef:eQejja0:ef[[__W- [[__W- % 4AS1T U  3 KKOOF+ yy0 "'**T<3F3F3J3J83T"U'+{{7P'Q$*6*=*=*A*ABR*S' , 3 3 7 7 ?"."5"5"9"9("C(-(8(8    # #N 3 ;t=S) %))I&&+jjw~~7I7IJ[7\&]#+2>>+=+=>T+U(.5nn.@.@AZ.[+).C9K9KL`9a)b&38::c7>>CUCUVtCu3v0,1JJsGNN|cSt d|)z Returns the :class:`~plexapi.myplex.MyPlexResource` that matches the name specified. Parameters: name (str): Name or machine identifier to match against. zUnable to find resource ) resourcesrrrr)r0rresources r;rzMyPlexAccount.resource.sX (H}}""$ 48Q8QUY8Y)1$899r<c~|jtj}|Dcgc]}t||c}Scc}w)z` Returns a list of all :class:`~plexapi.myplex.MyPlexResource` objects connected to the server. )rBMyPlexResourcerCrs r;rzMyPlexAccount.resources9s5zz.,,-7;sz T%>%> >I IIK t** *Q .*+D '::?@DIM Nt!< ND    !OsA:cJtfd|jDdS)Nc3K|]6}|jjddjk(s3|8yw)+rN)rmrr).0rrs r; z.MyPlexAccount.sonos_speaker..Ks7_ 51s9KA9N9T9T9VZ^9^Q 5s4??nextr)r0rs `r; sonos_speakerzMyPlexAccount.sonos_speakerJs _ 3 3 5_aeffr<cJtfd|jDdS)Nc3ZK|]"}|jjs|$ywN)machineIdentifier startswith)rr identifiers r;rz4MyPlexAccount.sonos_speaker_by_id..Ns(d 519L9L9W9WXb9cQ 5s ++r)r0rs `r;sonos_speaker_by_idz!MyPlexAccount.sonos_speaker_by_idMs d 3 3 5dfjkkr<c t|tr |jn|} t|tr |jn|} |j | |} | | | d|rdnd|rdnd|rdnd|j |xsi|j |xsi|j | xsidd} ddi}|jj| }|j||jj| | S)  Share library content with the specified user. Parameters: user (:class:`~plexapi.myplex.MyPlexUser`): `MyPlexUser` object, username, or email of the user to be added. server (:class:`~plexapi.server.PlexServer`): `PlexServer` object, or machineIdentifier containing the library sections to share. sections (List<:class:`~plexapi.library.LibrarySection`>): List of `LibrarySection` objects, or names to be shared (default None). `sections` must be defined in order to update shared libraries. allowSync (Bool): Set True to allow user to sync content. allowCameraUpload (Bool): Set True to allow user to upload photos. allowChannels (Bool): Set True to allow user to utilize installed channels. filterMovies (Dict): Dict containing key 'contentRating' and/or 'label' each set to a list of values to be filtered. ex: `{'contentRating':['G'], 'label':['foo']}` filterTelevision (Dict): Dict containing key 'contentRating' and/or 'label' each set to a list of values to be filtered. ex: `{'contentRating':['G'], 'label':['foo']}` filterMusic (Dict): Dict containing key 'label' set to a list of values to be filtered. ex: `{'label':['foo']}` library_section_ids invited_email10 allowSyncallowCameraUpload allowChannels filterMoviesfilterTelevision filterMusic server_id shared_serversharing_settingsrr machineIdrr) isinstance MyPlexUserr1rr_getSectionIds_filterDictToStr FRIENDINVITEformatrBr)rE)r0userserversectionsrrrrrrr1r  sectionIdsparamsrrs r; inviteFriendzMyPlexAccount.inviteFriendPs*%/tZ$@4==d0:6:0NF,,TZ ((H= "5?RZ[%.cC->cC)6#C $ 5 5l6Hb I$($9$9:J:Pb$Q#44[5FBG !  "#56&&&;zz#t}}11zPPr<c t|tr |jn|} |j||} ddi} |jj |} |j | |jj| }i}|jdD] }|jjd|d<"tj|| | |dd|rdnd |rdnd |rdnd |j|xsi|j|xsi|j| xsid d }|jj | } |j | |jj|| }||fS)rrr)rmr.r`r invited_idrrrrr r )rrrrHOMEUSERCREATErrBr)rEfindallr~r%rrrr)r0rrrrrrrrrr rrr user_creationuserIdsrrlibrary_assignments r;createHomeUserzMyPlexAccount.createHomeUserxsa*1;6:0NF,,TZ ((: !#56!!((t(4 3 (:(:G L !))#.D KKOOD1GDM/ '"5?wW[}]%.cC->cC)6#C $ 5 5l6Hb I$($9$9:J:Pb$Q#44[5FBG !  &&&;!ZZT]]-?-?fV]Z^000r<c ddi} t|tr|j} n[||jD cgc]} | jc} vr|j |j} n|} |j j | }|j||jj| }t|tr |jn|}|j||}||| d|rdnd|rdnd|rdnd|j|xsi|j|xsi|j| xsidd }|jj | }|j||jj|| }||fS|j j | }|j||jj| Scc} w) rrr)r1rrrrrrr r )rrr1usersr EXISTINGUSERrrBr)rErrrrr)r0rrrrrrrrrrr1_usernewUserrr!r rrr#s r;createExistingUserz MyPlexAccount.createExistingUsers*"#56 dJ '}}H $**,?,enn,? ?yy//HG##**G*,>JPM4>vz4R00X^I,,VX>J&9CV]!^)2#1B#-:c$($9$9,:L"$M(,(=(=>N>TRT(U#'#8#89J#K % F##**Y*?C!%C1C1C&Za!b  "44 4&&&9zz#t}}117zCC5@sGct|tr|n|j|}|jj |j }|j ||jjS)z Remove the specified user from your friends. Parameters: user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`, username, or email of the user to be removed. userId) rrr FRIENDUPDATErr`rBr)rJr0rrs r; removeFriendzMyPlexAccount.removeFriendsT"$ 3t4&&dgg&6zz#t}}3344r<ct|tr|n|j|}|jj |j }|j ||jjS)z Remove the specified user from your home users. Parameters: user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`, username, or email of the user to be removed. r,) rrrHOMEUSERrr`rBr)rJr/s r;removeHomeUserzMyPlexAccount.removeHomeUsersR"$ 3t4mm""$''"2zz#t}}3344r<cFt|tr|n|j|}|jd|jd}i}|r||d<|j ||j j|}|jjd}t||j S)a Returns a new :class:`~plexapi.myplex.MyPlexAccount` object switched to the given home user. Parameters: user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`, username, or email of the home user to switch to. pin (str): PIN for the home user (required if the home user has a PIN set). Example: .. code-block:: python from plexapi.myplex import MyPlexAccount # Login to a Plex Home account account = MyPlexAccount('', '') # Switch to a different Plex Home user userAccount = account.switchHomeUser('Username') /z/switchrfrr)r3r4) rrr HOMEUSERSr`rBr)rEr~r%r")r0rrfrrr8 userTokens r;switchHomeUserzMyPlexAccount.switchHomeUsers&"$ 3t4 $'''2 F5Mzz#t}}11&zAKKOO$9: 9dmmDDr<c|jj|j}d|i}|r||d<|j||jj |S)z Set a new Plex Home PIN for the account. Parameters: newPin (str): New PIN to set for the account. currentPin (str): Current PIN for the account (required to change the PIN). r,rf currentPinr6)r2rr`rBr)put)r0newPinr;rrs r;setPinzMyPlexAccount.setPinsTmm""$''"2 #-F< zz#t}}00z@@r<c&|jd|S)z Remove the Plex Home PIN for the account. Parameters: currentPin (str): Current PIN for the account (required to remove the PIN). r)r>)r0r;s r; removePinzMyPlexAccount.removePins {{2z**r<ct|tr|n|j|}|jj |j }d|i}|j ||jj|S)ap Set a new Plex Home PIN for a managed home user. This must be done from the Plex Home admin account. Parameters: user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser` or username of the managed home user. newPin (str): New PIN to set for the managed home user. r,rfr6 rrrMANAGEDHOMEUSERrr`rBr)rE)r0rr=rrs r;setManagedUserPinzMyPlexAccount.setManagedUserPin%sa"$ 3t4"")))9zz#t}}11&zAAr<ct|tr|n|j|}|jj |j }ddi}|j ||jj|S)a) Remove the Plex Home PIN for a managed home user. This must be done from the Plex Home admin account. Parameters: user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser` or username of the managed home user. r,r@r6rB)r0rrrs r;removeManagedUserPinz"MyPlexAccount.removeManagedUserPin2sb"$ 3t4"")))9q!zz#t}}11&zAAr<ct|tr|n|j|d}t|jt|j t|j d}tjd|jztj|z}|j||jjS)a  Accept a pending friend invite from the specified user. Parameters: user (:class:`~plexapi.myplex.MyPlexInvite` or str): :class:`~plexapi.myplex.MyPlexInvite`, username, or email of the friend invite to accept. F) includeSentfriendr]rr5)r MyPlexInvite pendingInviterrKr]rREQUESTSr`rjoinArgsrBr)r<r0rinviterrs r; acceptInvitezMyPlexAccount.acceptInvite>s$D,7T=O=OPTbg=O=h&--( $&--(  ##&))o5v8NNzz#t}}0011r<ct|tr|n|j|d}t|jt|j t|j d}tjd|jztj|z}|j||jjS)a  Cancel a pending firend invite for the specified user. Parameters: user (:class:`~plexapi.myplex.MyPlexInvite` or str): :class:`~plexapi.myplex.MyPlexInvite`, username, or email of the friend invite to cancel. F)includeReceivedrJr5)rrLrMrrKr]r REQUESTEDr`rrOrBr)rJrPs r; cancelInvitezMyPlexAccount.cancelInviteNs$D,7T=O=OPTfk=O=l&--( $&--(  $$699+69OOzz#t}}3344r<c d} d} t|tr|n|j|}t|tr |jn|} |j | |}ddi}|j Dcgc]}|j| k(s|}}|r6|r4|dj}| d|id}|jj| |}n.| ||jdd}|jj| }|r|r|d ur*|j||jj|| } n}d |jd dvr*|j||jj|| } n?|j||jj || } nt#j$d|j&j|j}i}t|t(r |rdnd|d<t|t(r |rdnd|d<t|t(r |rdnd|d<t|t*r|j-|xsi|d<t| t*r|j-| xsi|d<t|t*r|j-| xsi|d<|r>|t/j0|z }|j||jj } | | fScc}w)a Update the specified user's share settings. Parameters: user (:class:`~plexapi.myplex.MyPlexUser`): `MyPlexUser` object, username, or email of the user to be updated. server (:class:`~plexapi.server.PlexServer`): `PlexServer` object, or machineIdentifier containing the library sections to share. sections (List<:class:`~plexapi.library.LibrarySection`>): List of `LibrarySection` objects, or names to be shared (default None). `sections` must be defined in order to update shared libraries. removeSections (Bool): Set True to remove all shares. Supersedes sections. allowSync (Bool): Set True to allow user to sync content. allowCameraUpload (Bool): Set True to allow user to upload photos. allowChannels (Bool): Set True to allow user to utilize installed channels. filterMovies (Dict): Dict containing key 'contentRating' and/or 'label' each set to a list of values to be filtered. ex: `{'contentRating':['G'], 'label':['foo']}` filterTelevision (Dict): Dict containing key 'contentRating' and/or 'label' each set to a list of values to be filtered. ex: `{'contentRating':['G'], 'label':['foo']}` filterMusic (Dict): Dict containing key 'label' set to a list of values to be filtered. ex: `{'label':['foo']}` rrrrr)rr r serverIdrr Tr rr zLSection name, number of section object is required changing library sectionsr,rrrrrrrr)rrrrrrserversr` FRIENDSERVERSrrrBr)rJr%rEr<rwarningr.rdictrrrO)r0rrrremoveSectionsrrrrrrresponse_filtersresponse_serversr rrs user_serversrYrrs r; updateFriendzMyPlexAccount.updateFriend^s.!$ 3t40:6:0NF,,TZ ((H= !#56#'<<T " & -)-)>)>?O?USU)VF% & mT *$($9$9+:K$LF= !  5>>&) )C#zz#t}}/@/@A !111KUs *K ?K ct|}|jD]}|j|jjk(r|cS|js?|j sL|j sY|j|jj|j jt|j fvs|cStd|)z Returns the :class:`~plexapi.myplex.MyPlexUser` that matches the specified username or email. Parameters: username (str): Username, email or id of the user to return. zUnable to find user )strr&rrmr1rWr`r)r0r1rs r;rzMyPlexAccount.users x=JJLD~~4::#3#3#55 --DJJ477x~~?O]]((*DJJ,<,<,>DGG M@N !-hZ899r<cn|jtj}|j|tS)zf Returns a list of all :class:`~plexapi.myplex.MyPlexUser` objects connected to your account. cls)rBrrC findItems)r0rs r;r&zMyPlexAccount.userss)zz*..)~~d ~33r<cht|}|j||D]}|js|js|js*|j |jj |jj t|jfvs|cSt d|)a Returns the :class:`~plexapi.myplex.MyPlexInvite` that matches the specified username or email. Note: This can be a pending invite sent from your account or received to your account. Parameters: username (str): Username, email or id of the user to return. includeSent (bool): True to include sent invites. includeReceived (bool): True to include received invites. zUnable to find invite )rependingInvitesr1rWr`rr)r0r1rIrTrQs r;rMzMyPlexAccount.pendingInvitesx=))+GFFLLVYY8>>CS__**,fll.@.@.BC NSDT H /z:;;r<cg}|r9|jtj}||j|tz }|r9|jtj}||j|tz }|S)av Returns a list of all :class:`~plexapi.myplex.MyPlexInvite` objects connected to your account. Note: This includes all pending invites sent from your account and received to your account. Parameters: includeSent (bool): True to include sent invites. includeReceived (bool): True to include received invites. rg)rBrLrUrirN)r0rIrTinvitesrs r;rkzMyPlexAccount.pendingInvitessj ::l445D t~~d ~= =G ::l334D t~~d ~= =Gr<c|sgSi}t|tr |jn|}|jj |}|j ||j j}|dD]}tjt|jjd}tjt|jjd} |jjddj} |||<||| <||| <tj|g} |D]B} t| tr | j n| j} | j#|| D| S)zW Converts a list of section objects or names to sectionIds needed for library sharing. r rr`rCrmr)rrr PLEXSERVERSrrBr)r%rrrr~rrrrrCappend)r0rr allSectionIdsrrr8r_id_key_titlersection sectionKeys r;rzMyPlexAccount._getSectionIdss3 8B6:8VF44\b%%0A%Bzz#t}}001GD**S$++//$"78C::c4;;??5#9:D[[__Wb1779F!$M# "%M$ $'M& !  -  G(27N(KQXQ^Q^Q`J   mJ7 8 r<cg}|jD]<\}}|dvrtd||j|ddj|>dj|S)zC Converts friend filters to a string representation for transport. ) contentRatinglabelzcontentRating!zlabel!zUnknown filter key: =z%2C|)itemsrrpjoin)r0 filterDictvaluesrCvalss r;rzMyPlexAccount._filterDictToStrsl#))+ICPP #7u!=>> MMSE5::d#3"45 6,xxr<cJ|jdd|gz}|j|Sr)r setWebhooksr0rurlss r; addWebhookzMyPlexAccount.addWebhooks(~~a C5(%%r<ctj|j}||vrtd||j||j |S)NzWebhook does not exist: )rrrremoverrs r; deleteWebhookzMyPlexAccount.deleteWebhooksKyy( d?7u=> > C%%r<ctjd|t|rd|inddi}|j|j|j j |}|j|dd|_|jS) NzSetting webhooks: %szurls[]rr)r8rwebhookr) rinfolenrBWEBHOOKSr)rErr)r0rr8s r;rzMyPlexAccount.setWebhooks si '.#&t9$62,zz$--););$zGe)D~~r<c|j|j}|j|dd|_|jS)Nrrr)rBrrrr0r8s r;webhookszMyPlexAccount.webhookss4zz$--(e)D~~r<ci}|t||d<|t||d<d}|j||jj|S)zm Opt in or out of sharing stuff with plex. See: https://www.plex.tv/about/privacy-legal/ optOutPlaybackoptOutLibraryStatsz#https://plex.tv/api/v2/user/privacy)rAr8)rrBr)r<)r0playbacklibraryrrs r;optOutzMyPlexAccount.optOutsW  '*8}F# $  +.wj@|}tC||d|jS)a; Adds specified sync item for the client. It's always easier to use methods defined directly in the media objects, e.g. :func:`~plexapi.video.Video.sync`, :func:`~plexapi.audio.Audio.sync`. Parameters: client (:class:`~plexapi.myplex.MyPlexDevice`): a client for which you need to add SyncItem to. clientId (str): an identifier of a client for which you need to add SyncItem to. sync_item (:class:`~plexapi.sync.SyncItem`): prepared SyncItem object with all fields set. If both `client` and `clientId` provided the client would be preferred. If neither `client` nor `clientId` provided the clientId would be set to current clients's identifier. Returns: :class:`~plexapi.sync.SyncItem`: an instance of created syncItem. Raises: :exc:`~plexapi.exceptions.BadRequest`: When client with provided clientId wasn't found. :exc:`~plexapi.exceptions.BadRequest`: Provided client doesn't provides `sync-target`. z"Unable to find client by clientId= sync-targetz,Received client doesn't provides sync-targetzSyncItem[title]zSyncItem[rootTitle]zSyncItem[metadataType]zSyncItem[machineIdentifier]zSyncItem[contentType]zSyncItem[Policy][scope]zSyncItem[Policy][unwatched]zSyncItem[Policy][value]valuerzSyncItem[Location][uri]z#SyncItem[MediaSettings][audioBoost]z(SyncItem[MediaSettings][maxVideoBitrate]z%SyncItem[MediaSettings][musicBitrate]z%SyncItem[MediaSettings][photoQuality]z(SyncItem[MediaSettings][photoResolution]z%SyncItem[MediaSettings][subtitleSize]z%SyncItem[MediaSettings][videoQuality]z(SyncItem[MediaSettings][videoResolution]rrArN)r)"rrrrprovidesrm rootTitle metadataTyper contentTypepolicyscoperer unwatchedhasattrrlocation mediaSettings audioBoostmaxVideoBitrate musicBitrate photoQualityphotoResolution subtitleSize videoQualityvideoResolutionrrCrrBr)rEr)r0 sync_itemrrrrrr8s r;synczMyPlexAccount.sync4sp&h(H,,.**h6#F)  #EhZ!PQQ  /KL L y !9#6#6  %i&<&<  *9+F+F  $Y%:%:  &y'7'7'='=   *3s93C3C3M3M/N+O  &sWYM]M]_fEg9+;+;+A+Amn'o  &y'9'9  23y7N7N7Y7Y3Z  7IQST[S\]^ ^}}w''r<c|jDcgc]!}|jdk(s|js |#}}g}|D]5}|j}|j |j ||d7|Scc}w)a  Get Play History for all library sections on all servers for the owner. Parameters: maxresults (int): Only return the specified number of results (optional). mindate (datetime): Min datetime to return results from. rrF maxresultsmindate accountID)rrownedconnectextendhistory)r0rrrrZhistrconns r;rzMyPlexAccount.history{sv#nn.U.!**2HQWW1.UF>>#D KK GWX Y Z VsA9 A9A9c|jj|j}|j|}|j |t dS)zm Returns a list of user account Online Media Sources settings :class:`~plexapi.myplex.AccountOptOut` userUUIDr)rhr)OPTOUTSrrorBri AccountOptOut)r0rrs r;onlineMediaSourcesz MyPlexAccount.onlineMediaSourcessAll!!499!5zz#~~d H~EEr<c`|j|jd}|j|S)zG Returns a list of VOD Hub items :class:`~plexapi.library.Hub` /hubs)rBVODrirs r; videoOnDemandzMyPlexAccount.videoOnDemands,zzTXXJe,-~~d##r<c`|j|jd}|j|S)zI Returns a list of tidal Hub items :class:`~plexapi.library.Hub` r)rBMUSICrirs r;tidalzMyPlexAccount.tidals,zzTZZL./~~d##r<c ddd}|sd}|r||d<|rtj||d<|j||jd|tj|}|j |j ||fi|S)a  Returns a list of :class:`~plexapi.video.Movie` and :class:`~plexapi.video.Show` items in the user's watchlist. Note: The objects returned are from Plex's online metadata. To get the matching item on a Plex server, search for the media using the guid. Parameters: filter (str, optional): 'available' or 'released' to only return items that are available or released, otherwise return all items. sort (str, optional): In the format ``field:dir``. Available fields are ``watchlistedAt`` (Added At), ``titleSort`` (Title), ``originallyAvailableAt`` (Release Date), or ``rating`` (Critic Rating). ``dir`` can be ``asc`` or ``desc``. libtype (str, optional): 'movie' or 'show' to only return movies or shows, otherwise return all items. maxresults (int, optional): Only return the specified number of results. **kwargs (dict): Additional custom filters to apply to the search results. Example: .. code-block:: python # Watchlist for released movies sorted by critic rating in descending order watchlist = account.watchlist(filter='released', sort='rating:desc', libtype='movie') item = watchlist[0] # First item in the watchlist # Search for the item on a Plex server result = plex.library.search(guid=item.guid, libtype=item.type) rF)includeCollectionsincludeExternalMediaallsorttypez/library/sections/watchlist/)r)r searchTyperDISCOVERrO_toOnlineMetadata fetchItems)r0filterrlibtyperrrrCs r; watchlistzMyPlexAccount.watchlists:#$$%  F !F6N "--g6F6N f;F8ENNSYDZC[\%t%%doocjo&Q\U[\\r<cJt|j|jS)z Returns True if the item is on the user's watchlist. Parameters: item (:class:`~plexapi.video.Movie` or :class:`~plexapi.video.Show`): Item to check if it is on the user's watchlist. )r userState watchlistedAt)r0items r; onWatchlistzMyPlexAccount.onWatchlistsDNN4(6677r<c8t|ts|g}|D]}|j|rtd|jd|j j ddd}|j|jd||jj|S)a Add media items to the user's watchlist Parameters: items (List): List of :class:`~plexapi.video.Movie` or :class:`~plexapi.video.Show` objects to be added to the watchlist. Raises: :exc:`~plexapi.exceptions.BadRequest`: When trying to add invalid or existing media to the watchlist. "z" is already on the watchlistr5rFz"/actions/addToWatchlist?ratingKey=rH rlistrrrmguidrsplitrBrr)r<r0r|r ratingKeys r;addToWatchlistzMyPlexAccount.addToWatchlists%&GED% 1TZZL0M!NOO ((a04I JJ$--(J9+V_c_l_l_p_pJ q   r<c8t|ts|g}|D]}|j|std|jd|j j ddd}|j|jd||jj|S)a Remove media items from the user's watchlist Parameters: items (List): List of :class:`~plexapi.video.Movie` or :class:`~plexapi.video.Show` objects to be added to the watchlist. Raises: :exc:`~plexapi.exceptions.BadRequest`: When trying to remove invalid or non-existing media to the watchlist. rz" is not on the watchlistr5rFrz'/actions/removeFromWatchlist?ratingKey=rHrrs r;removeFromWatchlistz!MyPlexAccount.removeFromWatchlists%&GED##D) 1TZZL0I!JKK ((a04I JJ$--(OPY{[dhdqdqduduJ v   r<c|jjddd}|j|jd|d}|j |t S)z Returns a :class:`~plexapi.myplex.UserState` object for the specified item. Parameters: item (:class:`~plexapi.video.Movie` or :class:`~plexapi.video.Show`): Item to return the user state. r5rFrz/library/metadata/z /userStaterg)rrrBMETADATAfindItem UserState)r0rrr8s r;rzMyPlexAccount.userStatesR II$$S!,R0 zzT]]O+=i[ ST}}Ty}11r<cp|j|}|jrt|jdkDSdS)ar Return True if the item is played on Discover. Parameters: item (:class:`~plexapi.video.Movie`, :class:`~plexapi.video.Show`, :class:`~plexapi.video.Season` or :class:`~plexapi.video.Episode`): Object from searchDiscover(). Can be also result from Plex Movie or Plex TV Series agent. rF)r viewCountr)r0rrs r;isPlayedzMyPlexAccount.isPlayeds5NN4( 090C0CtI''!+,NNr<c|jd}|jjddd}|dd}|j|||S)ao Mark the Plex object as played on Discover. Parameters: item (:class:`~plexapi.video.Movie`, :class:`~plexapi.video.Show`, :class:`~plexapi.video.Season` or :class:`~plexapi.video.Episode`): Object from searchDiscover(). Can be also result from Plex Movie or Plex TV Series agent. z/actions/scrobbler5rFrcom.plexapp.plugins.libraryrCrr6rrrrBr0rrCrrs r; markPlayedzMyPlexAccount.markPlayedsP01II$$S!,R0 "2OP 3v & r<c|jd}|jjddd}|dd}|j|||S)aq Mark the Plex object as unplayed on Discover. Parameters: item (:class:`~plexapi.video.Movie`, :class:`~plexapi.video.Show`, :class:`~plexapi.video.Season` or :class:`~plexapi.video.Episode`): Object from searchDiscover(). Can be also result from Plex Movie or Plex TV Series agent. z/actions/unscrobbler5rFrrrr6rrs r; markUnplayedzMyPlexAccount.markUnplayed!sP23II$$S!,R0 "2OP 3v & r<cddd}|j|d}ddi}||||dd}|j|jd || }|d jd g} td | Dg} g} | D]l} | d} | d}|dk(rd}n |dk(rd}ndj d| j D}d|d|d}| j |j|n|j| S)a Search for movies and TV shows in Discover. Returns a list of :class:`~plexapi.video.Movie` and :class:`~plexapi.video.Show` objects. Parameters: query (str): Search query. limit (int, optional): Limit to the specified number of results. Default 30. libtype (str, optional): 'movie' or 'show' to only return movies or shows, otherwise return all items. providers (str, optional): 'discover' for default behavior or 'discover,PLEXAVOD' to also include the Plex ad-suported video service or 'discover,PLEXAVOD,PLEXTVOD' to also include the Plex video rental service moviestv)movieshowz movies,tvAcceptrrF)rBlimit searchTypessearchProvidersincludeMetadataz/library/search)rrMediaContainer SearchResultsc3jK|]+}|jddk(s|jdg-yw)r`external SearchResultN)r%)rras r;rz/MyPlexAccount.searchDiscover..Ls1k 1QRQVQVW[Q\`jQjQUU>26 s33MetadatarrVideor Directoryrc3jK|]+\}}|dtjt|d-yw)z="z" N)htmlescapere)rkvs r;rz/MyPlexAccount.searchDiscover..Xs2YHX1qcDKKA$7#8;HXs13) r%rBrrr}r|rp_manuallyLoadXMLr)r0rBrr providerslibtypesrrr8 searchResults searchResultresultsresultmetadatartagattrsxmls r;searchDiscoverzMyPlexAccount.searchDiscover0s)&t4,,w 4 ( "(  zzT]]O?;WU[z\-.22?BG k kmop "Fj)HF#Dw!GGYHXYYEcU!E7"%C NN4005 6#%%g..r<cfddi}|j|j|}|jdS)z Returns True or False if syncing of watch state and ratings is enabled or disabled, respectively, for the account. rrrconsent)rB VIEWSTATESYNCr%)r0rr8s r; viewStateSynczMyPlexAccount.viewStateSync^s6 /0zz$,,gz>xx ""r<c&|jdy)z< Enable syncing of watch state and ratings for the account. TN_updateViewStateSyncrKs r;enableViewStateSyncz!MyPlexAccount.enableViewStateSyncgs !!$'r<c&|jdy)z= Disable syncing of watch state and ratings for the account. FNr$rKs r;disableViewStateSyncz"MyPlexAccount.disableViewStateSyncks !!%(r<cpd|i}|j|j|jj|y)z Enable or disable syncing of watch state and ratings for the account. Parameters: consent (bool): True to enable, False to disable. r rN)rBr!r)r<)r0r rs r;r%z"MyPlexAccount._updateViewStateSyncos0 W% 4%%dmm.?.? Or<c|ddd}d|i}|j|j|jj||y)z Link a device to the account using a pin code. Parameters: pin (str): The 4 digit link pin code. z!application/x-www-form-urlencodedzPlex SSO)rX-Plex-Productr6)rr8N)rBLINKr)r<)r0rfrr8s r;linkzMyPlexAccount.linkxs?@( } 499dmm//t Lr<c t|j|j|j}t t |j dd}t|ts|g}|D]}||_ t|j}tt|j}||d<|j ddt|j |j"|j$t'||j(f|_ |S)z= Convert a list of media objects to online metadata objects. )r4includeUserStateT includeFieldsN)rrr&r)rrpoprr_serverr _details_keyr]rrBr schemenetlocpathrfragment)r0objsrrr/objrrBs r;rzMyPlexAccount._toOnlineMetadatasDMM4;; NtFJJ/A4$HIJ$%6DC CK3++,C399-.E(8E$ % IIot ,)3::szz388YW\M]_b_k_k*lmC  r<c$|jdS)z! Returns your public IP address. zhttps://plex.tv/:/ip)rBrKs r;publicIPzMyPlexAccount.publicIPszz011r<cHd|i}|jd|}t||S)z Returns a :class:`~plexapi.myplex.GeoLocation` object with geolocation information for an IP address using Plex's GeoIP database. Parameters: ip_address (str): IP address to lookup. ip_addresszhttps://plex.tv/api/v2/geoipr6)rB GeoLocation)r0r=rr8s r;geoipzMyPlexAccount.geoips. +zz8zH4&&r<)NNNNNNTNNNNN)NFFFNNNr)NFNNNNNN)TTNNNN)Ndiscover)_r __module__ __qualname____doc__rr7rr'r[ror.r2rCrDrIrrr,r!rrrrrrCr/r-rLrrrrrpropertyrrrrBrrrrrrrrrr$r*r0r3r9r>r@rDrGrRrVrcrr&rMrkrrrrrrrrrrrrrrrrrrrrrrrr"r&r(r%r-rr;r? __classcell__r:s@r;r"r"$sXGPLL0ICNKLWM;K=L8HMO 2F4G5HHG -DAM (D (C ,E2H2H 'CB !E:xSSYYKK 34 8; := !gl\a`d&QP^cbf/1bbgfj3Dj 5 5E8 A+ B B2 5 qu_cC2J:$4 <"". & & F$&9Tv ( F$ $ +]Z8**2 O  ,/\##()P M.2 'r<r"cBeZdZdZdZdZdZedZdZ dZ d d Z y) rai This object represents non-signed in users such as friends and linked accounts. NOTE: This should not be confused with the :class:`~plexapi.myplex.MyPlexAccount` which is your specific account. The raw xml for the data presented here can be found at: https://plex.tv/api/users/ Attributes: TAG (str): 'User' key (str): 'https://plex.tv/api/users/' allowCameraUpload (bool): True if this user can upload images. allowChannels (bool): True if this user has access to channels. allowSync (bool): True if this user can sync. email (str): User's email address (user@gmail.com). filterAll (str): Unknown. filterMovies (str): Unknown. filterMusic (str): Unknown. filterPhotos (str): Unknown. filterTelevision (str): Unknown. home (bool): Unknown. id (int): User's Plex account ID. protected (False): Unknown (possibly SSL enabled?). recommendationsPlaylistId (str): Unknown. restricted (str): Unknown. servers (List<:class:`~plexapi.myplex.)): Servers shared with the user. thumb (str): Link to the users avatar. title (str): Seems to be an alias for username. username (str): User's username. Userzhttps://plex.tv/api/users/c|j|jk(|_tjt |j jd|_tjt |j jd|_ tjt |j jd|_ |j jd|_ |j jd|_ |j jd|_ |j jd|_|j jd|_|j jd |_tjt |j jd |_tjt$|j jd |_tjt |j jd |_|j jd |_|j jd|_|j jd|_|j jdd|_|j jdd|_|j4D]}|j&|_y)rNrrrrW filterAllrr filterPhotosrr]r`rgrecommendationsPlaylistIdrirlrmrr1N) _initpathrCrKrrrr~r%rrrrWrNrrrOrr]rr`rgrPrirlrmr1rZrr0r8rs r;rzMyPlexUser._loadDatasnn0 !&D$++//BU2V!W"ZZdkkooo.NOD$++//+*FG[[__W- 5 KKOON;;;??=9 KKOON; $ 0B CJJtT[[__V%<= **S$++//$"78D$++//+*FG)-9T)U&++//,7[[__W- [[__Wb1   B7 llF#wwF #r<cB|j|jtSrrirMyPlexServerSharerKs r;rZzMyPlexUser.servers~~djj*;<)): Servers shared with the user. thumb (str): Link to the users avatar. username (str): User's username. Invitez$https://plex.tv/api/invites/requestsz%https://plex.tv/api/invites/requestedcptj|jjd|_|jjd|_tj t|jjd|_|jjd|_ tj t|jjd|_ tj t|jjd|_ tj t|jjd|_ |jjd|_|jjd d |_|j D]}|j|_y ) rN createdAtrWrKrZr]r`rrlr1rN)rrr~r%rcrWrrrKrZr]rr`rrlr1rZrrRs r;rzMyPlexInvite._loadDatas ))$++//+*FG[[__W- jjt{{x'@A  KKOON;JJtT[[__V%<= **S$++//$"78jjt{{x'@A [[__W-   B7 llF#wwF #r<cB|j|jtSrrTrKs r;rZzMyPlexInvite.servers(rVr<N) rrErFrGr_rNrUrrrZrr<r;rLrLs1 C5H7I '==r<rLc"eZdZdZdZdZddZy)Sectiona This refers to a shared section. The raw xml for the data presented here can be found at: https://plex.tv/api/servers/{machineId}/shared_servers Attributes: TAG (str): section id (int): The shared section ID key (int): The shared library section key shared (bool): If this section is shared with the user title (str): Title of the section type (str): movie, tvshow, artist ctjt|jj d|_tjt|jj d|_tjt|jj dd|_|jj d|_ |jj d|_ |j |_ |j |_ y)rNr`rCsharedrrmrN) rrrr~r%r`rCrrhrmr sectionIdrvrs r;rzSection._loadData<s**S$++//$"78::c4;;??5#9:jjt{{x'EF [[__W- KKOOF+ ((r<Nc|jjj|jjj}|j |||jj |j S)a  Get all Play History for a user for this section in this shared server. Parameters: maxresults (int): Only return the specified number of results (optional). mindate (datetime): Min datetime to return results from. )rrrlibrarySectionID)r2rrrrrrvr0rrrs r;rzSection.historyFsc %%..t||/@/@AIIK~~W(, (>(>QUQ`Q`b br<rA)rrErFrGr_rrrr<r;rfrf-s  C#br<rfc.eZdZdZdZdZdZdZddZy) rUat Represents a single user's server reference. Used for library sharing. Attributes: id (int): id for this share serverId (str): what id plex uses for this. machineIdentifier (str): The servers machineIdentifier name (str): The servers name lastSeenAt (datetime): Last connected to the server? numLibraries (int): Total number of libraries allLibraries (bool): True if all libraries is shared with this user. owned (bool): 1 if the server is owned by the user pending (bool): True if the invite is pending. Serverctjt|jj d|_tjt|jj d|_tjt|jj d|_|jj d|_|jj d|_ tj|jj d|_ tjt|jj d|_ tjt|jj d|_tjt|jj d |_tjt|jj d |_y ) rNr`rrYrr lastSeenAt numLibraries allLibrariesrpendingN)rrrr~r%r`rrYrrrrprqrrrrrsrs r;rzMyPlexServerShare._loadDatabs&**S$++//$"78C)EF 3  (CD !%1D!EKKOOF+ **4;;??<+HI!JJsDKKOON,KL!JJtT[[__^-LMZZdkkoog&>? zz$  (BC r<c|jD]1}|j|jjk(s/|cStd|)z Returns the :class:`~plexapi.myplex.Section` that matches the name specified. Parameters: name (str): Name of the section to return. zUnable to find section )rrrmr)r0rrus r;ruzMyPlexServerShare.sectionosI }}Gzz|w}}2244'0788r<ctjj|j|j}|j j |}|j|tdS)z_ Returns a list of all :class:`~plexapi.myplex.Section` objects shared with this user. rX SharedServerr) r"r[rrr`r2rBrirfr0rr8s r;rzMyPlexServerShare.sections{sU))004;Q;Q\`\c\c0d||!!#&~~dG.~AAr<Nc|jj|jj}|j |||j S)z Get all Play History for a user in this shared server. Parameters: maxresults (int): Only return the specified number of results (optional). mindate (datetime): Min datetime to return results from. r)r2rrrrrrls r;rzMyPlexServerShare.historysA &&tyy199;~~WPTP^P^~__r<)iN) rrErFrGr_rrurrrr<r;rUrUQs%  C D 9B`r<rUc\eZdZdZdZdZgdZddgZdZe dZ d d Z d d Z y )ra This object represents resources connected to your Plex server that can provide content such as Plex Media Servers, iPhone or Android clients, etc. The raw xml for the data presented here can be found at: https://plex.tv/api/v2/resources?includeHttps=1&includeRelay=1 Attributes: TAG (str): 'Device' key (str): 'https://plex.tv/api/v2/resources?includeHttps=1&includeRelay=1' accessToken (str): This resource's Plex access token. clientIdentifier (str): Unique ID for this resource. connections (list): List of :class:`~plexapi.myplex.ResourceConnection` objects for this resource. createdAt (datetime): Timestamp this resource first connected to your server. device (str): Best guess on the type of device this is (PS, iPhone, Linux, etc). dnsRebindingProtection (bool): True if the server had DNS rebinding protection. home (bool): Unknown httpsRequired (bool): True if the resource requires https. lastSeenAt (datetime): Timestamp this resource last connected. name (str): Descriptive name of this resource. natLoopbackSupported (bool): True if the resource supports NAT loopback. owned (bool): True if this resource is one of your own (you logged into it). ownerId (int): ID of the user that owns this resource (shared resources only). platform (str): OS the resource is running (Linux, Windows, Chrome, etc.) platformVersion (str): Version of the platform. presence (bool): True if the resource is online product (str): Plex product (Plex Media Server, Plex for iOS, Plex Web, etc.) productVersion (str): Version of the product. provides (str): List of services this resource provides (client, server, player, pubsub-player, etc.) publicAddressMatches (bool): True if the public IP address matches the client's public IP address. relay (bool): True if this resource has the Plex Relay enabled. sourceTitle (str): Username of the user that owns this resource (shared resources only). synced (bool): Unknown (possibly True if the resource has synced content?) rz>https://plex.tv/api/v2/resources?includeHttps=1&includeRelay=1)localremoterelayhttpshttpctj|jjd|_|jjd|_t j|jjdd|_|jjd|_ t jt|jjd|_ t jt|jjd|_ t jt|jjd|_t j|jjd d|_|jjd |_t jt|jjd |_t jt|jjd |_t jt&|jjd d|_|jjd|_|jjd|_t jt|jjd|_|jjd|_|jjd|_|jjd|_t jt|jjd|_t jt|jjd|_|jjd|_t jt|jjd|_y)rNrYrrcz%Y-%m-%dT%H:%M:%SZrdnsRebindingProtectionr] httpsRequiredrprnatLoopbackSupportedrownerIdrplatformplatformVersionpresenceproductproductVersionrpublicAddressMatchesr} sourceTitlesyncedN)rr$r~r%rYrrrrcrrrrr]rrprrrrrrrrrrrrr}rrrs r;rzMyPlexResource._loadDatas`$//  0NO $ 0B C))$++//+*FH\]kkooh/ &+jjt{{G_7`&a#JJtT[[__V%<= "ZZdkkooo.NO**4;;??<+HJ^_KKOOF+ $)JJtT[[__E[5\$]!ZZdkkoog&>? zz#t{{y!'DE   3 #{{/@A 4)DE {{y1 "kkoo.>?  3 $)JJtT[[__E[5\$]!ZZdkkoog&>? ;;??=9jjt{{x'@A r<cF|j|jtdS)N connectionsrw)rirResourceConnectionrKs r;rzMyPlexResource.connectionss~~djj*<=~QQr<Nc ||jdd}||jdd}|Dcic]}||Dcic]}|gc}}}}|jD]}|js|jr|jr)|j rdn|jrdnd}||vrLd|vr!||dj |jd|vsv||dj |j|dur|jdn|dur|jdg}|D] }|D]}|j|||"|Scc}wcc}}w) a" Returns a sorted list of the available connection addresses for this resource. Often times there is more than one address specified for a server or client. Default behavior will prioritize local connections before remote or relay and HTTPS before HTTP. Parameters: ssl (bool, optional): Set True to only connect to HTTPS connections. Set False to only connect to HTTP connections. Set None (default) to connect to any HTTP or HTTPS connection. Nr}r{r|rr~TF) DEFAULT_LOCATION_ORDERDEFAULT_SCHEME_ORDERrrr{r}rphttpuriurirr) r0ssl locationsschemesrr4connections_dict connectionrs r;preferred_connectionsz$MyPlexResource.preferred_connectionss[  33A6I ?//2GYbcYbXH&Hfvrz&HHYbc**Jzz$**Z5E5E&0&6&67 HXHXW^f9,W$$X.v6==j>P>PQg%$X.w7>>z~~N+ $;v. E\7>>'2 !H!""#3H#=f#EF""#'Ics E D=E=Ec||jdd}||jdd}|j|||}d|jvrtnt }|Dcgc]'}|||j |jj|g)}}tjdt|tjt|} td|j | Scc}w)a Returns a new :class:`~plexapi.server.PlexServer` or :class:`~plexapi.client.PlexClient` object. Uses `MyPlexResource.preferred_connections()` to generate the priority order of connection addresses. After trying to connect to all available addresses for this resource and assuming at least one connection was successful, the PlexServer object is built and returned. Parameters: ssl (bool, optional): Set True to only connect to HTTPS connections. Set False to only connect to HTTP connections. Set None (default) to connect to any HTTP or HTTPS connection. timeout (int, optional): The timeout in seconds to attempt each connection. Raises: :exc:`~plexapi.exceptions.NotFound`: When unable to connect to any addresses for this resource. Nrz!Testing %s resource connections..Resource)rrrrrrrYr2r)rrrrthreaded_connect_chooseConnectionr) r0rr5rrrrhrlistargsrs r;rzMyPlexResource.connects*  33A6I ?//2G00iI % 5j:\gh\gUXS#t//1F1FP\gh 5s8}E..84 TYY@@is,Cr@rB) rrErFrGr_rCrrrrrrrrr<r;rrsh!D C JC:#V,B2RR  %R  !Ar<rceZdZdZdZdZy)ra< Represents a Resource Connection object found within the :class:`~plexapi.myplex.MyPlexResource` objects. Attributes: TAG (str): 'Connection' address (str): The connection IP address httpuri (str): Full HTTP URL ipv6 (bool): True if the address is IPv6 local (bool): True if the address is local port (int): The connection port protocol (str): HTTP or HTTPS relay (bool): True if the address uses the Plex Relay uri (str): Full connetion URL rc|jjd|_tjt |jjd|_tjt |jjd|_tjt|jjd|_ |jjd|_ tjt |jjd|_ |jjd|_ d|jd |j|_ y ) rNaddressIPv6r{portprotocolr}rzhttp://:N)r~r%rrrripv6r{rrrr}rrrs r;rzResourceConnection._loadData/s{{y1 JJtT[[__V%<= ZZdkkoog&>? JJsDKKOOF$;<   3 ZZdkkoog&>? ;;??5) a {; r<NrrErFrGr_rrr<r;rrs  C ?  3 #{{/@Akkooh/ [[__W- kkooh/   3 $ 0B C{{y1 ++//$'))$++//'*BC $ 0B C![[___=))$++//+*FG**4;;??<+HIr<c>|j|jddS)Nr ConnectionrrrKs r;rzMyPlexDevice.connectionsos~~djj%l~CCr<NcXd|jvrtnt}|jDcgc]'}|||j|j j |g)}}tjdt|tjt|}td|j|Scc}w)a Returns a new :class:`~plexapi.client.PlexClient` or :class:`~plexapi.server.PlexServer` Sometimes there is more than one address specified for a server or client. After trying to connect to all available addresses for this client and assuming at least one connection was successful, the PlexClient object is built and returned. Raises: :exc:`~plexapi.exceptions.NotFound`: When unable to connect to any addresses for this device. rzTesting %s device connections..r)rrrrr3r2r)rrrrrrrr)r0r5rhrrrs r;rzMyPlexDevice.connectss% 5j:VZVfVfgVfsS#tzz4<<+@+@'JVfg 3S]C..84 499g>>hs,B'cd|jd}|jj||jjjy)z' Remove this device from your account. zhttps://plex.tv/devices/z.xmlN)r`r2rBr)rJ)r0rCs r;rJzMyPlexDevice.deletes8( 6 3 5 5 < <=r<cld|jvr td|jj|S)z Returns an instance of :class:`~plexapi.sync.SyncList` for current device. Raises: :exc:`~plexapi.exceptions.BadRequest`: when the device doesn't provides `sync-target`. rz?Requested syncList for device which do not provides sync-target)r)rrr2rrKs r;rzMyPlexDevice.syncItemss4  -^_ _||%%T%22r<r) rrErFrGr_rCrrrrrJrrr<r;rr;s>6 C 'CJ*DD ?> 3r<rc~eZdZdZdZdZdfd ZedZddZ ddZ dZ d Z d Z d Zd Zd ZdZddZxZS)MyPlexPinLogina MyPlex PIN login class which supports getting a token for authenticating the client and providing an access token to create a :class:`~plexapi.myplex.MyPlexAccount` instance. The login can be done using the four character PIN which the user must enter at https://plex.tv/link or using Plex OAuth. This helper class supports a polling, threaded and callback approach. - The polling approach expects the developer to periodically check if the PIN login was successful using :func:`~plexapi.myplex.MyPlexPinLogin.checkLogin`. - The threaded approach expects the developer to call :func:`~plexapi.myplex.MyPlexPinLogin.run` and then at a later time call :func:`~plexapi.myplex.MyPlexPinLogin.waitForLogin` to wait for and check the result. - The callback approach is an extension of the threaded approach and expects the developer to pass the ``callback`` parameter to the call to :func:`~plexapi.myplex.MyPlexPinLogin.run`. The callback will be called when the thread waiting for the PIN login to succeed either finishes or expires. The parameter passed to the callback is the received authentication token or ``None`` if the login expired. Parameters: session (requests.Session, optional): Use your own session object if you want to cache the http responses from Plex. requestTimeout (int, optional): Timeout in seconds on initial connect to plex.tv (default config.TIMEOUT). headers (dict, optional): A dict of X-Plex headers to send with requests. oauth (bool, optional): True to use Plex OAuth instead of PIN login. Attributes: PINS (str): 'https://plex.tv/api/v2/pins' POLLINTERVAL (int): 1 pin (str): Four character PIN to use for the login at https://plex.tv/link. finished (bool): Whether the pin login has finished or not. expired (bool): Whether the pin login has expired or not. token (str): Token retrieved after login. Example: .. code-block:: python from plexapi.myplex import MyPlexAccount, MyPlexPinLogin pinlogin = MyPlexPinLogin(oauth=True) pinlogin.run() print(f'Login to Plex at the following url:\n{pinlogin.oauthUrl()}') pinlogin.waitForLogin() token = pinlogin.token account = MyPlexAccount(token=token) zhttps://plex.tv/api/v2/pinsrFctt| |xstj|_|xst |_||_||_ d|_ d|_ d|_ d|_ d|_d|_d|_d|_d|_y)NF)r.rr/r'r(r)r_requestTimeout_customHeaders_oauth _loginTimeout _callback_thread_abortrr_codefinishedexpiredr3)r0r4requestTimeoutroauthr:s r;r/zMyPlexPinLogin.__init__s nd,.58#3#3#5 -8% !      r<cP|jr td|jSzf Return the four character PIN used for linking a device at https://plex.tv/link. z#Cannot use PIN for Plex OAuth login)rr_getCoderKs r;rfzMyPlexPinLogin.pins# ;;BC C}}r<c |js td|j}|d|d|d|d|d|d|d|jd }|r||d <d t |S) Return the Plex OAuth url for login. Parameters: forwardUrl (str, optional): The url to redirect the client to after login. z;Must use "MyPlexPinLogin(oauth=True)" for Plex OAuth login.X-Plex-Client-Identifierr+X-Plex-VersionX-Plex-PlatformX-Plex-Platform-Version X-Plex-DeviceX-Plex-Device-NameclientIDzcontext[device][product]zcontext[device][version]zcontext[device][platform]z context[device][platformVersion]zcontext[device][device]zcontext[device][deviceName]r6 forwardUrlhttps://app.plex.tv/auth/#!?)rrrrrr0rrrs r;oauthUrlzMyPlexPinLogin.oauthUrls {{Z[ [--/ :;(/0@(A(/0@(A)01B)C078Q0R'.'?+23G+HMMO   #-F< -i.?-@AAr<cP|jr|js td|jr td|j ||_||_d|_d|_tj|jd|_|jjy) Starts the thread which monitors the PIN login state. Parameters: callback (Callable[str], optional): Callback called with the received authentication token. timeout (int, optional): Timeout in seconds to wait for user login. Default 120 seconds. Raises: :exc:`RuntimeError`: If the thread is already running. :exc:`RuntimeError`: If the PIN login for the current PIN has expired. z(MyPlexPinLogin thread is already runningzMyPlexPinLogin has expiredFzplexapi.myplex.MyPlexPinLogintargetrN) rr RuntimeErrorrrrrr threadingThread _pollLoginstartr0callbackr5s r;runzMyPlexPinLogin.runs << IJ J <<;< < $!   ''tEde  r<c|jr |jry|jj|js |jsyy)z Waits for the PIN login to succeed or expire. Returns: bool: ``True`` if the PIN login succeeded or ``False`` otherwise. FT)rrr}rr3rKs r; waitForLoginzMyPlexPinLogin.waitForLogins7 ||t{{  <#:D$D3D>DDDD Dc tj}|jr|j|j|j||S)zF Returns dict containing base headers for all requests for pin login. r rrrrs r;rzMyPlexPinLogin._headersus<##%    NN4.. /vr<c |xs|jj}tjd|jj ||xs|j }||f||jd|}|jsitj|jd}|jjdd}td|jd|d|jd|tj |jS) N%s %srrrrrrr)r)r%rrrrrrokrrrrrrrrr0rrArrrrrs r;rzMyPlexPinLogin._query}s,4==,, '6??002C8,T]]_#Ww8L8LWPVW{{yy!5!56q9Hmm++D#6Gq!5!5 6b !HLL>QST[S\]^ ^##HMM22r<)NNNFrNxrA)rrErFrGrrr/rHrfrrrrrrrrrrrIrJs@r;rrsa0b )DL$B22  ((!( 3r<rc eZdZdZdZdZdZgdZ d"fd Zd#dZ e d Z e d Z e d Z e d Zd Zd$dZe dZdZdZdZdZdZdZd%dZe dZd&dZd'dZdZdZdZdZdZ dZ!d Z"dd!Z#xZ$S)(MyPlexJWTLogina MyPlex JWT login class which supports getting a JWT for authenticating the client and providing an access token to create a :class:`~plexapi.myplex.MyPlexAccount` instance. The login can be done using the four character PIN which the user must enter at https://plex.tv/link or using Plex OAuth. This class can also be used to refresh or verify an existing JWT. See: https://developer.plex.tv/pms/#section/API-Info/Authenticating-with-Plex Using this class requires the ``PyJWT`` with ``cryptography`` packages to be installed (``pyjwt[crypto]``). This helper class supports a polling, threaded and callback approach. - The polling approach expects the developer to periodically check if the PIN login was successful using :func:`~plexapi.myplex.MyPlexJWTLogin.checkLogin`. - The threaded approach expects the developer to call :func:`~plexapi.myplex.MyPlexJWTLogin.run` and then at a later time call :func:`~plexapi.myplex.MyPlexJWTLogin.waitForLogin` to wait for and check the result. - The callback approach is an extension of the threaded approach and expects the developer to pass the ``callback`` parameter to the call to :func:`~plexapi.myplex.MyPlexJWTLogin.run`. The callback will be called when the thread waiting for the PIN login to succeed either finishes or expires. The parameter passed to the callback is the received authentication token or ``None`` if the login expired. Parameters: session (requests.Session, optional): Use your own session object if you want to cache the http responses from Plex. requestTimeout (int, optional): Timeout in seconds on initial connect to plex.tv (default config.TIMEOUT). headers (dict, optional): A dict of X-Plex headers to send with requests. oauth (bool, optional): True to use Plex OAuth instead of PIN login. token (str, optional): Plex token only required to register the device initially if not using OAuth. jwtToken (str, optional): Existing Plex JWT to verify or refresh. keypair (tuple[str|bytes], optional): A tuple of the full file paths (str) to the ED25519 private and public key pair or the raw keys themselves (bytes) to use for signing the JWT. Use :func:`~plexapi.myplex.MyPlexJWTLogin.generateKeypair` to generate a new keypair if not provided. scope (list[str], optional): List of scopes to request in the new token. Default is all available scopes. Attributes: PINS (str): 'https://plex.tv/api/v2/pins' AUTH (str): 'https://clients.plex.tv/api/v2/auth' POLLINTERVAL (int): 1 SCOPES (list): List of all available scopes to request for the JWT. pin (str): Four character PIN to use for the login at https://plex.tv/link. finished (bool): Whether the JWT login has finished or not. expired (bool): Whether the JWT login has expired or not. jwtToken (str): The Plex JWT received after login or refreshing. decodedJWT (dict): The decoded Plex JWT payload. Example: .. code-block:: python from plexapi.myplex import MyPlexAccount, MyPlexJWTLogin # Method 1: Generate a new Plex JWT using Plex OAuth jwtlogin = MyPlexJWTLogin( oauth=True, scopes=['username', 'email', 'friendly_name'] ) jwtlogin.generateKeypair(keyfiles=('private.key', 'public.key')) jwtlogin.run() print(f'Login to Plex at the following url:\n{jwtlogin.oauthUrl()}') jwtlogin.waitForLogin() jwtToken = jwtlogin.jwtToken account = MyPlexAccount(token=jwtToken) # Method 2: Generate a new Plex JWT using an existing Plex token and keypair jwtlogin = MyPlexJWTLogin( token='2ffLuB84dqLswk9skLos', keypair=('private.key', 'public.key'), scopes=['username', 'email', 'friendly_name'] ) jwtlogin.registerDevice() jwtToken = jwtlogin.refreshJWT() account = MyPlexAccount(token=jwtToken) # Refresh an existing Plex JWT jwtlogin = MyPlexJWTLogin( jwtToken=jwtToken, keypair=('private.key', 'public.key'), scopes=['username', 'email', 'friendly_name'] ) if not jwtlogin.verifyJWT(): jwtToken = jwtlogin.refreshJWT() account = MyPlexAccount(token=jwtToken) z#https://clients.plex.tv/api/v2/pinsz#https://clients.plex.tv/api/v2/authrF)r1rW friendly_namerirSrarAc *tt| |xstj|_|xst |_||_||_ |drtj|dnd|_ |drtj|dnd|_ |xs |j|_d|_||_d|_d|_d|_d|_d|_d|_d|_d|_||_t6st9j:dyy)NrrFFz9PyJWT package is not installed, cannot use Plex JWT login)r.rr/r'r(r)rrrr&r openOrRead _privateKey _publicKeySCOPES_scopes _clientJWTrrrrrrrrrrjwtTokenjwtrr\) r0r4rrrr3r keypairscopesr:s r;r/zMyPlexJWTLogin.__init__s nd,.58#3#3#5 -8% ;B1:5++GAJ74:A!*%**71:6$,  !        KKS T r<cptstjdytjj }|j }|jtjjtjjtj}|jtjjtjj}|dr|dr|sOtj j#|ds"tj j#|dr t%dt'|dd5}t'|dd5}|j)||j)|dddddd||_||_y#1swY xYw#1swY$xYw) a Generates a new ED25519 private/public keypair for signing the JWT and saves them to files. Requires the ``cryptography`` package to be installed. Parameters: keyfiles (tuple[str]): A tuple of the full file paths to write the private and public keypair to. overwrite (bool): Set to True to overwrite existing keypair files. Default is False. Raises: :exc:`FileExistsError`: when keypair files already exist and overwrite is False. zFCryptography package is not installed, cannot generate ED25519 keypairN)encodingrencryption_algorithm)rrrrFzBKeypair files already exist, set overwrite=True to overwrite them.wb) cryptographyrr\r Ed25519PrivateKeygenerate public_key private_bytesr EncodingRaw PrivateFormat NoEncryption public_bytes PublicFormatosr6existsFileExistsErroropenwriterr ) r0keyfiles overwrite privateKey publicKeyrr  privateFile publicFiles r;generateKeypairzMyPlexJWTLogin.generateKeypairs[ KK` a ..779 ))+  .."++// ..22!.!;!;!=/ ++"++// --11, A;8A;"''..!"=PXYZP[A\%&jkkhqk4(Khqk49PT^!!+.  ,:Q('$ :Q9P((s$F,#F F, F) %F,,F5c,|j}|dS)z1 Returns the client identifier from the headers. r)r)r0rs r;_clientIdentifierz MyPlexJWTLogin._clientIdentifier-s--/122r<c|jr |jsytj|j|jzj S)z: Returns the key ID (thumbprint) for the ED25519 keypair. N)rr hashlibsha256 hexdigestrKs r;_keyIDzMyPlexJWTLogin._keyID3s=t~~d..@AKKMMr<c tjjddtj|j tj|j dd|jdS)z@ Returns the private JWK (JSON Web Key) for the ED25519 keypair.OKPEd25519sigEdDSA)ktycrvrdusealgkid)rPyJWK from_dictrbase64urlEncoder rr2rKs r; _privateJWKzMyPlexJWTLogin._privateJWK:sYyy""&&t7&&t'7'78;;$   r<c tjjddtj|j dd|j dS)z? Returns the public JWK (JSON Web Key) for the ED25519 keypair.r4r5r6r7)r8r9rr;r<r=)rr>r?rr@r r2rKs r; _publicJWKzMyPlexJWTLogin._publicJWKGsEyy""&&t7;; $   r<c |jdj|jd|jt t j tjjt t j tjtdzjd}d|ji}tj||jd|S) z7 Returns the encoded client JWT using the private JWK. rkplex.tvr)minutes)nonceraudissiatexpr=r7)rC algorithmr) _getPlexNoncer}r r-rrnowrutc timestamprr2rencoderA)r0rFrs r;_encodeClientJWTzMyPlexJWTLogin._encodeClientJWTSs'')XXdll+))x||HLL1;;=> X\\2Yq5IITTVW   4;; zz      r<c|jdgd|id|jgdd}|stjd i|Sgd|dd<t |j D]8} tjd dtj j|i|cStjd tj#tj$rYutj$r%}tjd t|d }~wwxYw) aS Returns the decoded Plex JWT with optional signature verification using the Plex public JWK. Parameters: verify_signature (bool): Whether to verify the JWT signature and required claims. Defaults to True. Set to False to skip signature verification and required-claim enforcement. r7verify_signaturerE)r algorithmsoptionsaudienceissuer)rHrIrKrJ thumbprintrVrequirerCzInvalid Plex JWT: %sNzAPlex JWT signature could not be verified with any known Plex JWKsr) r r-rdecodereversed_getPlexPublicJWKr>r?InvalidSignatureErrorInvalidTokenErrorrr\re)r0rTrplexJWKes r; decodePlexJWTzMyPlexJWTLogin.decodePlexJWTgs==")*,<="D$:$:;   ::'' ''Qy)$ 6 6 89G zz ++G4: WX''',, ((  2CF; s 3B<<DD# DDc"|jS)zZ Returns the decoded Plex JWT with signature verification and required-claim enforcement. )rbrKs r; decodedJWTzMyPlexJWTLogin.decodedJWTs!!##r<c|jd}|jdid|ji}d|jji}|j ||j j||y)z% Registers the public JWK with Plex. z/jwkrjwk)rArrNr)AUTHrr&rC _jwk_datarr)rE)r0rrbodys r;_registerPlexDevicez"MyPlexJWTLogin._registerPlexDevices` 4 $--@>4;;"?@t001 C 2 2G$ Or<cx|jd}|j||jj}|dS)z Gets a nonce from Plex. z/noncerHrGrgrr)r%rxs r;rMzMyPlexJWTLogin._getPlexNonces8 6"{{3t}}'8'8{9G}r<c|jd}d|ji}|j||jj|}|dS)z* Exchanges the client JWT for a Plex JWT. z/tokenr)rAr auth_token)rgr rr)rE)r0rrir8s r;_exchangePlexJWTzMyPlexJWTLogin._exchangePlexJWTsI 6"t'{{3t}}'9'9{EL!!r<cx|jd}|j||jj}|dS)z Gets the Plex public JWKs. z/keysrHkeysrlrxs r;r]z MyPlexJWTLogin._getPlexPublicJWKs8 5!{{3t}}'8'8{9F|r<c|js td|jr |js td|j y)a* Registers the device with Plex using the provided token and private/public keypair. This must be done once if OAuth was not used before the Plex JWT can be refreshed. Raises: :exc:`~plexapi.exceptions.BadRequest`: when token or keypair is missing. z*Plex token is required to register device.zqED25519 private and public keys are required to register device. Use generateKeypair() to generate a new keypair.N)r&rrr rjrKs r;registerDevicezMyPlexJWTLogin.registerDevicesI{{IJ JtPQ Q   "r<c|jr |js td|j|_|j |_|jr |j Std)aT Refreshes the Plex JWT using the existing private/public keypair. Returns: str: The new Plex JWT. Raises: :exc:`~plexapi.exceptions.BadRequest`: when keypair is missing. :exc:`~plexapi.exceptions.BadRequest`: when the newly obtained JWT cannot be verified. z> == ?@@r<cn |j}|d|jk7rtjdy|dt t j tjt|zjkrtjd|dyy#tj$rYywxYw) a$ Verifies the existing Plex JWT is valid and not expiring within the specified number of days. Parameters: refreshWithinDays (int): Number of days before expiration to consider the JWT invalid and in need of refresh. Default is 1 day. rYz,Existing JWT was signed with a different keyFrK)daysz Existing JWT is expiring within z day(s)T) rdr2rr\rrrNrrOrrPrr_)r0refreshWithinDaysrds r;ruzMyPlexJWTLogin.verifyJWTs J,'4;;6 JKE"S(,,x||*DyVgGh*h)s)s)u%vv >?P>QQXYZ$$  s BB43B4cH|jr td|jSr)rrrrKs r;rfzMyPlexJWTLogin.pins! ;;BC Czzr<c |js td|j}|d|d|d|d|d|d|d|jd }|r||d <d t |S) rz;Must use "MyPlexJWTLogin(oauth=True)" for Plex OAuth login.rr+rrrrrrrr)rrrrrrs r;rzMyPlexJWTLogin.oauthUrls {{Z[ [--/ :;(/0@(A(/0@(A)01B)C078Q0R'.'?+23G+HJJ   #-F< -i.?-@AAr<cz|jr|js td|jr td|j |j |_||_||_d|_d|_ tj|jd|_|jjy)rz(MyPlexJWTLogin thread is already runningzMyPlexJWTLogin has expiredFzplexapi.myplex.MyPlexJWTLoginrN)rrrrrrRr rrrrrrrrs r;rzMyPlexJWTLogin.run s << IJ J <<;< < //1$!   ''tEde  r<c|jr |jry|jj|js |jsyy)z Waits for the user login to succeed or expire. Returns: bool: ``True`` if the user login succeeded or ``False`` otherwise. FT)rrr}rr rKs r;rzMyPlexJWTLogin.waitForLogin s7 ||t{{  <QST[S\]^ ^ !1!1!5!5nb!I IcRZRbRbNc==? "##HMM22r<)NNNFNNrAN)rAF)T)rFrr)%rrErFrGrrgrr r/r+rHr-r2rArCrRrbrdrjrMror]rsrvrurfrrrrrrrrrrrIrJs@r;rrs[x 1D 0DL ZFNSIM8$%L33 NN          (!(F$$P " # A&(B24  ,*!( 3r<rcxtj} |||||} ttj|z } ||| | f||<tr|r|jyyy#t$rJ} ttj|z } t j d|| ||d| f||<Yd} ~ yd} ~ wwxYw)a Connects to the specified cls with url and token. Stores the connection information to results[i] in a threadsafe way. Arguments: cls: the class which is responsible for establishing connection, basically it's :class:`~plexapi.client.PlexClient` or :class:`~plexapi.server.PlexServer` url (str): url which should be passed as `baseurl` argument to cls.__init__() session (requests.Session): session which sould be passed as `session` argument to cls.__init() token (str): authentication token which should be passed as `baseurl` argument to cls.__init__() timeout (int): timeout which should be passed as `baseurl` argument to cls.__init__() results (list): pre-filled list for results i (int): index of current job, should be less than len(results) job_is_done_event (:class:`~threading.Event`): is X_PLEX_ENABLE_FAST_CONNECT is True then the event would be set as soon the connection is established )baseurlr3r4r5z%s: %sN)rrrsetrZrerror) rhrr3r4r5rijob_is_done_event starttimerruntimeerrs r;rr s  I 1SwPdiikI-.5&'2 %*;  ! ! #+< % 1diikI-. (C%5$0 1sA A&& B9/AB44B9c J|D]'\}}}}|rdnd}tjd|||||)|Dcgc]}|s|d |d}}|r7tjd||dj|dj|dSt d|j d|cc}w) zF Chooses the first (best) connection from the given _connect results. OKERRz*%s connection %s (%ss): %s?X-Plex-Token=%sz$Connecting to %s: %s?X-Plex-Token=%srzUnable to connect to z: )rr_baseurlr&rr) ctyperrrr3rrokerrrs r;rr s(/#UFGE >ugWZ\ab(/%?Wad.>qtWG? 8%ATATV]^_V`VgVghqz *5;;=/D6B CC @sB B B c:eZdZdZdZhdZdZdZdZdZ dZ y ) ra Represents a single AccountOptOut 'https://plex.tv/api/v2/user/{userUUID}/settings/opt_outs' Attributes: TAG (str): optOut key (str): Online Media Source key value (str): Online Media Source opt_in, opt_out, or opt_out_managed r>opt_inopt_outopt_out_managedc|jjd|_|jjd|_y)rNrCrN)r~r%rCrrs r;rzAccountOptOut._loadData s*;;??5)[[__W- r<cl||jvrt|d|j|jjj |jj }|j |d}|jj||jjj|||_ y)z Sets the Online Media Sources option. Parameters: option (str): see CHOICES Raises: :exc:`~plexapi.exceptions.NotFound`: ``option`` str not found in CHOICES. z! not found in available choices: r)rCrrN) CHOICESrr2rrrorCrBr)rEr)r0optionrrs r; _updateOptOutzAccountOptOut._updateOptOut s  %fX%Ft||nUV Vll""))4<<3D3D)EF3 3t||'<'<'A'A&Q r<c&|jdy)z, Sets the Online Media Source to "Enabled". rNrrKs r;optInzAccountOptOut.optIn s 8$r<c&|jdy)z- Sets the Online Media Source to "Disabled". rNrrKs r;rzAccountOptOut.optOut s 9%r<ct|jdk(rt|jd|jdy)z Sets the Online Media Source to "Disabled for Managed Users". Raises: :exc:`~plexapi.exceptions.BadRequest`: When trying to opt out music. ztv.plex.provider.musicz3 does not have the option to opt out managed users.rN)rCrrrKs r; optOutManagedzAccountOptOut.optOutManaged s7 88/ /z)\]^ ^ ,-r<N) rrErFrGr_rrrrrrrr<r;rr s, C6G.  %&.r<rc eZdZdZdZdZdZy)ra Represents a single UserState Attributes: TAG (str): UserState lastViewedAt (datetime): Datetime the item was last played. ratingKey (str): Unique key identifying the item. type (str): The media type of the item. viewCount (int): Count of times the item was played. viewedLeafCount (int): Number of items marked as played in the show/season. viewOffset (int): Time offset in milliseconds from the start of the content viewState (bool): True or False if the item has been played. watchlistedAt (datetime): Datetime the item was added to the watchlist. cPd|jjd|jdS)Nrr>)r:rrrKs r;__repr__zUserState.__repr__ s'4>>**+1T^^,>r<ctj|jjd|_|jjd|_|jjd|_tjt|jjdd|_ tjt|jjdd|_ tjt|jjdd|_ |jjdd k(|_ tj|jjd |_ y ) rN lastViewedAtrrrrviewedLeafCount viewOffset viewStatecompleterN)rrr~r%rrrrrrrrrrrs r;rzUserState._loadData s!,,T[[__^-LM5KKOOF+ Ca)HI$zz#t{{?PRS/TU**S$++//,*JK5C"--dkkooo.NOr<N)rrErFrGr_rrrr<r;rr s  C? Pr<rceZdZdZdZdZy)r>az Represents a signle IP address geolocation Attributes: TAG (str): location city (str): City name code (str): Country code continentCode (str): Continent code coordinates (Tuple): Latitude and longitude country (str): Country name europeanUnionMember (bool): True if the country is a member of the European Union inPrivacyRestrictedCountry (bool): True if the country is privacy restricted postalCode (str): Postal code subdivisions (str): Subdivision name timezone (str): Timezone rcZ|jjd|_|jjd|_|jjd|_t d|jjdxsdj dD|_|jjd|_|jjd|_ |jjd |_ |jjd |_ |jjd }|d k(rd ntjt||_|jjd}|d k(rd |_ytjt||_y)rNcityr6continent_codec3PK|]}tjt| ywr)rrfloat)rcoords r;rz(GeoLocation._loadData..+ s!!f2dEJJue $2ds$& coordinatesrkrV postal_code subdivisions time_zoneeuropean_union_memberUnknownFin_privacy_restricted_countryN)r~r%rr6 continentCodetuplerrrV postalCoderrrrreuropeanUnionMemberinPrivacyRestrictedCountry)r0r8rrs r;rzGeoLocation._loadData& s@KKOOF+ KKOOF+ ![[__-=> !f37;;??=3Q3XUX2_2_`c2d!ff{{y1 ++//-8 KKOON;  4 "kkoo.EF(I5E5::dL_;`  &*[[__5T%U"/9r> s Cpr<r>r)Drr/rr rrrrr urllib.parserrrr r'rcryptography.hazmat.primitivesr )cryptography.hazmat.primitives.asymmetricr ImportErrorrplexapir r rrrrrr plexapi.baserrplexapi.clientrplexapi.exceptionsrrrrplexapi.libraryrplexapi.serverr plexapi.sonosr plexapi.syncrrrequests.status_codesr rr"rrLrfrUrrrrrrrrrr>rr<r;rsV   22CC<A,,,9%TT*%)+1E'JE'P$WWt$=:$=N!bj!bH8` 8`vOAZOAd<<:U3:U3ps3s3lJ3J3Z1: D1.J1.hP P>$p*$pIPL  Cs#D,D9,D65D69EE