youtube.py 196 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497
  1. # coding: utf-8
  2. from __future__ import unicode_literals
  3. import collections
  4. import hashlib
  5. import itertools
  6. import json
  7. import os.path
  8. import random
  9. import re
  10. import string
  11. import time
  12. import traceback
  13. from .common import InfoExtractor, SearchInfoExtractor
  14. from ..compat import (
  15. compat_chr,
  16. compat_HTTPError,
  17. compat_map as map,
  18. compat_dict as o_dict,
  19. compat_dict_items as dict_items,
  20. compat_str,
  21. compat_urllib_parse,
  22. compat_urllib_parse_parse_qs as compat_parse_qs,
  23. compat_urllib_parse_unquote_plus,
  24. compat_urllib_parse_urlparse,
  25. compat_zip as zip,
  26. )
  27. from ..jsinterp import JSInterpreter
  28. from ..utils import (
  29. bug_reports_message,
  30. clean_html,
  31. dict_get,
  32. error_to_compat_str,
  33. ExtractorError,
  34. filter_dict,
  35. float_or_none,
  36. get_first,
  37. extract_attributes,
  38. get_element_by_attribute,
  39. int_or_none,
  40. join_nonempty,
  41. js_to_json,
  42. LazyList,
  43. merge_dicts,
  44. mimetype2ext,
  45. NO_DEFAULT,
  46. parse_codecs,
  47. parse_count,
  48. parse_duration,
  49. parse_qs,
  50. qualities,
  51. remove_end,
  52. remove_start,
  53. smuggle_url,
  54. str_or_none,
  55. str_to_int,
  56. T,
  57. traverse_obj,
  58. try_call,
  59. try_get,
  60. txt_or_none,
  61. unescapeHTML,
  62. unified_strdate,
  63. unsmuggle_url,
  64. update_url,
  65. update_url_query,
  66. url_or_none,
  67. urlencode_postdata,
  68. urljoin,
  69. variadic,
  70. )
  71. class YoutubeBaseInfoExtractor(InfoExtractor):
  72. """Provide base functions for Youtube extractors"""
  73. _LOGIN_URL = 'https://accounts.google.com/ServiceLogin'
  74. _TWOFACTOR_URL = 'https://accounts.google.com/signin/challenge'
  75. _LOOKUP_URL = 'https://accounts.google.com/_/signin/sl/lookup'
  76. _CHALLENGE_URL = 'https://accounts.google.com/_/signin/sl/challenge'
  77. _TFA_URL = 'https://accounts.google.com/_/signin/challenge?hl=en&TL={0}'
  78. _NETRC_MACHINE = 'youtube'
  79. # If True it will raise an error if no login info is provided
  80. _LOGIN_REQUIRED = False
  81. _PLAYLIST_ID_RE = r'(?:(?:PL|LL|EC|UU|FL|RD|UL|TL|PU|OLAK5uy_)[0-9A-Za-z-_]{10,}|RDMM)'
  82. # priority order for now
  83. _INNERTUBE_CLIENTS = o_dict((
  84. # Doesn't require a PoToken for some reason: thx yt-dlp/yt-dlp#14693
  85. ('android_sdkless', {
  86. 'INNERTUBE_CONTEXT': {
  87. 'client': {
  88. 'clientName': 'ANDROID',
  89. 'clientVersion': '20.10.38',
  90. 'userAgent': 'com.google.android.youtube/20.10.38 (Linux; U; Android 11) gzip',
  91. 'osName': 'Android',
  92. 'osVersion': '11',
  93. },
  94. },
  95. 'INNERTUBE_CONTEXT_CLIENT_NAME': 3,
  96. 'REQUIRE_JS_PLAYER': False,
  97. 'WITH_COOKIES': False,
  98. }),
  99. ('ios', {
  100. 'INNERTUBE_CONTEXT': {
  101. 'client': {
  102. 'clientName': 'IOS',
  103. 'clientVersion': '20.10.4',
  104. 'deviceMake': 'Apple',
  105. 'deviceModel': 'iPhone16,2',
  106. 'userAgent': 'com.google.ios.youtube/20.10.4 (iPhone16,2; U; CPU iOS 18_3_2 like Mac OS X;)',
  107. 'osName': 'iPhone',
  108. 'osVersion': '18.3.2.22D82',
  109. },
  110. },
  111. 'INNERTUBE_CONTEXT_CLIENT_NAME': 5,
  112. 'REQUIRE_PO_TOKEN': True,
  113. 'REQUIRE_JS_PLAYER': False,
  114. 'WITH_COOKIES': False,
  115. }),
  116. # mweb has 'ultralow' formats
  117. # See: https://github.com/yt-dlp/yt-dlp/pull/557
  118. ('mweb', {
  119. 'INNERTUBE_CONTEXT': {
  120. 'client': {
  121. 'clientName': 'MWEB',
  122. 'clientVersion': '2.2.20250925.01.00',
  123. # mweb previously did not require PO Token with this UA
  124. 'userAgent': 'Mozilla/5.0 (iPad; CPU OS 16_7_10 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1,gzip(gfe)',
  125. },
  126. },
  127. 'INNERTUBE_CONTEXT_CLIENT_NAME': 2,
  128. 'REQUIRE_PO_TOKEN': True,
  129. }),
  130. ('tv_downgraded', {
  131. 'INNERTUBE_CONTEXT': {
  132. 'client': {
  133. 'clientName': 'TVHTML5',
  134. 'clientVersion': '4', # avoids SABR formats, thx yt-dlp/yt-dlp#14887
  135. 'userAgent': 'Mozilla/5.0 (ChromiumStylePlatform) Cobalt/Version',
  136. },
  137. },
  138. 'INNERTUBE_CONTEXT_CLIENT_NAME': 7,
  139. 'SUPPORTS_COOKIES': True,
  140. }),
  141. ('tv', {
  142. 'INNERTUBE_CONTEXT': {
  143. 'client': {
  144. 'clientName': 'TVHTML5',
  145. 'clientVersion': '7.20250312.16.00',
  146. # See: https://github.com/youtube/cobalt/blob/main/cobalt/browser/user_agent/user_agent_platform_info.cc#L506
  147. 'userAgent': 'Mozilla/5.0 (ChromiumStylePlatform) Cobalt/25.lts.30.1034943-gold (unlike Gecko), Unknown_TV_Unknown_0/Unknown (Unknown, Unknown)',
  148. },
  149. },
  150. 'INNERTUBE_CONTEXT_CLIENT_NAME': 7,
  151. }),
  152. ('web', {
  153. 'INNERTUBE_CONTEXT': {
  154. 'client': {
  155. 'clientName': 'WEB',
  156. 'clientVersion': '2.20250925.01.00',
  157. 'userAgent': 'Mozilla/5.0',
  158. },
  159. },
  160. 'INNERTUBE_CONTEXT_CLIENT_NAME': 1,
  161. 'REQUIRE_PO_TOKEN': True,
  162. }),
  163. ('web_embedded', {
  164. 'INNERTUBE_CONTEXT': {
  165. 'client': {
  166. 'clientName': 'WEB_EMBEDDED_PLAYER',
  167. 'clientVersion': '1.20250923.21.00',
  168. 'embedUrl': 'https://www.youtube.com/', # Can be any valid URL
  169. },
  170. },
  171. 'INNERTUBE_CONTEXT_CLIENT_NAME': 56,
  172. 'SUPPORTS_COOKIES': True,
  173. }),
  174. # Safari UA returns pre-merged video+audio 144p/240p/360p/720p/1080p HLS formats
  175. ('web_safari', {
  176. 'INNERTUBE_CONTEXT': {
  177. 'client': {
  178. 'clientName': 'WEB',
  179. 'clientVersion': '2.20250925.01.00',
  180. 'userAgent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.5 Safari/605.1.15,gzip(gfe)',
  181. },
  182. },
  183. 'INNERTUBE_CONTEXT_CLIENT_NAME': 1,
  184. 'SUPPORTS_COOKIES': True,
  185. 'REQUIRE_PO': True,
  186. }),
  187. # This client now requires sign-in for every video
  188. ('web_creator', {
  189. 'INNERTUBE_CONTEXT': {
  190. 'client': {
  191. 'clientName': 'WEB_CREATOR',
  192. 'clientVersion': '1.20250922.03.00',
  193. },
  194. },
  195. 'INNERTUBE_CONTEXT_CLIENT_NAME': 62,
  196. 'REQUIRE_AUTH': True,
  197. 'SUPPORTS_COOKIES': True,
  198. 'WITH_COOKIES': True,
  199. }),
  200. ))
  201. def _login(self):
  202. """
  203. Attempt to log in to YouTube.
  204. True is returned if successful or skipped.
  205. False is returned if login failed.
  206. If _LOGIN_REQUIRED is set and no authentication was provided, an error is raised.
  207. """
  208. username, password = self._get_login_info()
  209. # No authentication to be performed
  210. if username is None:
  211. if self._LOGIN_REQUIRED and self._downloader.params.get('cookiefile') is None:
  212. raise ExtractorError('No login info available, needed for using %s.' % self.IE_NAME, expected=True)
  213. return True
  214. login_page = self._download_webpage(
  215. self._LOGIN_URL, None,
  216. note='Downloading login page',
  217. errnote='unable to fetch login page', fatal=False)
  218. if login_page is False:
  219. return
  220. login_form = self._hidden_inputs(login_page)
  221. def req(url, f_req, note, errnote):
  222. data = login_form.copy()
  223. data.update({
  224. 'pstMsg': 1,
  225. 'checkConnection': 'youtube',
  226. 'checkedDomains': 'youtube',
  227. 'hl': 'en',
  228. 'deviceinfo': '[null,null,null,[],null,"US",null,null,[],"GlifWebSignIn",null,[null,null,[]]]',
  229. 'f.req': json.dumps(f_req),
  230. 'flowName': 'GlifWebSignIn',
  231. 'flowEntry': 'ServiceLogin',
  232. # TODO: reverse actual botguard identifier generation algo
  233. 'bgRequest': '["identifier",""]',
  234. })
  235. return self._download_json(
  236. url, None, note=note, errnote=errnote,
  237. transform_source=lambda s: re.sub(r'^[^[]*', '', s),
  238. fatal=False,
  239. data=urlencode_postdata(data), headers={
  240. 'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8',
  241. 'Google-Accounts-XSRF': 1,
  242. })
  243. def warn(message):
  244. self._downloader.report_warning(message)
  245. lookup_req = [
  246. username,
  247. None, [], None, 'US', None, None, 2, False, True,
  248. [
  249. None, None,
  250. [2, 1, None, 1,
  251. 'https://accounts.google.com/ServiceLogin?passive=true&continue=https%3A%2F%2Fwww.youtube.com%2Fsignin%3Fnext%3D%252F%26action_handle_signin%3Dtrue%26hl%3Den%26app%3Ddesktop%26feature%3Dsign_in_button&hl=en&service=youtube&uilel=3&requestPath=%2FServiceLogin&Page=PasswordSeparationSignIn',
  252. None, [], 4],
  253. 1, [None, None, []], None, None, None, True,
  254. ],
  255. username,
  256. ]
  257. lookup_results = req(
  258. self._LOOKUP_URL, lookup_req,
  259. 'Looking up account info', 'Unable to look up account info')
  260. if lookup_results is False:
  261. return False
  262. user_hash = try_get(lookup_results, lambda x: x[0][2], compat_str)
  263. if not user_hash:
  264. warn('Unable to extract user hash')
  265. return False
  266. challenge_req = [
  267. user_hash,
  268. None, 1, None, [1, None, None, None, [password, None, True]],
  269. [
  270. None, None, [2, 1, None, 1, 'https://accounts.google.com/ServiceLogin?passive=true&continue=https%3A%2F%2Fwww.youtube.com%2Fsignin%3Fnext%3D%252F%26action_handle_signin%3Dtrue%26hl%3Den%26app%3Ddesktop%26feature%3Dsign_in_button&hl=en&service=youtube&uilel=3&requestPath=%2FServiceLogin&Page=PasswordSeparationSignIn', None, [], 4],
  271. 1, [None, None, []], None, None, None, True,
  272. ]]
  273. challenge_results = req(
  274. self._CHALLENGE_URL, challenge_req,
  275. 'Logging in', 'Unable to log in')
  276. if challenge_results is False:
  277. return
  278. login_res = try_get(challenge_results, lambda x: x[0][5], list)
  279. if login_res:
  280. login_msg = try_get(login_res, lambda x: x[5], compat_str)
  281. warn(
  282. 'Unable to login: %s' % 'Invalid password'
  283. if login_msg == 'INCORRECT_ANSWER_ENTERED' else login_msg)
  284. return False
  285. res = try_get(challenge_results, lambda x: x[0][-1], list)
  286. if not res:
  287. warn('Unable to extract result entry')
  288. return False
  289. login_challenge = try_get(res, lambda x: x[0][0], list)
  290. if login_challenge:
  291. challenge_str = try_get(login_challenge, lambda x: x[2], compat_str)
  292. if challenge_str == 'TWO_STEP_VERIFICATION':
  293. # SEND_SUCCESS - TFA code has been successfully sent to phone
  294. # QUOTA_EXCEEDED - reached the limit of TFA codes
  295. status = try_get(login_challenge, lambda x: x[5], compat_str)
  296. if status == 'QUOTA_EXCEEDED':
  297. warn('Exceeded the limit of TFA codes, try later')
  298. return False
  299. tl = try_get(challenge_results, lambda x: x[1][2], compat_str)
  300. if not tl:
  301. warn('Unable to extract TL')
  302. return False
  303. tfa_code = self._get_tfa_info('2-step verification code')
  304. if not tfa_code:
  305. warn(
  306. 'Two-factor authentication required. Provide it either interactively or with --twofactor <code>'
  307. '(Note that only TOTP (Google Authenticator App) codes work at this time.)')
  308. return False
  309. tfa_code = remove_start(tfa_code, 'G-')
  310. tfa_req = [
  311. user_hash, None, 2, None,
  312. [
  313. 9, None, None, None, None, None, None, None,
  314. [None, tfa_code, True, 2],
  315. ]]
  316. tfa_results = req(
  317. self._TFA_URL.format(tl), tfa_req,
  318. 'Submitting TFA code', 'Unable to submit TFA code')
  319. if tfa_results is False:
  320. return False
  321. tfa_res = try_get(tfa_results, lambda x: x[0][5], list)
  322. if tfa_res:
  323. tfa_msg = try_get(tfa_res, lambda x: x[5], compat_str)
  324. warn(
  325. 'Unable to finish TFA: %s' % 'Invalid TFA code'
  326. if tfa_msg == 'INCORRECT_ANSWER_ENTERED' else tfa_msg)
  327. return False
  328. check_cookie_url = try_get(
  329. tfa_results, lambda x: x[0][-1][2], compat_str)
  330. else:
  331. CHALLENGES = {
  332. 'LOGIN_CHALLENGE': "This device isn't recognized. For your security, Google wants to make sure it's really you.",
  333. 'USERNAME_RECOVERY': 'Please provide additional information to aid in the recovery process.',
  334. 'REAUTH': "There is something unusual about your activity. For your security, Google wants to make sure it's really you.",
  335. }
  336. challenge = CHALLENGES.get(
  337. challenge_str,
  338. '%s returned error %s.' % (self.IE_NAME, challenge_str))
  339. warn('%s\nGo to https://accounts.google.com/, login and solve a challenge.' % challenge)
  340. return False
  341. else:
  342. check_cookie_url = try_get(res, lambda x: x[2], compat_str)
  343. if not check_cookie_url:
  344. warn('Unable to extract CheckCookie URL')
  345. return False
  346. check_cookie_results = self._download_webpage(
  347. check_cookie_url, None, 'Checking cookie', fatal=False)
  348. if check_cookie_results is False:
  349. return False
  350. if 'https://myaccount.google.com/' not in check_cookie_results:
  351. warn('Unable to log in')
  352. return False
  353. return True
  354. def _initialize_consent(self):
  355. cookies = self._get_cookies('https://www.youtube.com/')
  356. if cookies.get('__Secure-3PSID'):
  357. return
  358. socs = cookies.get('SOCS')
  359. if socs and not socs.value.startswith('CAA'): # not consented
  360. return
  361. self._set_cookie('.youtube.com', 'SOCS', 'CAI', secure=True) # accept all (required for mixes)
  362. def _real_initialize(self):
  363. self._initialize_consent()
  364. if self._downloader is None:
  365. return
  366. if not self._login():
  367. return
  368. _DEFAULT_API_DATA = {'context': _INNERTUBE_CLIENTS['web']['INNERTUBE_CONTEXT']}
  369. _YT_INITIAL_DATA_RE = r'(?:window\s*\[\s*["\']ytInitialData["\']\s*\]|ytInitialData)\s*=\s*({.+?})\s*;'
  370. _YT_INITIAL_PLAYER_RESPONSE_RE = r'ytInitialPlayerResponse\s*=\s*({.+?})\s*;'
  371. _YT_INITIAL_BOUNDARY_RE = r'(?:var\s+meta|</script|\n)'
  372. _SAPISID = None
  373. def _generate_sapisidhash_header(self, origin='https://www.youtube.com'):
  374. time_now = round(time.time())
  375. if self._SAPISID is None:
  376. yt_cookies = self._get_cookies('https://www.youtube.com')
  377. # Sometimes SAPISID cookie isn't present but __Secure-3PAPISID is.
  378. # See: https://github.com/yt-dlp/yt-dlp/issues/393
  379. sapisid_cookie = dict_get(
  380. yt_cookies, ('__Secure-3PAPISID', 'SAPISID'))
  381. if sapisid_cookie and sapisid_cookie.value:
  382. self._SAPISID = sapisid_cookie.value
  383. self.write_debug('Extracted SAPISID cookie')
  384. # SAPISID cookie is required if not already present
  385. if not yt_cookies.get('SAPISID'):
  386. self.write_debug('Copying __Secure-3PAPISID cookie to SAPISID cookie')
  387. self._set_cookie(
  388. '.youtube.com', 'SAPISID', self._SAPISID, secure=True, expire_time=time_now + 3600)
  389. else:
  390. self._SAPISID = False
  391. if not self._SAPISID:
  392. return None
  393. # SAPISIDHASH algorithm from https://stackoverflow.com/a/32065323
  394. sapisidhash = hashlib.sha1(
  395. '{0} {1} {2}'.format(time_now, self._SAPISID, origin).encode('utf-8')).hexdigest()
  396. return 'SAPISIDHASH {0}_{1}'.format(time_now, sapisidhash)
  397. def _call_api(self, ep, query, video_id, fatal=True, headers=None,
  398. note='Downloading API JSON'):
  399. data = self._DEFAULT_API_DATA.copy()
  400. data.update(query)
  401. real_headers = {'content-type': 'application/json'}
  402. if headers:
  403. real_headers.update(headers)
  404. # was: 'AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8'
  405. api_key = self.get_param('youtube_innertube_key')
  406. return self._download_json(
  407. 'https://www.youtube.com/youtubei/v1/%s' % ep, video_id=video_id,
  408. note=note, errnote='Unable to download API page',
  409. data=json.dumps(data).encode('utf8'), fatal=fatal,
  410. headers=real_headers, query=filter_dict({
  411. 'key': api_key,
  412. 'prettyPrint': 'false',
  413. }))
  414. def _extract_yt_initial_data(self, video_id, webpage):
  415. return self._parse_json(
  416. self._search_regex(
  417. (r'%s\s*%s' % (self._YT_INITIAL_DATA_RE, self._YT_INITIAL_BOUNDARY_RE),
  418. self._YT_INITIAL_DATA_RE), webpage, 'yt initial data'),
  419. video_id)
  420. def _extract_visitor_data(self, *args):
  421. """
  422. Extract visitorData from an API response or ytcfg
  423. Appears to be used to track session state
  424. """
  425. visitor_data = self.get_param('youtube_visitor_data')
  426. if visitor_data:
  427. return visitor_data
  428. return get_first(
  429. args, (('VISITOR_DATA',
  430. ('INNERTUBE_CONTEXT', 'client', 'visitorData'),
  431. ('responseContext', 'visitorData')),
  432. T(compat_str)))
  433. # @functools.cached_property
  434. def is_authenticated(self, _cache={}):
  435. if self not in _cache:
  436. _cache[self] = bool(self._generate_sapisidhash_header())
  437. return _cache[self]
  438. def _extract_ytcfg(self, video_id, webpage):
  439. ytcfg = self._search_json(
  440. r'ytcfg\.set\s*\(', webpage, 'ytcfg', video_id,
  441. end_pattern=r'\)\s*;', default={})
  442. traverse_obj(ytcfg, (
  443. 'INNERTUBE_CONTEXT', 'client', 'configInfo',
  444. T(lambda x: x.pop('appInstallData', None))))
  445. return ytcfg
  446. def _extract_video(self, renderer):
  447. video_id = renderer['videoId']
  448. title = try_get(
  449. renderer,
  450. (lambda x: x['title']['runs'][0]['text'],
  451. lambda x: x['title']['simpleText'],
  452. lambda x: x['headline']['simpleText']), compat_str)
  453. description = try_get(
  454. renderer, lambda x: x['descriptionSnippet']['runs'][0]['text'],
  455. compat_str)
  456. duration = parse_duration(try_get(
  457. renderer, lambda x: x['lengthText']['simpleText'], compat_str))
  458. view_count_text = try_get(
  459. renderer, lambda x: x['viewCountText']['simpleText'], compat_str) or ''
  460. view_count = str_to_int(self._search_regex(
  461. r'^([\d,]+)', re.sub(r'\s', '', view_count_text),
  462. 'view count', default=None))
  463. uploader = try_get(
  464. renderer,
  465. (lambda x: x['ownerText']['runs'][0]['text'],
  466. lambda x: x['shortBylineText']['runs'][0]['text']), compat_str)
  467. return {
  468. '_type': 'url',
  469. 'ie_key': YoutubeIE.ie_key(),
  470. 'id': video_id,
  471. 'url': video_id,
  472. 'title': title,
  473. 'description': description,
  474. 'duration': duration,
  475. 'view_count': view_count,
  476. 'uploader': uploader,
  477. }
  478. @staticmethod
  479. def _get_text(data, *path_list, **kw_max_runs):
  480. max_runs = kw_max_runs.get('max_runs')
  481. for path in path_list or [None]:
  482. if path is None:
  483. obj = [data] # shortcut
  484. else:
  485. obj = traverse_obj(data, tuple(variadic(path) + (all,)))
  486. for runs in traverse_obj(
  487. obj, ('simpleText', {'text': T(compat_str)}, all, filter),
  488. ('runs', lambda _, r: isinstance(r.get('text'), compat_str), all, filter),
  489. (T(list), lambda _, r: isinstance(r.get('text'), compat_str)),
  490. default=[]):
  491. max_runs = int_or_none(max_runs, default=len(runs))
  492. if max_runs < len(runs):
  493. runs = runs[:max_runs]
  494. text = ''.join(traverse_obj(runs, (Ellipsis, 'text')))
  495. if text:
  496. return text
  497. @staticmethod
  498. def _extract_thumbnails(data, *path_list, **kw_final_key):
  499. """
  500. Extract thumbnails from thumbnails dict
  501. @param path_list: path list to level that contains 'thumbnails' key
  502. """
  503. final_key = kw_final_key.get('final_key', 'thumbnails')
  504. return traverse_obj(data, ((
  505. tuple(variadic(path) + (final_key, Ellipsis)
  506. for path in path_list or [()])), {
  507. 'url': ('url', T(url_or_none),
  508. # Sometimes youtube gives a wrong thumbnail URL. See:
  509. # https://github.com/yt-dlp/yt-dlp/issues/233
  510. # https://github.com/ytdl-org/youtube-dl/issues/28023
  511. T(lambda u: update_url(u, query=None) if u and 'maxresdefault' in u else u)),
  512. 'height': ('height', T(int_or_none)),
  513. 'width': ('width', T(int_or_none)),
  514. }, T(lambda t: t if t.get('url') else None)))
  515. def _search_results(self, query, params):
  516. data = {
  517. 'context': {
  518. 'client': {
  519. 'clientName': 'WEB',
  520. 'clientVersion': '2.20201021.03.00',
  521. },
  522. },
  523. 'query': query,
  524. }
  525. if params:
  526. data['params'] = params
  527. for page_num in itertools.count(1):
  528. search = self._download_json(
  529. 'https://www.youtube.com/youtubei/v1/search',
  530. video_id='query "%s"' % query,
  531. note='Downloading page %s' % page_num,
  532. errnote='Unable to download API page', fatal=False,
  533. data=json.dumps(data).encode('utf8'),
  534. query={
  535. # 'key': 'AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8',
  536. 'prettyPrint': 'false',
  537. },
  538. headers={'content-type': 'application/json'})
  539. if not search:
  540. break
  541. slr_contents = traverse_obj(
  542. search,
  543. ('contents', 'twoColumnSearchResultsRenderer', 'primaryContents',
  544. 'sectionListRenderer', 'contents'),
  545. ('onResponseReceivedCommands', 0, 'appendContinuationItemsAction',
  546. 'continuationItems'),
  547. expected_type=list)
  548. if not slr_contents:
  549. break
  550. for video in traverse_obj(
  551. slr_contents,
  552. (Ellipsis, 'itemSectionRenderer', 'contents',
  553. Ellipsis, 'videoRenderer',
  554. T(lambda v: v if v.get('videoId') else None))):
  555. yield self._extract_video(video)
  556. token = traverse_obj(
  557. slr_contents,
  558. (-1, 'continuationItemRenderer', 'continuationEndpoint',
  559. 'continuationCommand', 'token', T(compat_str)))
  560. if not token:
  561. break
  562. data['continuation'] = token
  563. @staticmethod
  564. def _owner_endpoints_path():
  565. return [
  566. Ellipsis,
  567. lambda k, _: k.endswith('SecondaryInfoRenderer'),
  568. ('owner', 'videoOwner'), 'videoOwnerRenderer', 'title',
  569. 'runs', Ellipsis]
  570. def _extract_channel_id(self, webpage, videodetails={}, metadata={}, renderers=[]):
  571. channel_id = None
  572. if any((videodetails, metadata, renderers)):
  573. channel_id = (
  574. traverse_obj(videodetails, 'channelId')
  575. or traverse_obj(metadata, 'externalChannelId', 'externalId')
  576. or traverse_obj(renderers,
  577. self._owner_endpoints_path() + [
  578. 'navigationEndpoint', 'browseEndpoint', 'browseId'],
  579. get_all=False)
  580. )
  581. return channel_id or self._html_search_meta(
  582. 'channelId', webpage, 'channel id', default=None)
  583. def _extract_author_var(self, webpage, var_name,
  584. videodetails={}, metadata={}, renderers=[]):
  585. result = None
  586. paths = {
  587. # (HTML, videodetails, metadata, renderers)
  588. 'name': ('content', 'author', (('ownerChannelName', None), 'title'), ['text']),
  589. 'url': ('href', 'ownerProfileUrl', 'vanityChannelUrl',
  590. ['navigationEndpoint', 'browseEndpoint', 'canonicalBaseUrl']),
  591. }
  592. if any((videodetails, metadata, renderers)):
  593. result = (
  594. traverse_obj(videodetails, paths[var_name][1], get_all=False)
  595. or traverse_obj(metadata, paths[var_name][2], get_all=False)
  596. or traverse_obj(renderers,
  597. self._owner_endpoints_path() + paths[var_name][3],
  598. get_all=False)
  599. )
  600. return result or traverse_obj(
  601. extract_attributes(self._search_regex(
  602. r'''(?s)(<link\b[^>]+\bitemprop\s*=\s*("|')%s\2[^>]*>)'''
  603. % re.escape(var_name),
  604. get_element_by_attribute('itemprop', 'author', webpage or '') or '',
  605. 'author link', default='')),
  606. paths[var_name][0])
  607. @staticmethod
  608. def _yt_urljoin(url_or_path):
  609. return urljoin('https://www.youtube.com', url_or_path)
  610. def _extract_uploader_id(self, uploader_url):
  611. return self._search_regex(
  612. r'/(?:(?:channel|user)/|(?=@))([^/?&#]+)', uploader_url or '',
  613. 'uploader id', default=None)
  614. class YoutubeIE(YoutubeBaseInfoExtractor):
  615. IE_DESC = 'YouTube.com'
  616. _INVIDIOUS_SITES = (
  617. # invidious-redirect websites
  618. r'(?:www\.)?redirect\.invidious\.io',
  619. r'(?:(?:www|dev)\.)?invidio\.us',
  620. # Invidious instances taken from https://github.com/iv-org/documentation/blob/master/Invidious-Instances.md
  621. r'(?:(?:www|no)\.)?invidiou\.sh',
  622. r'(?:(?:www|fi)\.)?invidious\.snopyta\.org',
  623. r'(?:www\.)?invidious\.kabi\.tk',
  624. r'(?:www\.)?invidious\.13ad\.de',
  625. r'(?:www\.)?invidious\.mastodon\.host',
  626. r'(?:www\.)?invidious\.zapashcanon\.fr',
  627. r'(?:www\.)?(?:invidious(?:-us)?|piped)\.kavin\.rocks',
  628. r'(?:www\.)?invidious\.tinfoil-hat\.net',
  629. r'(?:www\.)?invidious\.himiko\.cloud',
  630. r'(?:www\.)?invidious\.reallyancient\.tech',
  631. r'(?:www\.)?invidious\.tube',
  632. r'(?:www\.)?invidiou\.site',
  633. r'(?:www\.)?invidious\.site',
  634. r'(?:www\.)?invidious\.xyz',
  635. r'(?:www\.)?invidious\.nixnet\.xyz',
  636. r'(?:www\.)?invidious\.048596\.xyz',
  637. r'(?:www\.)?invidious\.drycat\.fr',
  638. r'(?:www\.)?inv\.skyn3t\.in',
  639. r'(?:www\.)?tube\.poal\.co',
  640. r'(?:www\.)?tube\.connect\.cafe',
  641. r'(?:www\.)?vid\.wxzm\.sx',
  642. r'(?:www\.)?vid\.mint\.lgbt',
  643. r'(?:www\.)?vid\.puffyan\.us',
  644. r'(?:www\.)?yewtu\.be',
  645. r'(?:www\.)?yt\.elukerio\.org',
  646. r'(?:www\.)?yt\.lelux\.fi',
  647. r'(?:www\.)?invidious\.ggc-project\.de',
  648. r'(?:www\.)?yt\.maisputain\.ovh',
  649. r'(?:www\.)?ytprivate\.com',
  650. r'(?:www\.)?invidious\.13ad\.de',
  651. r'(?:www\.)?invidious\.toot\.koeln',
  652. r'(?:www\.)?invidious\.fdn\.fr',
  653. r'(?:www\.)?watch\.nettohikari\.com',
  654. r'(?:www\.)?invidious\.namazso\.eu',
  655. r'(?:www\.)?invidious\.silkky\.cloud',
  656. r'(?:www\.)?invidious\.exonip\.de',
  657. r'(?:www\.)?invidious\.riverside\.rocks',
  658. r'(?:www\.)?invidious\.blamefran\.net',
  659. r'(?:www\.)?invidious\.moomoo\.de',
  660. r'(?:www\.)?ytb\.trom\.tf',
  661. r'(?:www\.)?yt\.cyberhost\.uk',
  662. r'(?:www\.)?kgg2m7yk5aybusll\.onion',
  663. r'(?:www\.)?qklhadlycap4cnod\.onion',
  664. r'(?:www\.)?axqzx4s6s54s32yentfqojs3x5i7faxza6xo3ehd4bzzsg2ii4fv2iid\.onion',
  665. r'(?:www\.)?c7hqkpkpemu6e7emz5b4vyz7idjgdvgaaa3dyimmeojqbgpea3xqjoid\.onion',
  666. r'(?:www\.)?fz253lmuao3strwbfbmx46yu7acac2jz27iwtorgmbqlkurlclmancad\.onion',
  667. r'(?:www\.)?invidious\.l4qlywnpwqsluw65ts7md3khrivpirse744un3x7mlskqauz5pyuzgqd\.onion',
  668. r'(?:www\.)?owxfohz4kjyv25fvlqilyxast7inivgiktls3th44jhk3ej3i7ya\.b32\.i2p',
  669. r'(?:www\.)?4l2dgddgsrkf2ous66i6seeyi6etzfgrue332grh2n7madpwopotugyd\.onion',
  670. r'(?:www\.)?w6ijuptxiku4xpnnaetxvnkc5vqcdu7mgns2u77qefoixi63vbvnpnqd\.onion',
  671. r'(?:www\.)?kbjggqkzv65ivcqj6bumvp337z6264huv5kpkwuv6gu5yjiskvan7fad\.onion',
  672. r'(?:www\.)?grwp24hodrefzvjjuccrkw3mjq4tzhaaq32amf33dzpmuxe7ilepcmad\.onion',
  673. r'(?:www\.)?hpniueoejy4opn7bc4ftgazyqjoeqwlvh2uiku2xqku6zpoa4bf5ruid\.onion',
  674. )
  675. _VALID_URL = r"""(?x)^
  676. (
  677. (?:https?://|//) # http(s):// or protocol-independent URL
  678. (?:(?:(?:(?:\w+\.)?[yY][oO][uU][tT][uU][bB][eE](?:-nocookie|kids)?\.com|
  679. (?:www\.)?deturl\.com/www\.youtube\.com|
  680. (?:www\.)?pwnyoutube\.com|
  681. (?:www\.)?hooktube\.com|
  682. (?:www\.)?yourepeat\.com|
  683. tube\.majestyc\.net|
  684. %(invidious)s|
  685. youtube\.googleapis\.com)/ # the various hostnames, with wildcard subdomains
  686. (?:.*?\#/)? # handle anchor (#/) redirect urls
  687. (?: # the various things that can precede the ID:
  688. (?:(?:v|embed|e)/(?!videoseries)) # v/ or embed/ or e/
  689. |shorts/
  690. |(?: # or the v= param in all its forms
  691. (?:(?:watch|movie)(?:_popup)?(?:\.php)?/?)? # preceding watch(_popup|.php) or nothing (like /?v=xxxx)
  692. (?:\?|\#!?) # the params delimiter ? or # or #!
  693. (?:.*?[&;])?? # any other preceding param (like /?s=tuff&v=xxxx or ?s=tuff&amp;v=V36LpHqtcDY)
  694. v=
  695. )
  696. ))
  697. |(?:
  698. youtu\.be| # just youtu.be/xxxx
  699. vid\.plus| # or vid.plus/xxxx
  700. zwearz\.com/watch| # or zwearz.com/watch/xxxx
  701. %(invidious)s
  702. )/
  703. |(?:www\.)?cleanvideosearch\.com/media/action/yt/watch\?videoId=
  704. )
  705. )? # all until now is optional -> you can pass the naked ID
  706. (?P<id>[0-9A-Za-z_-]{11}) # here is it! the YouTube video ID
  707. (?(1).+)? # if we found the ID, everything can follow
  708. $""" % {
  709. 'invidious': '|'.join(_INVIDIOUS_SITES),
  710. }
  711. _PLAYER_INFO_RE = (
  712. r'/s/player/(?P<id>[a-zA-Z0-9_-]{8,})/(?:tv-)?player',
  713. r'/(?P<id>[a-zA-Z0-9_-]{8,})/player(?:_ias(?:_tce)?\.vflset(?:/[a-zA-Z]{2,3}_[a-zA-Z]{2,3})?|-plasma-ias-(?:phone|tablet)-[a-z]{2}_[A-Z]{2}\.vflset)/base\.js$',
  714. r'\b(?P<id>vfl[a-zA-Z0-9_-]{6,})\b.*?\.js$',
  715. )
  716. _SUBTITLE_FORMATS = ('json3', 'srv1', 'srv2', 'srv3', 'ttml', 'srt', 'vtt')
  717. _GEO_BYPASS = False
  718. IE_NAME = 'youtube'
  719. _TESTS = [
  720. {
  721. 'url': 'https://www.youtube.com/watch?v=BaW_jenozKc&t=1s&end=9',
  722. 'info_dict': {
  723. 'id': 'BaW_jenozKc',
  724. 'ext': 'mp4',
  725. 'title': 'youtube-dl test video "\'/\\ä↭𝕐',
  726. 'uploader': 'Philipp Hagemeister',
  727. 'uploader_id': '@PhilippHagemeister',
  728. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@PhilippHagemeister',
  729. 'channel': 'Philipp Hagemeister',
  730. 'channel_id': 'UCLqxVugv74EIW3VWh2NOa3Q',
  731. 'channel_url': r're:https?://(?:www\.)?youtube\.com/channel/UCLqxVugv74EIW3VWh2NOa3Q',
  732. 'upload_date': '20121002',
  733. 'description': 'test chars: "\'/\\ä↭𝕐\ntest URL: https://github.com/rg3/youtube-dl/issues/1892\n\nThis is a test video for youtube-dl.\n\nFor more information, contact phihag@phihag.de .',
  734. 'categories': ['Science & Technology'],
  735. 'tags': ['youtube-dl'],
  736. 'duration': 10,
  737. 'view_count': int,
  738. 'like_count': int,
  739. 'thumbnail': 'https://i.ytimg.com/vi/BaW_jenozKc/maxresdefault.jpg',
  740. 'start_time': 1,
  741. 'end_time': 9,
  742. },
  743. },
  744. {
  745. 'url': '//www.YouTube.com/watch?v=yZIXLfi8CZQ',
  746. 'note': 'Embed-only video (#1746)',
  747. 'info_dict': {
  748. 'id': 'yZIXLfi8CZQ',
  749. 'ext': 'mp4',
  750. 'upload_date': '20120608',
  751. 'title': 'Principal Sexually Assaults A Teacher - Episode 117 - 8th June 2012',
  752. 'description': 'md5:09b78bd971f1e3e289601dfba15ca4f7',
  753. 'uploader': 'SET India',
  754. 'uploader_id': 'setindia',
  755. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/setindia',
  756. 'age_limit': 18,
  757. },
  758. 'skip': 'Private video',
  759. },
  760. {
  761. 'url': 'https://www.youtube.com/watch?v=BaW_jenozKc&v=yZIXLfi8CZQ',
  762. 'note': 'Use the first video ID in the URL',
  763. 'info_dict': {
  764. 'id': 'BaW_jenozKc',
  765. 'ext': 'mp4',
  766. 'title': 'youtube-dl test video "\'/\\ä↭𝕐',
  767. 'uploader': 'Philipp Hagemeister',
  768. 'uploader_id': '@PhilippHagemeister',
  769. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@PhilippHagemeister',
  770. 'upload_date': '20121002',
  771. 'description': 'test chars: "\'/\\ä↭𝕐\ntest URL: https://github.com/rg3/youtube-dl/issues/1892\n\nThis is a test video for youtube-dl.\n\nFor more information, contact phihag@phihag.de .',
  772. 'categories': ['Science & Technology'],
  773. 'tags': ['youtube-dl'],
  774. 'duration': 10,
  775. 'view_count': int,
  776. 'like_count': int,
  777. },
  778. 'params': {
  779. 'skip_download': True,
  780. },
  781. },
  782. {
  783. 'url': 'https://www.youtube.com/watch?v=a9LDPn-MO4I',
  784. 'note': '256k DASH audio (format 141) via DASH manifest',
  785. 'info_dict': {
  786. 'id': 'a9LDPn-MO4I',
  787. 'ext': 'm4a',
  788. 'upload_date': '20121002',
  789. 'uploader_id': '8KVIDEO',
  790. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/8KVIDEO',
  791. 'description': '',
  792. 'uploader': '8KVIDEO',
  793. 'title': 'UHDTV TEST 8K VIDEO.mp4',
  794. },
  795. 'params': {
  796. 'youtube_include_dash_manifest': True,
  797. 'format': '141',
  798. },
  799. 'skip': 'format 141 not served any more',
  800. },
  801. # DASH manifest with encrypted signature
  802. {
  803. 'url': 'https://www.youtube.com/watch?v=IB3lcPjvWLA',
  804. 'info_dict': {
  805. 'id': 'IB3lcPjvWLA',
  806. 'ext': 'm4a',
  807. 'title': 'Afrojack, Spree Wilson - The Spark (Official Music Video) ft. Spree Wilson',
  808. 'description': 'md5:8f5e2b82460520b619ccac1f509d43bf',
  809. 'duration': 244,
  810. 'uploader': 'AfrojackVEVO',
  811. 'uploader_id': '@AfrojackVEVO',
  812. 'upload_date': '20131011',
  813. 'abr': 129.495,
  814. },
  815. 'params': {
  816. 'youtube_include_dash_manifest': True,
  817. 'format': '141/bestaudio[ext=m4a]',
  818. },
  819. },
  820. # Controversy video
  821. {
  822. 'url': 'https://www.youtube.com/watch?v=T4XJQO3qol8',
  823. 'info_dict': {
  824. 'id': 'T4XJQO3qol8',
  825. 'ext': 'mp4',
  826. 'duration': 219,
  827. 'upload_date': '20100909',
  828. 'uploader': 'Amazing Atheist',
  829. 'uploader_id': '@theamazingatheist',
  830. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@theamazingatheist',
  831. 'title': 'Burning Everyone\'s Koran',
  832. 'description': 'SUBSCRIBE: http://www.youtube.com/saturninefilms \r\n\r\nEven Obama has taken a stand against freedom on this issue: http://www.huffingtonpost.com/2010/09/09/obama-gma-interview-quran_n_710282.html',
  833. },
  834. },
  835. # Age-gated videos
  836. {
  837. 'note': 'Age-gated video (No vevo, embed allowed)',
  838. 'url': 'https://youtube.com/watch?v=HtVdAasjOgU',
  839. 'info_dict': {
  840. 'id': 'HtVdAasjOgU',
  841. 'ext': 'mp4',
  842. 'title': 'The Witcher 3: Wild Hunt - The Sword Of Destiny Trailer',
  843. 'description': r're:(?s).{100,}About the Game\n.*?The Witcher 3: Wild Hunt.{100,}',
  844. 'duration': 142,
  845. 'uploader': 'The Witcher',
  846. 'uploader_id': '@thewitcher',
  847. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@thewitcher',
  848. 'upload_date': '20140605',
  849. 'thumbnail': 'https://i.ytimg.com/vi/HtVdAasjOgU/maxresdefault.jpg',
  850. 'age_limit': 18,
  851. 'categories': ['Gaming'],
  852. 'tags': 'count:17',
  853. 'channel': 'The Witcher',
  854. 'channel_url': 'https://www.youtube.com/channel/UCzybXLxv08IApdjdN0mJhEg',
  855. 'channel_id': 'UCzybXLxv08IApdjdN0mJhEg',
  856. 'view_count': int,
  857. 'like_count': int,
  858. },
  859. },
  860. {
  861. 'note': 'Age-gated video with embed allowed in public site',
  862. 'url': 'https://youtube.com/watch?v=HsUATh_Nc2U',
  863. 'info_dict': {
  864. 'id': 'HsUATh_Nc2U',
  865. 'ext': 'mp4',
  866. 'title': 'Godzilla 2 (Official Video)',
  867. 'description': 'md5:bf77e03fcae5529475e500129b05668a',
  868. 'duration': 177,
  869. 'uploader': 'FlyingKitty',
  870. 'uploader_id': '@FlyingKitty900',
  871. 'upload_date': '20200408',
  872. 'thumbnail': 'https://i.ytimg.com/vi/HsUATh_Nc2U/maxresdefault.jpg',
  873. 'age_limit': 18,
  874. 'categories': ['Entertainment'],
  875. 'tags': ['Flyingkitty', 'godzilla 2'],
  876. 'channel': 'FlyingKitty',
  877. 'channel_url': 'https://www.youtube.com/channel/UCYQT13AtrJC0gsM1far_zJg',
  878. 'channel_id': 'UCYQT13AtrJC0gsM1far_zJg',
  879. 'view_count': int,
  880. 'like_count': int,
  881. },
  882. },
  883. {
  884. 'note': 'Age-gated video embeddable only with clientScreen=EMBED',
  885. 'url': 'https://youtube.com/watch?v=Tq92D6wQ1mg',
  886. 'info_dict': {
  887. 'id': 'Tq92D6wQ1mg',
  888. 'ext': 'mp4',
  889. 'title': '[MMD] Adios - EVERGLOW [+Motion DL]',
  890. 'description': 'md5:17eccca93a786d51bc67646756894066',
  891. 'duration': 106,
  892. 'uploader': 'Projekt Melody',
  893. 'uploader_id': '@ProjektMelody',
  894. 'upload_date': '20191227',
  895. 'age_limit': 18,
  896. 'thumbnail': 'https://i.ytimg.com/vi/Tq92D6wQ1mg/sddefault.jpg',
  897. 'tags': ['mmd', 'dance', 'mikumikudance', 'kpop', 'vtuber'],
  898. 'categories': ['Entertainment'],
  899. 'channel': 'Projekt Melody',
  900. 'channel_url': 'https://www.youtube.com/channel/UC1yoRdFoFJaCY-AGfD9W0wQ',
  901. 'channel_id': 'UC1yoRdFoFJaCY-AGfD9W0wQ',
  902. 'view_count': int,
  903. 'like_count': int,
  904. },
  905. },
  906. {
  907. 'note': 'Non-Age-gated non-embeddable video',
  908. 'url': 'https://youtube.com/watch?v=MeJVWBSsPAY',
  909. 'info_dict': {
  910. 'id': 'MeJVWBSsPAY',
  911. 'ext': 'mp4',
  912. 'title': 'OOMPH! - Such Mich Find Mich (Lyrics)',
  913. 'description': 'Fan Video. Music & Lyrics by OOMPH!.',
  914. 'duration': 210,
  915. 'upload_date': '20130730',
  916. 'uploader': 'Herr Lurik',
  917. 'uploader_id': '@HerrLurik',
  918. 'uploader_url': 'http://www.youtube.com/@HerrLurik',
  919. 'age_limit': 0,
  920. 'thumbnail': 'https://i.ytimg.com/vi/MeJVWBSsPAY/hqdefault.jpg',
  921. 'tags': ['oomph', 'such mich find mich', 'lyrics', 'german industrial', 'musica industrial'],
  922. 'categories': ['Music'],
  923. 'channel': 'Herr Lurik',
  924. 'channel_url': 'https://www.youtube.com/channel/UCdR3RSDPqub28LjZx0v9-aA',
  925. 'channel_id': 'UCdR3RSDPqub28LjZx0v9-aA',
  926. 'artist': 'OOMPH!',
  927. 'view_count': int,
  928. 'like_count': int,
  929. },
  930. },
  931. {
  932. 'note': 'Non-bypassable age-gated video',
  933. 'url': 'https://youtube.com/watch?v=Cr381pDsSsA',
  934. 'only_matching': True,
  935. },
  936. {
  937. 'note': 'Age-gated video only available with authentication (not via embed workaround)',
  938. 'url': 'XgnwCQzjau8',
  939. 'only_matching': True,
  940. 'skip': '''This video has been removed for violating YouTube's Community Guidelines''',
  941. },
  942. # video_info is None (https://github.com/ytdl-org/youtube-dl/issues/4421)
  943. # YouTube Red ad is not captured for creator
  944. {
  945. 'url': '__2ABJjxzNo',
  946. 'info_dict': {
  947. 'id': '__2ABJjxzNo',
  948. 'ext': 'mp4',
  949. 'duration': 266,
  950. 'upload_date': '20100430',
  951. 'uploader_id': '@deadmau5',
  952. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@deadmau5',
  953. 'creator': 'deadmau5',
  954. 'description': 'md5:6cbcd3a92ce1bc676fc4d6ab4ace2336',
  955. 'uploader': 'deadmau5',
  956. 'title': 'Deadmau5 - Some Chords (HD)',
  957. 'alt_title': 'Some Chords',
  958. },
  959. 'expected_warnings': [
  960. 'DASH manifest missing',
  961. ],
  962. },
  963. # Olympics (https://github.com/ytdl-org/youtube-dl/issues/4431)
  964. {
  965. 'url': 'lqQg6PlCWgI',
  966. 'info_dict': {
  967. 'id': 'lqQg6PlCWgI',
  968. 'ext': 'mp4',
  969. 'title': 'Hockey - Women - GER-AUS - London 2012 Olympic Games',
  970. 'description': r're:(?s)(?:.+\s)?HO09 - Women - GER-AUS - Hockey - 31 July 2012 - London 2012 Olympic Games\s*',
  971. 'duration': 6085,
  972. 'upload_date': '20150827',
  973. 'uploader_id': '@Olympics',
  974. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@Olympics',
  975. 'uploader': r're:Olympics?',
  976. 'age_limit': 0,
  977. 'thumbnail': 'https://i.ytimg.com/vi/lqQg6PlCWgI/maxresdefault.jpg',
  978. 'categories': ['Sports'],
  979. 'tags': ['Hockey', '2012-07-31', '31 July 2012', 'Riverbank Arena', 'Session', 'Olympics', 'Olympic Games', 'London 2012', '2012 Summer Olympics', 'Summer Games'],
  980. 'channel': 'Olympics',
  981. 'channel_url': 'https://www.youtube.com/channel/UCTl3QQTvqHFjurroKxexy2Q',
  982. 'channel_id': 'UCTl3QQTvqHFjurroKxexy2Q',
  983. 'view_count': int,
  984. 'like_count': int,
  985. },
  986. },
  987. # Non-square pixels
  988. {
  989. 'url': 'https://www.youtube.com/watch?v=_b-2C3KPAM0',
  990. 'info_dict': {
  991. 'id': '_b-2C3KPAM0',
  992. 'ext': 'mp4',
  993. 'stretched_ratio': 16 / 9.,
  994. 'duration': 85,
  995. 'upload_date': '20110310',
  996. 'uploader_id': '@AllenMeow',
  997. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@AllenMeow',
  998. 'description': 'made by Wacom from Korea | 字幕&加油添醋 by TY\'s Allen | 感謝heylisa00cavey1001同學熱情提供梗及翻譯',
  999. 'uploader': '孫ᄋᄅ',
  1000. 'title': '[A-made] 變態妍字幕版 太妍 我就是這樣的人',
  1001. },
  1002. },
  1003. # url_encoded_fmt_stream_map is empty string
  1004. {
  1005. 'url': 'qEJwOuvDf7I',
  1006. 'info_dict': {
  1007. 'id': 'qEJwOuvDf7I',
  1008. 'ext': 'webm',
  1009. 'title': 'Обсуждение судебной практики по выборам 14 сентября 2014 года в Санкт-Петербурге',
  1010. 'description': '',
  1011. 'upload_date': '20150404',
  1012. 'uploader_id': 'spbelect',
  1013. 'uploader': 'Наблюдатели Петербурга',
  1014. },
  1015. 'params': {
  1016. 'skip_download': 'requires avconv',
  1017. },
  1018. 'skip': 'This live event has ended.',
  1019. },
  1020. # Extraction from multiple DASH manifests (https://github.com/ytdl-org/youtube-dl/pull/6097)
  1021. {
  1022. 'url': 'https://www.youtube.com/watch?v=FIl7x6_3R5Y',
  1023. 'info_dict': {
  1024. 'id': 'FIl7x6_3R5Y',
  1025. 'ext': 'webm',
  1026. 'title': 'md5:7b81415841e02ecd4313668cde88737a',
  1027. 'description': 'md5:116377fd2963b81ec4ce64b542173306',
  1028. 'duration': 220,
  1029. 'upload_date': '20150625',
  1030. 'uploader_id': 'dorappi2000',
  1031. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/dorappi2000',
  1032. 'uploader': 'dorappi2000',
  1033. 'formats': 'mincount:31',
  1034. },
  1035. 'skip': 'not actual any more',
  1036. },
  1037. # DASH manifest with segment_list
  1038. {
  1039. 'url': 'https://www.youtube.com/embed/CsmdDsKjzN8',
  1040. 'md5': '8ce563a1d667b599d21064e982ab9e31',
  1041. 'info_dict': {
  1042. 'id': 'CsmdDsKjzN8',
  1043. 'ext': 'mp4',
  1044. 'upload_date': '20150501', # According to '<meta itemprop="datePublished"', but in other places it's 20150510
  1045. 'uploader': 'Airtek',
  1046. 'description': 'Retransmisión en directo de la XVIII media maratón de Zaragoza.',
  1047. 'uploader_id': 'UCzTzUmjXxxacNnL8I3m4LnQ',
  1048. 'title': 'Retransmisión XVIII Media maratón Zaragoza 2015',
  1049. },
  1050. 'params': {
  1051. 'youtube_include_dash_manifest': True,
  1052. 'format': '135', # bestvideo
  1053. },
  1054. 'skip': 'This live event has ended.',
  1055. },
  1056. {
  1057. # Multifeed videos (multiple cameras), URL is for Main Camera
  1058. 'url': 'https://www.youtube.com/watch?v=jvGDaLqkpTg',
  1059. 'info_dict': {
  1060. 'id': 'jvGDaLqkpTg',
  1061. 'title': 'Tom Clancy Free Weekend Rainbow Whatever',
  1062. 'description': 'md5:e03b909557865076822aa169218d6a5d',
  1063. },
  1064. 'playlist': [{
  1065. 'info_dict': {
  1066. 'id': 'jvGDaLqkpTg',
  1067. 'ext': 'mp4',
  1068. 'title': 'Tom Clancy Free Weekend Rainbow Whatever (Main Camera)',
  1069. 'description': 'md5:e03b909557865076822aa169218d6a5d',
  1070. 'duration': 10643,
  1071. 'upload_date': '20161111',
  1072. 'uploader': 'Team PGP',
  1073. 'uploader_id': 'UChORY56LMMETTuGjXaJXvLg',
  1074. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UChORY56LMMETTuGjXaJXvLg',
  1075. },
  1076. }, {
  1077. 'info_dict': {
  1078. 'id': '3AKt1R1aDnw',
  1079. 'ext': 'mp4',
  1080. 'title': 'Tom Clancy Free Weekend Rainbow Whatever (Camera 2)',
  1081. 'description': 'md5:e03b909557865076822aa169218d6a5d',
  1082. 'duration': 10991,
  1083. 'upload_date': '20161111',
  1084. 'uploader': 'Team PGP',
  1085. 'uploader_id': 'UChORY56LMMETTuGjXaJXvLg',
  1086. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UChORY56LMMETTuGjXaJXvLg',
  1087. },
  1088. }, {
  1089. 'info_dict': {
  1090. 'id': 'RtAMM00gpVc',
  1091. 'ext': 'mp4',
  1092. 'title': 'Tom Clancy Free Weekend Rainbow Whatever (Camera 3)',
  1093. 'description': 'md5:e03b909557865076822aa169218d6a5d',
  1094. 'duration': 10995,
  1095. 'upload_date': '20161111',
  1096. 'uploader': 'Team PGP',
  1097. 'uploader_id': 'UChORY56LMMETTuGjXaJXvLg',
  1098. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UChORY56LMMETTuGjXaJXvLg',
  1099. },
  1100. }, {
  1101. 'info_dict': {
  1102. 'id': '6N2fdlP3C5U',
  1103. 'ext': 'mp4',
  1104. 'title': 'Tom Clancy Free Weekend Rainbow Whatever (Camera 4)',
  1105. 'description': 'md5:e03b909557865076822aa169218d6a5d',
  1106. 'duration': 10990,
  1107. 'upload_date': '20161111',
  1108. 'uploader': 'Team PGP',
  1109. 'uploader_id': 'UChORY56LMMETTuGjXaJXvLg',
  1110. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UChORY56LMMETTuGjXaJXvLg',
  1111. },
  1112. }],
  1113. 'params': {
  1114. 'skip_download': True,
  1115. },
  1116. 'skip': 'Not multifeed any more',
  1117. },
  1118. {
  1119. # Multifeed video with comma in title (see https://github.com/ytdl-org/youtube-dl/issues/8536)
  1120. 'url': 'https://www.youtube.com/watch?v=gVfLd0zydlo',
  1121. 'info_dict': {
  1122. 'id': 'gVfLd0zydlo',
  1123. 'title': 'DevConf.cz 2016 Day 2 Workshops 1 14:00 - 15:30',
  1124. },
  1125. 'playlist_count': 2,
  1126. 'skip': 'Not multifeed any more',
  1127. },
  1128. {
  1129. 'url': 'https://vid.plus/FlRa-iH7PGw',
  1130. 'only_matching': True,
  1131. },
  1132. {
  1133. 'url': 'https://zwearz.com/watch/9lWxNJF-ufM/electra-woman-dyna-girl-official-trailer-grace-helbig.html',
  1134. 'only_matching': True,
  1135. },
  1136. {
  1137. # Title with JS-like syntax "};" (see https://github.com/ytdl-org/youtube-dl/issues/7468)
  1138. # Also tests cut-off URL expansion in video description (see
  1139. # https://github.com/ytdl-org/youtube-dl/issues/1892,
  1140. # https://github.com/ytdl-org/youtube-dl/issues/8164)
  1141. 'url': 'https://www.youtube.com/watch?v=lsguqyKfVQg',
  1142. 'info_dict': {
  1143. 'id': 'lsguqyKfVQg',
  1144. 'ext': 'mp4',
  1145. 'title': '{dark walk}; Loki/AC/Dishonored; collab w/Elflover21',
  1146. 'alt_title': 'Dark Walk',
  1147. 'description': 'md5:8085699c11dc3f597ce0410b0dcbb34a',
  1148. 'duration': 133,
  1149. 'upload_date': '20151119',
  1150. 'uploader_id': '@IronSoulElf',
  1151. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@IronSoulElf',
  1152. 'uploader': 'IronSoulElf',
  1153. 'creator': r're:Todd Haberman[;,]\s+Daniel Law Heath and Aaron Kaplan',
  1154. 'track': 'Dark Walk',
  1155. 'artist': r're:Todd Haberman[;,]\s+Daniel Law Heath and Aaron Kaplan',
  1156. 'album': 'Position Music - Production Music Vol. 143 - Dark Walk',
  1157. },
  1158. 'params': {
  1159. 'skip_download': True,
  1160. },
  1161. },
  1162. {
  1163. # Tags with '};' (see https://github.com/ytdl-org/youtube-dl/issues/7468)
  1164. 'url': 'https://www.youtube.com/watch?v=Ms7iBXnlUO8',
  1165. 'only_matching': True,
  1166. },
  1167. {
  1168. # Video with yt:stretch=17:0
  1169. 'url': 'https://www.youtube.com/watch?v=Q39EVAstoRM',
  1170. 'info_dict': {
  1171. 'id': 'Q39EVAstoRM',
  1172. 'ext': 'mp4',
  1173. 'title': 'Clash Of Clans#14 Dicas De Ataque Para CV 4',
  1174. 'description': 'md5:ee18a25c350637c8faff806845bddee9',
  1175. 'upload_date': '20151107',
  1176. 'uploader_id': 'UCCr7TALkRbo3EtFzETQF1LA',
  1177. 'uploader': 'CH GAMER DROID',
  1178. },
  1179. 'params': {
  1180. 'skip_download': True,
  1181. },
  1182. 'skip': 'This video does not exist.',
  1183. },
  1184. {
  1185. # Video with incomplete 'yt:stretch=16:'
  1186. 'url': 'https://www.youtube.com/watch?v=FRhJzUSJbGI',
  1187. 'only_matching': True,
  1188. },
  1189. {
  1190. # Video licensed under Creative Commons
  1191. 'url': 'https://www.youtube.com/watch?v=M4gD1WSo5mA',
  1192. 'info_dict': {
  1193. 'id': 'M4gD1WSo5mA',
  1194. 'ext': 'mp4',
  1195. 'title': 'md5:e41008789470fc2533a3252216f1c1d1',
  1196. 'description': 'md5:a677553cf0840649b731a3024aeff4cc',
  1197. 'duration': 721,
  1198. 'upload_date': '20150127',
  1199. 'uploader_id': '@BKCHarvard',
  1200. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@BKCHarvard',
  1201. 'uploader': 'The Berkman Klein Center for Internet & Society',
  1202. 'license': 'Creative Commons Attribution license (reuse allowed)',
  1203. },
  1204. 'params': {
  1205. 'skip_download': True,
  1206. },
  1207. },
  1208. {
  1209. # Channel-like uploader_url
  1210. 'url': 'https://www.youtube.com/watch?v=eQcmzGIKrzg',
  1211. 'info_dict': {
  1212. 'id': 'eQcmzGIKrzg',
  1213. 'ext': 'mp4',
  1214. 'title': 'Democratic Socialism and Foreign Policy | Bernie Sanders',
  1215. 'description': 'md5:13a2503d7b5904ef4b223aa101628f39',
  1216. 'duration': 4060,
  1217. 'upload_date': '20151119',
  1218. 'uploader': 'Bernie Sanders',
  1219. 'uploader_id': '@BernieSanders',
  1220. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@BernieSanders',
  1221. 'license': 'Creative Commons Attribution license (reuse allowed)',
  1222. },
  1223. 'params': {
  1224. 'skip_download': True,
  1225. },
  1226. },
  1227. {
  1228. 'url': 'https://www.youtube.com/watch?feature=player_embedded&amp;amp;v=V36LpHqtcDY',
  1229. 'only_matching': True,
  1230. },
  1231. {
  1232. # YouTube Red paid video (https://github.com/ytdl-org/youtube-dl/issues/10059)
  1233. 'url': 'https://www.youtube.com/watch?v=i1Ko8UG-Tdo',
  1234. 'only_matching': True,
  1235. },
  1236. {
  1237. # Rental video preview
  1238. 'url': 'https://www.youtube.com/watch?v=yYr8q0y5Jfg',
  1239. 'info_dict': {
  1240. 'id': 'uGpuVWrhIzE',
  1241. 'ext': 'mp4',
  1242. 'title': 'Piku - Trailer',
  1243. 'description': 'md5:c36bd60c3fd6f1954086c083c72092eb',
  1244. 'upload_date': '20150811',
  1245. 'uploader': 'FlixMatrix',
  1246. 'uploader_id': 'FlixMatrixKaravan',
  1247. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/FlixMatrixKaravan',
  1248. 'license': 'Standard YouTube License',
  1249. },
  1250. 'params': {
  1251. 'skip_download': True,
  1252. },
  1253. 'skip': 'This video is not available.',
  1254. },
  1255. {
  1256. # YouTube Red video with episode data
  1257. 'url': 'https://www.youtube.com/watch?v=iqKdEhx-dD4',
  1258. 'info_dict': {
  1259. 'id': 'iqKdEhx-dD4',
  1260. 'ext': 'mp4',
  1261. 'title': 'Isolation - Mind Field (Ep 1)',
  1262. 'description': 'md5:f540112edec5d09fc8cc752d3d4ba3cd',
  1263. 'duration': 2085,
  1264. 'upload_date': '20170118',
  1265. 'uploader': 'Vsauce',
  1266. 'uploader_id': '@Vsauce',
  1267. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@Vsauce',
  1268. 'series': 'Mind Field',
  1269. 'season_number': 1,
  1270. 'episode_number': 1,
  1271. },
  1272. 'params': {
  1273. 'skip_download': True,
  1274. },
  1275. 'expected_warnings': [
  1276. 'Skipping DASH manifest',
  1277. ],
  1278. },
  1279. {
  1280. # The following content has been identified by the YouTube community
  1281. # as inappropriate or offensive to some audiences.
  1282. 'url': 'https://www.youtube.com/watch?v=6SJNVb0GnPI',
  1283. 'info_dict': {
  1284. 'id': '6SJNVb0GnPI',
  1285. 'ext': 'mp4',
  1286. 'title': 'Race Differences in Intelligence',
  1287. 'description': 'md5:5d161533167390427a1f8ee89a1fc6f1',
  1288. 'duration': 965,
  1289. 'upload_date': '20140124',
  1290. 'uploader': 'New Century Foundation',
  1291. 'uploader_id': 'UCEJYpZGqgUob0zVVEaLhvVg',
  1292. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UCEJYpZGqgUob0zVVEaLhvVg',
  1293. },
  1294. 'params': {
  1295. 'skip_download': True,
  1296. },
  1297. 'skip': 'This video has been removed for violating YouTube\'s policy on hate speech.',
  1298. },
  1299. {
  1300. # itag 212
  1301. 'url': '1t24XAntNCY',
  1302. 'only_matching': True,
  1303. },
  1304. {
  1305. # geo restricted to JP
  1306. 'url': 'sJL6WA-aGkQ',
  1307. 'only_matching': True,
  1308. },
  1309. {
  1310. 'url': 'https://invidio.us/watch?v=BaW_jenozKc',
  1311. 'only_matching': True,
  1312. },
  1313. {
  1314. 'url': 'https://redirect.invidious.io/watch?v=BaW_jenozKc',
  1315. 'only_matching': True,
  1316. },
  1317. {
  1318. # from https://nitter.pussthecat.org/YouTube/status/1360363141947944964#m
  1319. 'url': 'https://redirect.invidious.io/Yh0AhrY9GjA',
  1320. 'only_matching': True,
  1321. },
  1322. {
  1323. # DRM protected
  1324. 'url': 'https://www.youtube.com/watch?v=s7_qI6_mIXc',
  1325. 'only_matching': True,
  1326. },
  1327. {
  1328. # Video with unsupported adaptive stream type formats
  1329. 'url': 'https://www.youtube.com/watch?v=Z4Vy8R84T1U',
  1330. 'info_dict': {
  1331. 'id': 'Z4Vy8R84T1U',
  1332. 'ext': 'mp4',
  1333. 'title': 'saman SMAN 53 Jakarta(Sancety) opening COFFEE4th at SMAN 53 Jakarta',
  1334. 'description': 'md5:d41d8cd98f00b204e9800998ecf8427e',
  1335. 'duration': 433,
  1336. 'upload_date': '20130923',
  1337. 'uploader': 'Amelia Putri Harwita',
  1338. 'uploader_id': 'UCpOxM49HJxmC1qCalXyB3_Q',
  1339. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UCpOxM49HJxmC1qCalXyB3_Q',
  1340. 'formats': 'maxcount:10',
  1341. },
  1342. 'params': {
  1343. 'skip_download': True,
  1344. 'youtube_include_dash_manifest': False,
  1345. },
  1346. 'skip': 'not actual any more',
  1347. },
  1348. {
  1349. # Youtube Music Auto-generated description
  1350. 'url': 'https://music.youtube.com/watch?v=MgNrAu2pzNs',
  1351. 'info_dict': {
  1352. 'id': 'MgNrAu2pzNs',
  1353. 'ext': 'mp4',
  1354. 'title': 'Voyeur Girl',
  1355. 'description': 'md5:7ae382a65843d6df2685993e90a8628f',
  1356. 'upload_date': '20190312',
  1357. 'uploader': 'Stephen - Topic',
  1358. 'uploader_id': 'UC-pWHpBjdGG69N9mM2auIAA',
  1359. 'artist': 'Stephen',
  1360. 'track': 'Voyeur Girl',
  1361. 'album': 'it\'s too much love to know my dear',
  1362. 'release_date': '20190313',
  1363. 'release_year': 2019,
  1364. },
  1365. 'params': {
  1366. 'skip_download': True,
  1367. },
  1368. },
  1369. {
  1370. 'url': 'https://www.youtubekids.com/watch?v=3b8nCWDgZ6Q',
  1371. 'only_matching': True,
  1372. },
  1373. {
  1374. # invalid -> valid video id redirection
  1375. 'url': 'DJztXj2GPfl',
  1376. 'info_dict': {
  1377. 'id': 'DJztXj2GPfk',
  1378. 'ext': 'mp4',
  1379. 'title': 'Panjabi MC - Mundian To Bach Ke (The Dictator Soundtrack)',
  1380. 'description': 'md5:bf577a41da97918e94fa9798d9228825',
  1381. 'upload_date': '20090125',
  1382. 'uploader': 'Prochorowka',
  1383. 'uploader_id': 'Prochorowka',
  1384. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/Prochorowka',
  1385. 'artist': 'Panjabi MC',
  1386. 'track': 'Beware of the Boys (Mundian to Bach Ke) - Motivo Hi-Lectro Remix',
  1387. 'album': 'Beware of the Boys (Mundian To Bach Ke)',
  1388. },
  1389. 'params': {
  1390. 'skip_download': True,
  1391. },
  1392. 'skip': 'Video unavailable',
  1393. },
  1394. {
  1395. # empty description results in an empty string
  1396. 'url': 'https://www.youtube.com/watch?v=x41yOUIvK2k',
  1397. 'info_dict': {
  1398. 'id': 'x41yOUIvK2k',
  1399. 'ext': 'mp4',
  1400. 'title': 'IMG 3456',
  1401. 'description': '',
  1402. 'upload_date': '20170613',
  1403. 'uploader': "l'Or Vert asbl",
  1404. 'uploader_id': '@ElevageOrVert',
  1405. },
  1406. 'params': {
  1407. 'skip_download': True,
  1408. },
  1409. },
  1410. {
  1411. # with '};' inside yt initial data (see [1])
  1412. # see [2] for an example with '};' inside ytInitialPlayerResponse
  1413. # 1. https://github.com/ytdl-org/youtube-dl/issues/27093
  1414. # 2. https://github.com/ytdl-org/youtube-dl/issues/27216
  1415. 'url': 'https://www.youtube.com/watch?v=CHqg6qOn4no',
  1416. 'info_dict': {
  1417. 'id': 'CHqg6qOn4no',
  1418. 'ext': 'mp4',
  1419. 'title': 'Part 77 Sort a list of simple types in c#',
  1420. 'description': 'md5:b8746fa52e10cdbf47997903f13b20dc',
  1421. 'upload_date': '20130831',
  1422. 'uploader': 'kudvenkat',
  1423. 'uploader_id': '@Csharp-video-tutorialsBlogspot',
  1424. },
  1425. 'params': {
  1426. 'skip_download': True,
  1427. },
  1428. },
  1429. {
  1430. # another example of '};' in ytInitialData
  1431. 'url': 'https://www.youtube.com/watch?v=gVfgbahppCY',
  1432. 'only_matching': True,
  1433. },
  1434. {
  1435. 'url': 'https://www.youtube.com/watch_popup?v=63RmMXCd_bQ',
  1436. 'only_matching': True,
  1437. },
  1438. {
  1439. # https://github.com/ytdl-org/youtube-dl/pull/28094
  1440. 'url': 'OtqTfy26tG0',
  1441. 'info_dict': {
  1442. 'id': 'OtqTfy26tG0',
  1443. 'ext': 'mp4',
  1444. 'title': 'Burn Out',
  1445. 'description': 'md5:8d07b84dcbcbfb34bc12a56d968b6131',
  1446. 'upload_date': '20141120',
  1447. 'uploader': 'The Cinematic Orchestra - Topic',
  1448. 'uploader_id': 'UCIzsJBIyo8hhpFm1NK0uLgw',
  1449. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UCIzsJBIyo8hhpFm1NK0uLgw',
  1450. 'artist': 'The Cinematic Orchestra',
  1451. 'track': 'Burn Out',
  1452. 'album': 'Every Day',
  1453. 'release_data': None,
  1454. 'release_year': None,
  1455. },
  1456. 'params': {
  1457. 'skip_download': True,
  1458. },
  1459. },
  1460. {
  1461. # controversial video, only works with bpctr when authenticated with cookies
  1462. 'url': 'https://www.youtube.com/watch?v=nGC3D_FkCmg',
  1463. 'only_matching': True,
  1464. },
  1465. {
  1466. # restricted location, https://github.com/ytdl-org/youtube-dl/issues/28685
  1467. 'url': 'cBvYw8_A0vQ',
  1468. 'info_dict': {
  1469. 'id': 'cBvYw8_A0vQ',
  1470. 'ext': 'mp4',
  1471. 'title': '4K Ueno Okachimachi Street Scenes 上野御徒町歩き',
  1472. 'description': 'md5:ea770e474b7cd6722b4c95b833c03630',
  1473. 'upload_date': '20201120',
  1474. 'uploader': 'Walk around Japan',
  1475. 'uploader_id': '@walkaroundjapan7124',
  1476. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@walkaroundjapan7124',
  1477. },
  1478. 'params': {
  1479. 'skip_download': True,
  1480. },
  1481. },
  1482. {
  1483. # YT 'Shorts'
  1484. 'url': 'https://youtube.com/shorts/4L2J27mJ3Dc',
  1485. 'info_dict': {
  1486. 'id': '4L2J27mJ3Dc',
  1487. 'ext': 'mp4',
  1488. 'title': 'Midwest Squid Game #Shorts',
  1489. 'description': 'md5:976512b8a29269b93bbd8a61edc45a6d',
  1490. 'upload_date': '20211025',
  1491. 'uploader': 'Charlie Berens',
  1492. 'uploader_id': '@CharlieBerens',
  1493. },
  1494. 'params': {
  1495. 'skip_download': True,
  1496. },
  1497. },
  1498. ]
  1499. _formats = {
  1500. '5': {'ext': 'flv', 'width': 400, 'height': 240, 'acodec': 'mp3', 'abr': 64, 'vcodec': 'h263'},
  1501. '6': {'ext': 'flv', 'width': 450, 'height': 270, 'acodec': 'mp3', 'abr': 64, 'vcodec': 'h263'},
  1502. '13': {'ext': '3gp', 'acodec': 'aac', 'vcodec': 'mp4v'},
  1503. '17': {'ext': '3gp', 'width': 176, 'height': 144, 'acodec': 'aac', 'abr': 24, 'vcodec': 'mp4v'},
  1504. '18': {'ext': 'mp4', 'width': 640, 'height': 360, 'acodec': 'aac', 'abr': 96, 'vcodec': 'h264'},
  1505. '22': {'ext': 'mp4', 'width': 1280, 'height': 720, 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264'},
  1506. '34': {'ext': 'flv', 'width': 640, 'height': 360, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
  1507. '35': {'ext': 'flv', 'width': 854, 'height': 480, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
  1508. # itag 36 videos are either 320x180 (BaW_jenozKc) or 320x240 (__2ABJjxzNo), abr varies as well
  1509. '36': {'ext': '3gp', 'width': 320, 'acodec': 'aac', 'vcodec': 'mp4v'},
  1510. '37': {'ext': 'mp4', 'width': 1920, 'height': 1080, 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264'},
  1511. '38': {'ext': 'mp4', 'width': 4096, 'height': 3072, 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264'},
  1512. '43': {'ext': 'webm', 'width': 640, 'height': 360, 'acodec': 'vorbis', 'abr': 128, 'vcodec': 'vp8'},
  1513. '44': {'ext': 'webm', 'width': 854, 'height': 480, 'acodec': 'vorbis', 'abr': 128, 'vcodec': 'vp8'},
  1514. '45': {'ext': 'webm', 'width': 1280, 'height': 720, 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8'},
  1515. '46': {'ext': 'webm', 'width': 1920, 'height': 1080, 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8'},
  1516. '59': {'ext': 'mp4', 'width': 854, 'height': 480, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
  1517. '78': {'ext': 'mp4', 'width': 854, 'height': 480, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
  1518. # 3D videos
  1519. '82': {'ext': 'mp4', 'height': 360, 'format_note': '3D', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -20},
  1520. '83': {'ext': 'mp4', 'height': 480, 'format_note': '3D', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -20},
  1521. '84': {'ext': 'mp4', 'height': 720, 'format_note': '3D', 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264', 'preference': -20},
  1522. '85': {'ext': 'mp4', 'height': 1080, 'format_note': '3D', 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264', 'preference': -20},
  1523. '100': {'ext': 'webm', 'height': 360, 'format_note': '3D', 'acodec': 'vorbis', 'abr': 128, 'vcodec': 'vp8', 'preference': -20},
  1524. '101': {'ext': 'webm', 'height': 480, 'format_note': '3D', 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8', 'preference': -20},
  1525. '102': {'ext': 'webm', 'height': 720, 'format_note': '3D', 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8', 'preference': -20},
  1526. # Apple HTTP Live Streaming
  1527. '91': {'ext': 'mp4', 'height': 144, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 48, 'vcodec': 'h264', 'preference': -10},
  1528. '92': {'ext': 'mp4', 'height': 240, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 48, 'vcodec': 'h264', 'preference': -10},
  1529. '93': {'ext': 'mp4', 'height': 360, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -10},
  1530. '94': {'ext': 'mp4', 'height': 480, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -10},
  1531. '95': {'ext': 'mp4', 'height': 720, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 256, 'vcodec': 'h264', 'preference': -10},
  1532. '96': {'ext': 'mp4', 'height': 1080, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 256, 'vcodec': 'h264', 'preference': -10},
  1533. '132': {'ext': 'mp4', 'height': 240, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 48, 'vcodec': 'h264', 'preference': -10},
  1534. '151': {'ext': 'mp4', 'height': 72, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 24, 'vcodec': 'h264', 'preference': -10},
  1535. # DASH mp4 video
  1536. '133': {'ext': 'mp4', 'height': 240, 'format_note': 'DASH video', 'vcodec': 'h264'},
  1537. '134': {'ext': 'mp4', 'height': 360, 'format_note': 'DASH video', 'vcodec': 'h264'},
  1538. '135': {'ext': 'mp4', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'h264'},
  1539. '136': {'ext': 'mp4', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'h264'},
  1540. '137': {'ext': 'mp4', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'h264'},
  1541. '138': {'ext': 'mp4', 'format_note': 'DASH video', 'vcodec': 'h264'}, # Height can vary (https://github.com/ytdl-org/youtube-dl/issues/4559)
  1542. '160': {'ext': 'mp4', 'height': 144, 'format_note': 'DASH video', 'vcodec': 'h264'},
  1543. '212': {'ext': 'mp4', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'h264'},
  1544. '264': {'ext': 'mp4', 'height': 1440, 'format_note': 'DASH video', 'vcodec': 'h264'},
  1545. '298': {'ext': 'mp4', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'h264', 'fps': 60},
  1546. '299': {'ext': 'mp4', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'h264', 'fps': 60},
  1547. '266': {'ext': 'mp4', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'h264'},
  1548. # Dash mp4 audio
  1549. '139': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'abr': 48, 'container': 'm4a_dash'},
  1550. '140': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'abr': 128, 'container': 'm4a_dash'},
  1551. '141': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'abr': 256, 'container': 'm4a_dash'},
  1552. '256': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'container': 'm4a_dash'},
  1553. '258': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'container': 'm4a_dash'},
  1554. '325': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'dtse', 'container': 'm4a_dash'},
  1555. '328': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'ec-3', 'container': 'm4a_dash'},
  1556. # Dash webm
  1557. '167': {'ext': 'webm', 'height': 360, 'width': 640, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
  1558. '168': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
  1559. '169': {'ext': 'webm', 'height': 720, 'width': 1280, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
  1560. '170': {'ext': 'webm', 'height': 1080, 'width': 1920, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
  1561. '218': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
  1562. '219': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
  1563. '278': {'ext': 'webm', 'height': 144, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp9'},
  1564. '242': {'ext': 'webm', 'height': 240, 'format_note': 'DASH video', 'vcodec': 'vp9'},
  1565. '243': {'ext': 'webm', 'height': 360, 'format_note': 'DASH video', 'vcodec': 'vp9'},
  1566. '244': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'vp9'},
  1567. '245': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'vp9'},
  1568. '246': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'vp9'},
  1569. '247': {'ext': 'webm', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'vp9'},
  1570. '248': {'ext': 'webm', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'vp9'},
  1571. '271': {'ext': 'webm', 'height': 1440, 'format_note': 'DASH video', 'vcodec': 'vp9'},
  1572. # itag 272 videos are either 3840x2160 (e.g. RtoitU2A-3E) or 7680x4320 (sLprVF6d7Ug)
  1573. '272': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'vp9'},
  1574. '302': {'ext': 'webm', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60},
  1575. '303': {'ext': 'webm', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60},
  1576. '308': {'ext': 'webm', 'height': 1440, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60},
  1577. '313': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'vp9'},
  1578. '315': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60},
  1579. # Dash webm audio
  1580. '171': {'ext': 'webm', 'acodec': 'vorbis', 'format_note': 'DASH audio', 'abr': 128},
  1581. '172': {'ext': 'webm', 'acodec': 'vorbis', 'format_note': 'DASH audio', 'abr': 256},
  1582. # Dash webm audio with opus inside
  1583. '249': {'ext': 'webm', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 50},
  1584. '250': {'ext': 'webm', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 70},
  1585. '251': {'ext': 'webm', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 160},
  1586. # RTMP (unnamed)
  1587. '_rtmp': {'protocol': 'rtmp'},
  1588. # av01 video only formats sometimes served with "unknown" codecs
  1589. '394': {'acodec': 'none', 'vcodec': 'av01.0.00M.08'},
  1590. '395': {'acodec': 'none', 'vcodec': 'av01.0.00M.08'},
  1591. '396': {'acodec': 'none', 'vcodec': 'av01.0.01M.08'},
  1592. '397': {'acodec': 'none', 'vcodec': 'av01.0.04M.08'},
  1593. '398': {'acodec': 'none', 'vcodec': 'av01.0.05M.08'},
  1594. '399': {'acodec': 'none', 'vcodec': 'av01.0.08M.08'},
  1595. }
  1596. _PLAYER_JS_VARIANT_MAP = (
  1597. ('main', 'player_ias.vflset/en_US/base.js'),
  1598. ('tcc', 'player_ias_tcc.vflset/en_US/base.js'),
  1599. ('tce', 'player_ias_tce.vflset/en_US/base.js'),
  1600. ('es5', 'player_es5.vflset/en_US/base.js'),
  1601. ('es6', 'player_es6.vflset/en_US/base.js'),
  1602. ('tv', 'tv-player-ias.vflset/tv-player-ias.js'),
  1603. ('tv_es6', 'tv-player-es6.vflset/tv-player-es6.js'),
  1604. ('phone', 'player-plasma-ias-phone-en_US.vflset/base.js'),
  1605. ('tablet', 'player-plasma-ias-tablet-en_US.vflset/base.js'),
  1606. )
  1607. @classmethod
  1608. def suitable(cls, url):
  1609. if parse_qs(url).get('list', [None])[0]:
  1610. return False
  1611. return super(YoutubeIE, cls).suitable(url)
  1612. def __init__(self, *args, **kwargs):
  1613. super(YoutubeIE, self).__init__(*args, **kwargs)
  1614. self._code_cache = {}
  1615. self._player_cache = {}
  1616. def _get_player_js_version(self):
  1617. player_js_version = self.get_param('youtube_player_js_version')
  1618. if player_js_version:
  1619. sts_hash = self._search_regex(
  1620. ('^actual$(^)?(^)?', r'^([0-9]{5,})@([0-9a-f]{8,})$'),
  1621. player_js_version, 'player_js_version', group=(1, 2), default=None)
  1622. if sts_hash:
  1623. return sts_hash
  1624. self.report_warning(
  1625. 'Invalid player JS version "{0}" specified. '
  1626. 'It should be "{1}" or in the format of {2}'.format(
  1627. player_js_version, 'actual', 'SignatureTimeStamp@Hash'), only_once=True)
  1628. return None, None
  1629. # *ytcfgs, webpage=None
  1630. def _extract_player_url(self, *ytcfgs, **kw_webpage):
  1631. if ytcfgs and not isinstance(ytcfgs[0], dict):
  1632. webpage = kw_webpage.get('webpage') or ytcfgs[0]
  1633. if webpage:
  1634. player_url = self._search_regex(
  1635. r'"(?:PLAYER_JS_URL|jsUrl)"\s*:\s*"([^"]+)"',
  1636. webpage or '', 'player URL', fatal=False)
  1637. if player_url:
  1638. ytcfgs = ytcfgs + ({'PLAYER_JS_URL': player_url},)
  1639. player_url = traverse_obj(
  1640. ytcfgs, (Ellipsis, 'PLAYER_JS_URL'), (Ellipsis, 'WEB_PLAYER_CONTEXT_CONFIGS', Ellipsis, 'jsUrl'),
  1641. get_all=False, expected_type=self._yt_urljoin)
  1642. requested_js_variant = self.get_param('youtube_player_js_variant')
  1643. variant_js = next(
  1644. (v for k, v in self._PLAYER_JS_VARIANT_MAP if k == requested_js_variant),
  1645. None)
  1646. if variant_js:
  1647. player_id_override = self._get_player_js_version()[1]
  1648. player_id = player_id_override or self._extract_player_info(player_url)
  1649. original_url = player_url
  1650. player_url = self._yt_urljoin(
  1651. '/s/player/{0}/{1}'.format(player_id, variant_js))
  1652. if original_url != player_url:
  1653. self.write_debug(
  1654. 'Forcing "{0}" player JS variant for player {1}\n'
  1655. ' original url = {2}'.format(
  1656. requested_js_variant, player_id, original_url),
  1657. only_once=True)
  1658. elif requested_js_variant != 'actual':
  1659. self.report_warning(
  1660. 'Invalid player JS variant name "{0}" requested. '
  1661. 'Valid choices are: {1}'.format(
  1662. requested_js_variant, ','.join(k for k, _ in self._PLAYER_JS_VARIANT_MAP)),
  1663. only_once=True)
  1664. return player_url
  1665. def _download_player_url(self, video_id, fatal=False):
  1666. res = self._download_webpage(
  1667. 'https://www.youtube.com/iframe_api',
  1668. note='Downloading iframe API JS', video_id=video_id, fatal=fatal)
  1669. player_version = self._search_regex(
  1670. r'player\\?/([0-9a-fA-F]{8})\\?/', res or '', 'player version', fatal=fatal,
  1671. default=NO_DEFAULT if res else None) or None
  1672. return player_version and 'https://www.youtube.com/s/player/{0}/player_ias.vflset/en_US/base.js'.format(player_version)
  1673. def _signature_cache_id(self, example_sig):
  1674. """ Return a string representation of a signature """
  1675. return '.'.join(compat_str(len(part)) for part in example_sig.split('.'))
  1676. def _extract_player_info(self, player_url):
  1677. try:
  1678. return self._search_regex(
  1679. self._PLAYER_INFO_RE, player_url, 'player info', group='id')
  1680. except ExtractorError as e:
  1681. raise ExtractorError(
  1682. 'Cannot identify player %r' % (player_url,), cause=e)
  1683. def _player_js_cache_key(self, player_url, extra_id=None, _cache={}):
  1684. if player_url not in _cache:
  1685. player_id = self._extract_player_info(player_url)
  1686. player_path = remove_start(
  1687. compat_urllib_parse.urlparse(player_url).path,
  1688. '/s/player/{0}/'.format(player_id))
  1689. variant = next((k for k, v in self._PLAYER_JS_VARIANT_MAP
  1690. if v == player_path), None)
  1691. if not variant:
  1692. variant = next(
  1693. (k for k, v in self._PLAYER_JS_VARIANT_MAP
  1694. if re.match(re.escape(v).replace('en_US', r'\w+') + '$', player_path)),
  1695. None)
  1696. if not variant:
  1697. self.write_debug(
  1698. 'Unable to determine player JS variant\n'
  1699. ' player = {0}'.format(player_url), only_once=True)
  1700. variant = re.sub(r'[^a-zA-Z0-9]', '_', remove_end(player_path, '.js'))
  1701. _cache[player_url] = join_nonempty(player_id, variant)
  1702. if extra_id:
  1703. extra_id = '-'.join((_cache[player_url], extra_id))
  1704. assert os.path.basename(extra_id) == extra_id
  1705. return extra_id
  1706. return _cache[player_url]
  1707. def _load_player(self, video_id, player_url, fatal=True):
  1708. player_js_key = self._player_js_cache_key(player_url)
  1709. if player_js_key not in self._code_cache:
  1710. code = self._download_webpage(
  1711. player_url, video_id, fatal=fatal,
  1712. note='Downloading player {0}'.format(player_js_key),
  1713. errnote='Download of {0} failed'.format(player_url))
  1714. if code:
  1715. self._code_cache[player_js_key] = code
  1716. return self._code_cache.get(player_js_key)
  1717. def _load_player_data_from_cache(self, name, player_url, extra_id=None):
  1718. cache_id = ('youtube-{0}'.format(name), self._player_js_cache_key(player_url, extra_id))
  1719. data = self._player_cache.get(cache_id)
  1720. if data:
  1721. return data
  1722. data = self.cache.load(*cache_id, min_ver='2025.04.07')
  1723. if data:
  1724. self._player_cache[cache_id] = data
  1725. return data
  1726. def _store_player_data_to_cache(self, name, player_url, data, extra_id=None):
  1727. cache_id = ('youtube-{0}'.format(name), self._player_js_cache_key(player_url, extra_id))
  1728. if cache_id not in self._player_cache:
  1729. self.cache.store(cache_id[0], cache_id[1], data)
  1730. self._player_cache[cache_id] = data
  1731. def _remove_player_data_from_cache(self, name, player_url, extra_id=None):
  1732. cache_id = ('youtube-{0}'.format(name), self._player_js_cache_key(player_url, extra_id))
  1733. if cache_id in self._player_cache:
  1734. self.cache.clear(*cache_id)
  1735. self._player_cache.pop(cache_id, None)
  1736. def _extract_signature_function(self, video_id, player_url, example_sig):
  1737. # player_id = self._extract_player_info(player_url)
  1738. # Read from filesystem cache
  1739. extra_id = self._signature_cache_id(example_sig)
  1740. self.write_debug('Extracting signature function {0}-{1}'.format(player_url, extra_id))
  1741. cache_spec, code = self._load_player_data_from_cache(
  1742. 'sigfuncs', player_url, extra_id=extra_id), None
  1743. if not cache_spec:
  1744. code = self._load_player(video_id, player_url)
  1745. if code:
  1746. res = self._parse_sig_js(code)
  1747. test_string = ''.join(map(compat_chr, range(len(example_sig))))
  1748. cache_spec = [ord(c) for c in res(test_string)]
  1749. self._store_player_data_to_cache(
  1750. 'sigfuncs', player_url, cache_spec, extra_id=extra_id)
  1751. else:
  1752. self.report_warning(
  1753. 'Failed to compute signature function {0}-{1}'.format(
  1754. player_url, extra_id))
  1755. return lambda s: ''.join(s[i] for i in cache_spec)
  1756. def _print_sig_code(self, func, example_sig):
  1757. if not self.get_param('youtube_print_sig_code'):
  1758. return
  1759. def gen_sig_code(idxs):
  1760. def _genslice(start, end, step):
  1761. starts = '' if start == 0 else str(start)
  1762. ends = (':%d' % (end + step)) if end + step >= 0 else ':'
  1763. steps = '' if step == 1 else (':%d' % step)
  1764. return 's[{0}{1}{2}]'.format(starts, ends, steps)
  1765. step = None
  1766. # Quelch pyflakes warnings - start will be set when step is set
  1767. start = '(Never used)'
  1768. for i, prev in zip(idxs[1:], idxs[:-1]):
  1769. if step is not None:
  1770. if i - prev == step:
  1771. continue
  1772. yield _genslice(start, prev, step)
  1773. step = None
  1774. continue
  1775. if i - prev in [-1, 1]:
  1776. step = i - prev
  1777. start = prev
  1778. continue
  1779. else:
  1780. yield 's[%d]' % prev
  1781. if step is None:
  1782. yield 's[%d]' % i
  1783. else:
  1784. yield _genslice(start, i, step)
  1785. test_string = ''.join(map(compat_chr, range(len(example_sig))))
  1786. cache_res = func(test_string)
  1787. cache_spec = [ord(c) for c in cache_res]
  1788. expr_code = ' + '.join(gen_sig_code(cache_spec))
  1789. signature_id_tuple = '(%s)' % (
  1790. ', '.join(compat_str(len(p)) for p in example_sig.split('.')))
  1791. code = ('if tuple(len(p) for p in s.split(\'.\')) == %s:\n'
  1792. ' return %s\n') % (signature_id_tuple, expr_code)
  1793. self.to_screen('Extracted signature function:\n' + code)
  1794. def _extract_sig_fn(self, jsi, funcname):
  1795. var_ay = self._search_regex(
  1796. r'''(?x)
  1797. (?:\*/|\{|\n|^)\s*(?:'[^']+'\s*;\s*)
  1798. (var\s*[\w$]+\s*=\s*(?:
  1799. ('|")(?:\\\2|(?!\2).)+\2\s*\.\s*split\(\s*('|")\W+\3\s*\)|
  1800. \[\s*(?:('|")(?:\\\4|(?!\4).)*\4\s*(?:(?=\])|,\s*))+\]
  1801. ))(?=\s*[,;])
  1802. ''', jsi.code, 'useful values', default='')
  1803. sig_fn = jsi.extract_function_code(funcname)
  1804. if var_ay:
  1805. sig_fn = (sig_fn[0], ';\n'.join((var_ay, sig_fn[1])))
  1806. return sig_fn
  1807. def _parse_sig_js(self, jscode):
  1808. # Examples where `sig` is funcname:
  1809. # sig=function(a){a=a.split(""); ... ;return a.join("")};
  1810. # ;c&&(c=sig(decodeURIComponent(c)),a.set(b,encodeURIComponent(c)));return a};
  1811. # {var l=f,m=h.sp,n=sig(decodeURIComponent(h.s));l.set(m,encodeURIComponent(n))}
  1812. # sig=function(J){J=J.split(""); ... ;return J.join("")};
  1813. # ;N&&(N=sig(decodeURIComponent(N)),J.set(R,encodeURIComponent(N)));return J};
  1814. # {var H=u,k=f.sp,v=sig(decodeURIComponent(f.s));H.set(k,encodeURIComponent(v))}
  1815. funcname = self._search_regex(
  1816. (r'\b(?P<var>[\w$]+)&&\((?P=var)=(?P<sig>[\w$]{2,})\(decodeURIComponent\((?P=var)\)\)',
  1817. r'(?P<sig>[\w$]+)\s*=\s*function\(\s*(?P<arg>[\w$]+)\s*\)\s*{\s*(?P=arg)\s*=\s*(?P=arg)\.split\(\s*""\s*\)\s*;\s*[^}]+;\s*return\s+(?P=arg)\.join\(\s*""\s*\)',
  1818. r'(?:\b|[^\w$])(?P<sig>[\w$]{2,})\s*=\s*function\(\s*a\s*\)\s*{\s*a\s*=\s*a\.split\(\s*""\s*\)(?:;[\w$]{2}\.[\w$]{2}\(a,\d+\))?',
  1819. # Old patterns
  1820. r'\b[cs]\s*&&\s*[adf]\.set\([^,]+\s*,\s*encodeURIComponent\s*\(\s*(?P<sig>[\w$]+)\(',
  1821. r'\b[\w]+\s*&&\s*[\w]+\.set\([^,]+\s*,\s*encodeURIComponent\s*\(\s*(?P<sig>[\w$]+)\(',
  1822. r'\bm=(?P<sig>[\w$]{2,})\(decodeURIComponent\(h\.s\)\)',
  1823. # Obsolete patterns
  1824. r'("|\')signature\1\s*,\s*(?P<sig>[\w$]+)\(',
  1825. r'\.sig\|\|(?P<sig>[\w$]+)\(',
  1826. r'yt\.akamaized\.net/\)\s*\|\|\s*.*?\s*[cs]\s*&&\s*[adf]\.set\([^,]+\s*,\s*(?:encodeURIComponent\s*\()?\s*(?P<sig>[\w$]+)\(',
  1827. r'\b[cs]\s*&&\s*[adf]\.set\([^,]+\s*,\s*(?P<sig>[\w$]+)\(',
  1828. r'\bc\s*&&\s*[\w]+\.set\([^,]+\s*,\s*\([^)]*\)\s*\(\s*(?P<sig>[\w$]+)\('),
  1829. jscode, 'Initial JS player signature function name', group='sig')
  1830. jsi = JSInterpreter(jscode)
  1831. initial_function = self._extract_sig_fn(jsi, funcname)
  1832. func = jsi.extract_function_from_code(*initial_function)
  1833. return lambda s: func([s])
  1834. def _cached(self, func, *cache_id):
  1835. def inner(*args, **kwargs):
  1836. if cache_id not in self._player_cache:
  1837. try:
  1838. self._player_cache[cache_id] = func(*args, **kwargs)
  1839. except ExtractorError as e:
  1840. self._player_cache[cache_id] = e
  1841. except Exception as e:
  1842. self._player_cache[cache_id] = ExtractorError(traceback.format_exc(), cause=e)
  1843. ret = self._player_cache[cache_id]
  1844. if isinstance(ret, Exception):
  1845. raise ret
  1846. return ret
  1847. return inner
  1848. def _decrypt_signature(self, s, video_id, player_url):
  1849. """Turn the encrypted s field into a working signature"""
  1850. extract_sig = self._cached(
  1851. self._extract_signature_function, 'sig', player_url, self._signature_cache_id(s))
  1852. func = extract_sig(video_id, player_url, s)
  1853. self._print_sig_code(func, s)
  1854. return func(s)
  1855. # from yt-dlp
  1856. # See also:
  1857. # 1. https://github.com/ytdl-org/youtube-dl/issues/29326#issuecomment-894619419
  1858. # 2. https://code.videolan.org/videolan/vlc/-/blob/4fb284e5af69aa9ac2100ccbdd3b88debec9987f/share/lua/playlist/youtube.lua#L116
  1859. # 3. https://github.com/ytdl-org/youtube-dl/issues/30097#issuecomment-950157377
  1860. def _decrypt_nsig(self, n, video_id, player_url):
  1861. """Turn the encrypted n field into a working signature"""
  1862. if player_url is None:
  1863. raise ExtractorError('Cannot decrypt nsig without player_url')
  1864. try:
  1865. jsi, player_id, func_code = self._extract_n_function_code(video_id, player_url)
  1866. except ExtractorError as e:
  1867. raise ExtractorError('Unable to extract nsig function code', cause=e)
  1868. if self.get_param('youtube_print_sig_code'):
  1869. self.to_screen('Extracted nsig function from {0}:\n{1}\n'.format(
  1870. player_id, func_code[1]))
  1871. try:
  1872. extract_nsig = self._cached(self._extract_n_function_from_code, 'nsig func', player_url)
  1873. ret = extract_nsig(jsi, func_code)(n)
  1874. except JSInterpreter.Exception as e:
  1875. self.report_warning(
  1876. '%s (%s %s)' % (
  1877. 'Unable to decode n-parameter: expect download to be blocked or throttled',
  1878. error_to_compat_str(e),
  1879. traceback.format_exc()),
  1880. video_id=video_id)
  1881. return
  1882. self.write_debug('Decrypted nsig {0} => {1}'.format(n, ret))
  1883. return ret
  1884. def _extract_n_function_name(self, jscode):
  1885. func_name, idx = None, None
  1886. def generic_n_function_search(func_name=None):
  1887. return self._search_regex(
  1888. r'''(?xs)
  1889. (?:(?<=[^\w$])|^) # instead of \b, which ignores $
  1890. (?P<name>%s)\s*=\s*function\((?!\d)[a-zA-Z\d_$]+\)
  1891. \s*\{(?:(?!};).)+?(?:
  1892. ["']enhanced_except_ |
  1893. return\s*(?P<q>"|')[a-zA-Z\d-]+_w8_(?P=q)\s*\+\s*[\w$]+
  1894. )
  1895. ''' % (func_name or r'(?!\d)[a-zA-Z\d_$]+',), jscode,
  1896. 'Initial JS player n function name', group='name',
  1897. default=None if func_name else NO_DEFAULT)
  1898. # these special cases are redundant and probably obsolete (2025-04):
  1899. # they make the tests run ~10% faster without fallback warnings
  1900. r"""
  1901. func_name, idx = self._search_regex(
  1902. # (y=NuD(),Mw(k),q=k.Z[y]||null)&&(q=narray[idx](q),k.set(y,q),k.V||NuD(''))}};
  1903. # (R="nn"[+J.Z],mW(J),N=J.K[R]||null)&&(N=narray[idx](N),J.set(R,N))}};
  1904. # or: (b=String.fromCharCode(110),c=a.get(b))&&c=narray[idx](c)
  1905. # or: (b="nn"[+a.D],c=a.get(b))&&(c=narray[idx](c)
  1906. # or: (PL(a),b=a.j.n||null)&&(b=narray[idx](b)
  1907. # or: (b="nn"[+a.D],vL(a),c=a.j[b]||null)&&(c=narray[idx](c),a.set(b,c),narray.length||nfunc("")
  1908. # old: (b=a.get("n"))&&(b=narray[idx](b)(?P<c>[a-z])\s*=\s*[a-z]\s*
  1909. # older: (b=a.get("n"))&&(b=nfunc(b)
  1910. r'''(?x)
  1911. # (expr, ...,
  1912. \((?:(?:\s*[\w$]+\s*=)?(?:[\w$"+\.\s(\[]+(?:[)\]]\s*)?),)*
  1913. # b=...
  1914. (?P<b>[\w$]+)\s*=\s*(?!(?P=b)[^\w$])[\w$]+\s*(?:(?:
  1915. \.\s*[\w$]+ |
  1916. \[\s*[\w$]+\s*\] |
  1917. \.\s*get\s*\(\s*[\w$"]+\s*\)
  1918. )\s*){,2}(?:\s*\|\|\s*null(?=\s*\)))?\s*
  1919. \)\s*&&\s*\( # ...)&&(
  1920. # b = nfunc, b = narray[idx]
  1921. (?P=b)\s*=\s*(?P<nfunc>[\w$]+)\s*
  1922. (?:\[\s*(?P<idx>[\w$]+)\s*\]\s*)?
  1923. # (...)
  1924. \(\s*[\w$]+\s*\)
  1925. ''', jscode, 'Initial JS player n function name', group=('nfunc', 'idx'),
  1926. default=(None, None))
  1927. """
  1928. if not func_name:
  1929. # nfunc=function(x){...}|function nfunc(x); ...
  1930. # ... var y=[nfunc]|y[idx]=nfunc);
  1931. # obvious REs hang, so use a two-stage tactic
  1932. for m in re.finditer(r'''(?x)
  1933. [\n;]var\s(?:(?:(?!,).)+,|\s)*?(?!\d)[\w$]+(?:\[(?P<idx>\d+)\])?\s*=\s*
  1934. (?(idx)|\[\s*)(?P<nfunc>(?!\d)[\w$]+)(?(idx)|\s*\])
  1935. \s*?[;\n]
  1936. ''', jscode):
  1937. fn = self._search_regex(
  1938. r'[;,]\s*(function\s+)?({0})(?(1)|\s*=\s*function)\s*\((?!\d)[\w$]+\)\s*\{1}(?!\s*return\s)'.format(
  1939. re.escape(m.group('nfunc')), '{'),
  1940. jscode, 'Initial JS player n function name (2)', group=2, default=None)
  1941. if fn:
  1942. func_name = fn
  1943. idx = m.group('idx')
  1944. if generic_n_function_search(func_name):
  1945. # don't look any further
  1946. break
  1947. # thx bashonly: yt-dlp/yt-dlp/pull/10611
  1948. if not func_name:
  1949. self.report_warning('Falling back to generic n function search', only_once=True)
  1950. return generic_n_function_search()
  1951. if not idx:
  1952. return func_name
  1953. return self._search_json(
  1954. r'(?<![\w-])var\s(?:(?:(?!,).)+,|\s)*?{0}\s*='.format(re.escape(func_name)), jscode,
  1955. 'Initial JS player n function list ({0}.{1})'.format(func_name, idx),
  1956. func_name, contains_pattern=r'\[.+\]', end_pattern='[,;]',
  1957. transform_source=js_to_json)[int(idx)]
  1958. def _extract_n_function_code(self, video_id, player_url):
  1959. player_id = self._extract_player_info(player_url)
  1960. func_code = self._load_player_data_from_cache('nsig', player_url)
  1961. jscode = func_code or self._load_player(video_id, player_url)
  1962. jsi = JSInterpreter(jscode)
  1963. if func_code:
  1964. return jsi, player_id, func_code
  1965. return self._extract_n_function_code_jsi(video_id, jsi, player_id, player_url)
  1966. def _extract_n_function_code_jsi(self, video_id, jsi, player_id=None, player_url=None):
  1967. func_name = self._extract_n_function_name(jsi.code)
  1968. func_code = self._extract_sig_fn(jsi, func_name)
  1969. if player_url:
  1970. self._store_player_data_to_cache('nsig', player_url, func_code)
  1971. return jsi, player_id, func_code
  1972. def _extract_n_function_from_code(self, jsi, func_code):
  1973. func = jsi.extract_function_from_code(*func_code)
  1974. def extract_nsig(s):
  1975. try:
  1976. ret = func([s], kwargs={'_ytdl_do_not_return': s})
  1977. except JSInterpreter.Exception:
  1978. raise
  1979. except Exception as e:
  1980. raise JSInterpreter.Exception(traceback.format_exc(), cause=e)
  1981. if ret.startswith('enhanced_except_') or ret.endswith(s):
  1982. raise JSInterpreter.Exception('Signature function returned an exception')
  1983. return ret
  1984. return extract_nsig
  1985. def _unthrottle_format_urls(self, video_id, player_url, *formats):
  1986. def decrypt_nsig(n):
  1987. return self._cached(self._decrypt_nsig, 'nsig', n, player_url)
  1988. for fmt in formats:
  1989. n_param = parse_qs(fmt['url']).get('n')
  1990. if not n_param:
  1991. continue
  1992. n_param = n_param[-1]
  1993. n_response = decrypt_nsig(n_param)(n_param, video_id, player_url)
  1994. if n_response is None:
  1995. # give up and forget cached data if descrambling failed
  1996. self._remove_player_data_from_cache('nsig', player_url)
  1997. break
  1998. fmt['url'] = update_url_query(fmt['url'], {'n': n_response})
  1999. # from yt-dlp, with tweaks
  2000. def _extract_signature_timestamp(self, video_id, player_url, ytcfg=None, fatal=False):
  2001. """
  2002. Extract signatureTimestamp (sts)
  2003. Required to tell API what sig/player version is in use.
  2004. """
  2005. sts = traverse_obj(
  2006. (self._get_player_js_version(), ytcfg),
  2007. (0, 0),
  2008. (1, 'STS'),
  2009. expected_type=int_or_none)
  2010. if sts:
  2011. return sts
  2012. if not player_url:
  2013. error_msg = 'Cannot extract signature timestamp without player url'
  2014. if fatal:
  2015. raise ExtractorError(error_msg)
  2016. self.report_warning(error_msg)
  2017. return None
  2018. sts = self._load_player_data_from_cache('sts', player_url)
  2019. if sts:
  2020. return sts
  2021. # Attempt to extract from player
  2022. code = self._load_player(video_id, player_url, fatal=fatal)
  2023. sts = int_or_none(self._search_regex(
  2024. r'(?:signatureTimestamp|sts)\s*:\s*(?P<sts>[0-9]{5})', code or '',
  2025. 'JS player signature timestamp', group='sts', fatal=fatal))
  2026. if sts:
  2027. self._store_player_data_to_cache('sts', player_url, sts)
  2028. return sts
  2029. def _mark_watched(self, video_id, player_response):
  2030. # cpn generation algorithm is reverse engineered from base.js.
  2031. # In fact it works even with dummy cpn.
  2032. CPN_ALPHABET = string.ascii_letters + string.digits + '-_'
  2033. cpn = ''.join(CPN_ALPHABET[random.randint(0, 256) & 63] for _ in range(16))
  2034. for is_full, key in enumerate(('videostatsPlaybackUrl', 'videostatsWatchtimeUrl')):
  2035. label = 'fully ' if is_full > 0 else ''
  2036. playback_url = traverse_obj(player_response, (
  2037. 'playbackTracking'. key, 'baseUrl', T(url_or_none)))
  2038. if not playback_url:
  2039. self.report_warning('Unable to mark {0}watched'.format(label))
  2040. continue
  2041. # more consistent results setting it to right before the end
  2042. qs = parse_qs(playback_url)
  2043. video_length = '{0}'.format(float((qs.get('len') or ['1.5'])[0]) - 1)
  2044. playback_url = update_url_query(
  2045. playback_url, {
  2046. 'ver': '2',
  2047. 'cpn': cpn,
  2048. 'cmt': video_length,
  2049. 'el': 'detailpage', # otherwise defaults to "shorts"
  2050. })
  2051. self._download_webpage(
  2052. playback_url, video_id, 'Marking {0}watched'.format(label),
  2053. 'Unable to mark watched', fatal=False)
  2054. @staticmethod
  2055. def _extract_urls(webpage):
  2056. # Embedded YouTube player
  2057. entries = [
  2058. unescapeHTML(mobj.group('url'))
  2059. for mobj in re.finditer(r'''(?x)
  2060. (?:
  2061. <iframe[^>]+?src=|
  2062. data-video-url=|
  2063. <embed[^>]+?src=|
  2064. embedSWF\(?:\s*|
  2065. <object[^>]+data=|
  2066. new\s+SWFObject\(
  2067. )
  2068. (["\'])
  2069. (?P<url>(?:https?:)?//(?:www\.)?youtube(?:-nocookie)?\.com/
  2070. (?:embed|v|p)/[0-9A-Za-z_-]{11}.*?)
  2071. \1''', webpage)]
  2072. # lazyYT YouTube embed
  2073. entries.extend(list(map(
  2074. unescapeHTML,
  2075. re.findall(r'class="lazyYT" data-youtube-id="([^"]+)"', webpage))))
  2076. # Wordpress "YouTube Video Importer" plugin
  2077. matches = re.findall(r'''(?x)<div[^>]+
  2078. class=(?P<q1>[\'"])[^\'"]*\byvii_single_video_player\b[^\'"]*(?P=q1)[^>]+
  2079. data-video_id=(?P<q2>[\'"])([^\'"]+)(?P=q2)''', webpage)
  2080. entries.extend(m[-1] for m in matches)
  2081. return entries
  2082. @staticmethod
  2083. def _extract_url(webpage):
  2084. urls = YoutubeIE._extract_urls(webpage)
  2085. return urls[0] if urls else None
  2086. @classmethod
  2087. def extract_id(cls, url):
  2088. mobj = re.match(cls._VALID_URL, url, re.VERBOSE)
  2089. if mobj is None:
  2090. raise ExtractorError('Invalid URL: %s' % url)
  2091. return mobj.group(2)
  2092. @staticmethod
  2093. def _extract_chapters_from_json(data, video_id, duration):
  2094. chapters_list = try_get(
  2095. data,
  2096. lambda x: x['playerOverlays']
  2097. ['playerOverlayRenderer']
  2098. ['decoratedPlayerBarRenderer']
  2099. ['decoratedPlayerBarRenderer']
  2100. ['playerBar']
  2101. ['chapteredPlayerBarRenderer']
  2102. ['chapters'],
  2103. list)
  2104. if not chapters_list:
  2105. return
  2106. def chapter_time(chapter):
  2107. return float_or_none(
  2108. try_get(
  2109. chapter,
  2110. lambda x: x['chapterRenderer']['timeRangeStartMillis'],
  2111. int),
  2112. scale=1000)
  2113. chapters = []
  2114. for next_num, chapter in enumerate(chapters_list, start=1):
  2115. start_time = chapter_time(chapter)
  2116. if start_time is None:
  2117. continue
  2118. end_time = (chapter_time(chapters_list[next_num])
  2119. if next_num < len(chapters_list) else duration)
  2120. if end_time is None:
  2121. continue
  2122. title = try_get(
  2123. chapter, lambda x: x['chapterRenderer']['title']['simpleText'],
  2124. compat_str)
  2125. chapters.append({
  2126. 'start_time': start_time,
  2127. 'end_time': end_time,
  2128. 'title': title,
  2129. })
  2130. return chapters
  2131. def _extract_yt_initial_variable(self, webpage, regex, video_id, name):
  2132. return self._parse_json(self._search_regex(
  2133. (r'%s\s*%s' % (regex, self._YT_INITIAL_BOUNDARY_RE),
  2134. regex), webpage, name, default='{}'), video_id, fatal=False)
  2135. def _get_preroll_length(self, ad_slot_lists):
  2136. def parse_instream_ad_renderer(instream_renderer):
  2137. for skippable, path in (
  2138. ('', ('skipOffsetMilliseconds', T(int))),
  2139. ('non-', ('playerVars', T(compat_parse_qs),
  2140. 'length_seconds', -1, T(int_or_none(invscale=1000))))):
  2141. length_ms = traverse_obj(instream_renderer, path)
  2142. if length_ms is not None:
  2143. self.write_debug('Detected a %ds %sskippable ad' % (
  2144. length_ms // 1000, skippable))
  2145. break
  2146. return length_ms
  2147. for slot_renderer in traverse_obj(ad_slot_lists, ('adSlots', Ellipsis, 'adSlotRenderer', T(dict))):
  2148. if traverse_obj(slot_renderer, ('adSlotMetadata', 'triggerEvent')) != 'SLOT_TRIGGER_EVENT_BEFORE_CONTENT':
  2149. continue
  2150. rendering_content = traverse_obj(slot_renderer, (
  2151. 'fulfillmentContent', 'fulfilledLayout', 'playerBytesAdLayoutRenderer',
  2152. 'renderingContent', 'instreamVideoAdRenderer', T(dict)))
  2153. length_ms = parse_instream_ad_renderer(rendering_content)
  2154. if length_ms is not None:
  2155. return length_ms
  2156. times = traverse_obj(rendering_content, ((
  2157. ('playerBytesSequentialLayoutRenderer', 'sequentialLayouts'),
  2158. None), any, Ellipsis, 'playerBytesAdLayoutRenderer',
  2159. 'renderingContent', 'instreamVideoAdRenderer',
  2160. T(parse_instream_ad_renderer)))
  2161. if times:
  2162. return sum(times)
  2163. return 0
  2164. def _is_premium_subscriber(self, initial_data):
  2165. if not self.is_authenticated or not initial_data:
  2166. return False
  2167. tlr = traverse_obj(
  2168. initial_data, ('topbar', 'desktopTopbarRenderer', 'logo', 'topbarLogoRenderer'))
  2169. return (
  2170. traverse_obj(tlr, ('iconImage', 'iconType')) == 'YOUTUBE_PREMIUM_LOGO'
  2171. or 'premium' in (self._get_text(tlr, 'tooltipText') or '').lower()
  2172. )
  2173. def _real_extract(self, url):
  2174. url, smuggled_data = unsmuggle_url(url, {})
  2175. video_id = self._match_id(url)
  2176. base_url = self.http_scheme() + '//www.youtube.com/'
  2177. webpage_url = base_url + 'watch?v=' + video_id
  2178. ua = traverse_obj(self._INNERTUBE_CLIENTS, (
  2179. 'web', 'INNERTUBE_CONTEXT', 'client', 'userAgent'))
  2180. headers = {'User-Agent': ua} if ua else None
  2181. webpage = self._download_webpage(
  2182. webpage_url + '&bpctr=9999999999&has_verified=1', video_id,
  2183. headers=headers, fatal=False)
  2184. player_response = None
  2185. player_url = None
  2186. if webpage:
  2187. player_response = self._extract_yt_initial_variable(
  2188. webpage, self._YT_INITIAL_PLAYER_RESPONSE_RE,
  2189. video_id, 'initial player response')
  2190. is_live = traverse_obj(player_response, ('videoDetails', 'isLive'))
  2191. fetched_timestamp = None
  2192. if False and not player_response:
  2193. player_response = self._call_api(
  2194. 'player', {'videoId': video_id}, video_id)
  2195. if True or not player_response:
  2196. origin = 'https://www.youtube.com'
  2197. pb_context = {'html5Preference': 'HTML5_PREF_WANTS'}
  2198. player_url = self._extract_player_url(webpage)
  2199. ytcfg = self._extract_ytcfg(video_id, webpage or '')
  2200. sts = self._extract_signature_timestamp(video_id, player_url, ytcfg)
  2201. if sts:
  2202. pb_context['signatureTimestamp'] = sts
  2203. auth = self._generate_sapisidhash_header(origin)
  2204. client_names = []
  2205. if auth or self._is_premium_subscriber(player_response):
  2206. client_names = traverse_obj(self._INNERTUBE_CLIENTS, (
  2207. T(dict_items), lambda _, k_v: k_v[0] == 'web_safari', 0))[:1]
  2208. if not client_names:
  2209. client_names = traverse_obj(self._INNERTUBE_CLIENTS, (
  2210. T(dict_items), lambda _, k_v: not (
  2211. k_v[1].get('REQUIRE_PO_TOKEN')
  2212. or (bool(k_v[1].get('WITH_COOKIES', auth)) ^ bool(auth))
  2213. ), 0))[:1]
  2214. if 'web' not in client_names:
  2215. # only live HLS webpage links will download: ignore playability
  2216. player_response = filter_dict(
  2217. player_response or {},
  2218. lambda k, _: k != 'playabilityStatus')
  2219. headers = {
  2220. 'Sec-Fetch-Mode': 'navigate',
  2221. 'Origin': origin,
  2222. 'X-Goog-Visitor-Id': self._extract_visitor_data(ytcfg) or '',
  2223. }
  2224. if auth is not None:
  2225. headers['Authorization'] = auth
  2226. headers['X-Origin'] = origin
  2227. for client in traverse_obj(self._INNERTUBE_CLIENTS, (client_names, T(dict))):
  2228. query = {
  2229. 'playbackContext': {
  2230. 'contentPlaybackContext': pb_context,
  2231. },
  2232. 'contentCheckOk': True,
  2233. 'racyCheckOk': True,
  2234. 'context': {
  2235. 'client': merge_dicts(
  2236. traverse_obj(client, ('INNERTUBE_CONTEXT', 'client')), {
  2237. 'hl': 'en',
  2238. 'timeZone': 'UTC',
  2239. 'utcOffsetMinutes': 0,
  2240. }),
  2241. },
  2242. 'videoId': video_id,
  2243. }
  2244. api_headers = merge_dicts(headers, traverse_obj(client, {
  2245. 'X-YouTube-Client-Name': 'INNERTUBE_CONTEXT_CLIENT_NAME',
  2246. 'X-YouTube-Client-Version': (
  2247. 'INNERTUBE_CONTEXT', 'client', 'clientVersion'),
  2248. 'User-Agent': (
  2249. 'INNERTUBE_CONTEXT', 'client', 'userAgent'),
  2250. }) or {})
  2251. api_player_response = self._call_api(
  2252. 'player', query, video_id, fatal=False, headers=api_headers,
  2253. note=join_nonempty(
  2254. 'Downloading', traverse_obj(query, (
  2255. 'context', 'client', 'clientName')),
  2256. 'API JSON', delim=' '))
  2257. # be sure to find HLS in case of is_live
  2258. hls = traverse_obj(player_response, (
  2259. 'streamingData', 'hlsManifestUrl', T(url_or_none)))
  2260. fetched_timestamp = int(time.time())
  2261. preroll_length_ms = (
  2262. self._get_preroll_length(api_player_response)
  2263. or self._get_preroll_length(player_response))
  2264. video_details = merge_dicts(*traverse_obj(
  2265. (player_response, api_player_response),
  2266. (Ellipsis, 'videoDetails', T(dict))))
  2267. player_response.update(filter_dict(
  2268. api_player_response or {}, cndn=lambda k, _: k != 'captions'))
  2269. player_response['videoDetails'] = video_details
  2270. if hls and not traverse_obj(player_response, (
  2271. 'streamingData', 'hlsManifestUrl', T(url_or_none))):
  2272. player_response['streamingData']['hlsManifestUrl'] = hls
  2273. def is_agegated(playability):
  2274. # playability: dict
  2275. if not playability:
  2276. return False
  2277. if playability.get('desktopLegacyAgeGateReason'):
  2278. return True
  2279. reasons = traverse_obj(playability, (('status', 'reason'),))
  2280. AGE_GATE_REASONS = (
  2281. 'confirm your age', 'age-restricted', 'inappropriate', # reason
  2282. 'age_verification_required', 'age_check_required', # status
  2283. )
  2284. return any(expected in reason for expected in AGE_GATE_REASONS for reason in reasons)
  2285. def get_playability_status(response):
  2286. return try_get(response, lambda x: x['playabilityStatus'], dict) or {}
  2287. playability_status = get_playability_status(player_response)
  2288. if (is_agegated(playability_status)
  2289. and int_or_none(self._downloader.params.get('age_limit'), default=18) >= 18):
  2290. self.report_age_confirmation()
  2291. # Thanks: https://github.com/yt-dlp/yt-dlp/pull/3233
  2292. pb_context = {'html5Preference': 'HTML5_PREF_WANTS'}
  2293. # Use signatureTimestamp if available
  2294. # Thanks https://github.com/ytdl-org/youtube-dl/issues/31034#issuecomment-1160718026
  2295. player_url = self._extract_player_url(webpage)
  2296. ytcfg = self._extract_ytcfg(video_id, webpage)
  2297. sts = self._extract_signature_timestamp(video_id, player_url, ytcfg)
  2298. if sts:
  2299. pb_context['signatureTimestamp'] = sts
  2300. query = {
  2301. 'playbackContext': {'contentPlaybackContext': pb_context},
  2302. 'contentCheckOk': True,
  2303. 'racyCheckOk': True,
  2304. 'context': {
  2305. 'client': {'clientName': 'TVHTML5_SIMPLY_EMBEDDED_PLAYER', 'clientVersion': '2.0', 'hl': 'en', 'clientScreen': 'EMBED'},
  2306. 'thirdParty': {'embedUrl': 'https://google.com'},
  2307. },
  2308. 'videoId': video_id,
  2309. }
  2310. headers = {
  2311. 'X-YouTube-Client-Name': '85',
  2312. 'X-YouTube-Client-Version': '2.0',
  2313. 'Origin': 'https://www.youtube.com',
  2314. }
  2315. video_info = self._call_api('player', query, video_id, fatal=False, headers=headers)
  2316. age_gate_status = get_playability_status(video_info)
  2317. if age_gate_status.get('status') == 'OK':
  2318. player_response = video_info
  2319. playability_status = age_gate_status
  2320. trailer_video_id = try_get(
  2321. playability_status,
  2322. lambda x: x['errorScreen']['playerLegacyDesktopYpcTrailerRenderer']['trailerVideoId'],
  2323. compat_str)
  2324. if trailer_video_id:
  2325. return self.url_result(
  2326. trailer_video_id, self.ie_key(), trailer_video_id)
  2327. get_text = lambda x: self._get_text(x) or ''
  2328. search_meta = (
  2329. (lambda x: self._html_search_meta(x, webpage, default=None))
  2330. if webpage else lambda _: None)
  2331. video_details = player_response.get('videoDetails') or {}
  2332. microformat = try_get(
  2333. player_response,
  2334. lambda x: x['microformat']['playerMicroformatRenderer'],
  2335. dict) or {}
  2336. video_title = video_details.get('title') \
  2337. or get_text(microformat.get('title')) \
  2338. or search_meta(['og:title', 'twitter:title', 'title'])
  2339. video_description = video_details.get('shortDescription')
  2340. if not smuggled_data.get('force_singlefeed', False):
  2341. if not self._downloader.params.get('noplaylist'):
  2342. multifeed_metadata_list = try_get(
  2343. player_response,
  2344. lambda x: x['multicamera']['playerLegacyMulticameraRenderer']['metadataList'],
  2345. compat_str)
  2346. if multifeed_metadata_list:
  2347. entries = []
  2348. feed_ids = []
  2349. for feed in multifeed_metadata_list.split(','):
  2350. # Unquote should take place before split on comma (,) since textual
  2351. # fields may contain comma as well (see
  2352. # https://github.com/ytdl-org/youtube-dl/issues/8536)
  2353. feed_data = compat_parse_qs(
  2354. compat_urllib_parse_unquote_plus(feed))
  2355. def feed_entry(name):
  2356. return try_get(
  2357. feed_data, lambda x: x[name][0], compat_str)
  2358. feed_id = feed_entry('id')
  2359. if not feed_id:
  2360. continue
  2361. feed_title = feed_entry('title')
  2362. title = video_title
  2363. if feed_title:
  2364. title += ' (%s)' % feed_title
  2365. entries.append({
  2366. '_type': 'url_transparent',
  2367. 'ie_key': 'Youtube',
  2368. 'url': smuggle_url(
  2369. base_url + 'watch?v=' + feed_data['id'][0],
  2370. {'force_singlefeed': True}),
  2371. 'title': title,
  2372. })
  2373. feed_ids.append(feed_id)
  2374. self.to_screen(
  2375. 'Downloading multifeed video (%s) - add --no-playlist to just download video %s'
  2376. % (', '.join(feed_ids), video_id))
  2377. return self.playlist_result(
  2378. entries, video_id, video_title, video_description)
  2379. else:
  2380. self.to_screen('Downloading just video %s because of --no-playlist' % video_id)
  2381. if not player_url:
  2382. player_url = self._extract_player_url(webpage)
  2383. formats = []
  2384. itags = collections.defaultdict(set)
  2385. itag_qualities = {}
  2386. q = qualities(['tiny', 'small', 'medium', 'large', 'hd720', 'hd1080', 'hd1440', 'hd2160', 'hd2880', 'highres'])
  2387. CHUNK_SIZE = 10 << 20
  2388. is_live = video_details.get('isLive')
  2389. streaming_data = player_response.get('streamingData') or {}
  2390. streaming_formats = streaming_data.get('formats') or []
  2391. streaming_formats.extend(streaming_data.get('adaptiveFormats') or [])
  2392. def build_fragments(f):
  2393. return LazyList({
  2394. 'url': update_url_query(f['url'], {
  2395. 'range': '{0}-{1}'.format(range_start, min(range_start + CHUNK_SIZE - 1, f['filesize'])),
  2396. }),
  2397. } for range_start in range(0, f['filesize'], CHUNK_SIZE))
  2398. lower = lambda s: s.lower()
  2399. if is_live:
  2400. fetched_timestamp = None
  2401. elif fetched_timestamp is not None:
  2402. # Handle preroll waiting period
  2403. preroll_sleep = self.get_param('youtube_preroll_sleep')
  2404. preroll_sleep = min(6, int_or_none(preroll_sleep, default=preroll_length_ms / 1000))
  2405. fetched_timestamp += preroll_sleep
  2406. for fmt in streaming_formats:
  2407. if fmt.get('targetDurationSec'):
  2408. continue
  2409. itag = str_or_none(fmt.get('itag'))
  2410. audio_track = traverse_obj(fmt, ('audioTrack', T(dict))) or {}
  2411. quality = traverse_obj(fmt, ((
  2412. # The 3gp format (17) in android client has a quality of "small",
  2413. # but is actually worse than other formats
  2414. T(lambda _: 'tiny' if itag == 17 else None),
  2415. ('quality', T(lambda q: q if q and q != 'tiny' else None)),
  2416. ('audioQuality', T(lower)),
  2417. 'quality'), T(txt_or_none)), get_all=False)
  2418. if quality and itag:
  2419. itag_qualities[itag] = quality
  2420. # FORMAT_STREAM_TYPE_OTF(otf=1) requires downloading the init fragment
  2421. # (adding `&sq=0` to the URL) and parsing emsg box to determine the
  2422. # number of fragments that would subsequently be requested with (`&sq=N`)
  2423. if fmt.get('type') == 'FORMAT_STREAM_TYPE_OTF':
  2424. continue
  2425. fmt_url = fmt.get('url')
  2426. if not fmt_url:
  2427. sc = compat_parse_qs(fmt.get('signatureCipher'))
  2428. fmt_url = traverse_obj(sc, ('url', -1, T(url_or_none)))
  2429. encrypted_sig = traverse_obj(sc, ('s', -1))
  2430. if not (fmt_url and encrypted_sig):
  2431. continue
  2432. player_url = player_url or self._extract_player_url(webpage)
  2433. if not player_url:
  2434. continue
  2435. try:
  2436. fmt_url = update_url_query(fmt_url, {
  2437. traverse_obj(sc, ('sp', -1)) or 'signature':
  2438. [self._decrypt_signature(encrypted_sig, video_id, player_url)],
  2439. })
  2440. except ExtractorError as e:
  2441. self.report_warning('Signature extraction failed: Some formats may be missing',
  2442. video_id=video_id, only_once=True)
  2443. self.write_debug(error_to_compat_str(e), only_once=True)
  2444. continue
  2445. if parse_qs(fmt_url).get('n'):
  2446. # this and (we assume) all the formats here are n-scrambled
  2447. break
  2448. language_preference = (
  2449. 10 if audio_track.get('audioIsDefault')
  2450. else -10 if 'descriptive' in (traverse_obj(audio_track, ('displayName', T(lower))) or '')
  2451. else -1)
  2452. name = (
  2453. traverse_obj(fmt, ('qualityLabel', T(txt_or_none)))
  2454. or quality.replace('audio_quality_', ''))
  2455. dct = {
  2456. 'format_id': join_nonempty(itag, fmt.get('isDrc') and 'drc'),
  2457. 'url': fmt_url,
  2458. # Format 22 is likely to be damaged: see https://github.com/yt-dlp/yt-dlp/issues/3372
  2459. 'source_preference': ((-5 if itag == '22' else -1)
  2460. + (100 if 'Premium' in name else 0)),
  2461. 'quality': q(quality),
  2462. 'language': join_nonempty(audio_track.get('id', '').split('.')[0],
  2463. 'desc' if language_preference < -1 else '') or None,
  2464. 'language_preference': language_preference,
  2465. # Strictly de-prioritize 3gp formats
  2466. 'preference': -2 if itag == '17' else None,
  2467. }
  2468. if itag:
  2469. itags[itag].add(('https', dct.get('language')))
  2470. self._unthrottle_format_urls(video_id, player_url, dct)
  2471. dct.update(traverse_obj(fmt, {
  2472. 'asr': ('audioSampleRate', T(int_or_none)),
  2473. 'filesize': ('contentLength', T(int_or_none)),
  2474. 'format_note': ('qualityLabel', T(lambda x: x or quality)),
  2475. # for some formats, fps is wrongly returned as 1
  2476. 'fps': ('fps', T(int_or_none), T(lambda f: f if f > 1 else None)),
  2477. 'audio_channels': ('audioChannels', T(int_or_none)),
  2478. 'height': ('height', T(int_or_none)),
  2479. 'has_drm': ('drmFamilies', T(bool)),
  2480. 'tbr': (('averageBitrate', 'bitrate'), T(lambda t: float_or_none(t, 1000))),
  2481. 'width': ('width', T(int_or_none)),
  2482. '_duration_ms': ('approxDurationMs', T(int_or_none)),
  2483. }, get_all=False))
  2484. mime_mobj = re.match(
  2485. r'((?:[^/]+)/(?:[^;]+))(?:;\s*codecs="([^"]+)")?', fmt.get('mimeType') or '')
  2486. if mime_mobj:
  2487. dct['ext'] = mimetype2ext(mime_mobj.group(1))
  2488. dct.update(parse_codecs(mime_mobj.group(2)))
  2489. single_stream = 'none' in (dct.get(c) for c in ('acodec', 'vcodec'))
  2490. if single_stream and dct.get('ext'):
  2491. dct['container'] = dct['ext'] + '_dash'
  2492. if single_stream or itag == '17':
  2493. # avoid Youtube throttling
  2494. dct.update({
  2495. 'protocol': 'http_dash_segments',
  2496. 'fragments': build_fragments(dct),
  2497. } if dct['filesize'] else {
  2498. 'downloader_options': {'http_chunk_size': CHUNK_SIZE}, # No longer useful?
  2499. })
  2500. if fetched_timestamp:
  2501. dct['available_at'] = fetched_timestamp
  2502. formats.append(dct)
  2503. def process_manifest_format(f, proto, client_name, itag, all_formats=False):
  2504. key = (proto, f.get('language'))
  2505. if not all_formats and key in itags[itag]:
  2506. return False
  2507. itags[itag].add(key)
  2508. if itag:
  2509. f['format_id'] = (
  2510. '{0}-{1}'.format(itag, proto)
  2511. if all_formats or any(p != proto for p, _ in itags[itag])
  2512. else itag)
  2513. if f.get('source_preference') is None:
  2514. f['source_preference'] = -1
  2515. # Deprioritize since its pre-merged m3u8 formats may have lower quality audio streams
  2516. if client_name == 'web_safari' and proto == 'hls' and not is_live:
  2517. f['source_preference'] -= 1
  2518. if itag in ('616', '235'):
  2519. f['format_note'] = join_nonempty(f.get('format_note'), 'Premium', delim=' ')
  2520. f['source_preference'] += 100
  2521. f['quality'] = q(traverse_obj(f, (
  2522. 'format_id', T(lambda s: itag_qualities[s.split('-')[0]])), default=-1))
  2523. if try_call(lambda: f['fps'] <= 1):
  2524. del f['fps']
  2525. if proto == 'hls' and f.get('has_drm'):
  2526. f['has_drm'] = 'maybe'
  2527. f['source_preference'] -= 5
  2528. return True
  2529. hls_manifest_url = streaming_data.get('hlsManifestUrl')
  2530. if hls_manifest_url:
  2531. formats.extend(
  2532. f for f in self._extract_m3u8_formats(
  2533. hls_manifest_url, video_id, 'mp4',
  2534. entry_protocol='m3u8_native', live=is_live, fatal=False)
  2535. if process_manifest_format(
  2536. f, 'hls', None, self._search_regex(
  2537. r'/itag/(\d+)', f['url'], 'itag', default=None)))
  2538. if self.get_param('youtube_include_dash_manifest', True):
  2539. dash_manifest_url = streaming_data.get('dashManifestUrl')
  2540. if dash_manifest_url:
  2541. for f in self._extract_mpd_formats(
  2542. dash_manifest_url, video_id, fatal=False):
  2543. if process_manifest_format(
  2544. f, 'dash', None, f['format_id']):
  2545. f['filesize'] = traverse_obj(f, (
  2546. ('fragment_base_url', 'url'), T(lambda u: self._search_regex(
  2547. r'/clen/(\d+)', u, 'file size', default=None)),
  2548. T(int_or_none)), get_all=False)
  2549. formats.append(f)
  2550. playable_formats = [f for f in formats if not f.get('has_drm')]
  2551. if formats:
  2552. if not playable_formats:
  2553. # If there are no formats that definitely don't have DRM, all have DRM
  2554. self.report_drm(video_id)
  2555. formats[:] = playable_formats
  2556. else:
  2557. if streaming_data.get('licenseInfos'):
  2558. raise ExtractorError(
  2559. 'This video is DRM protected.', expected=True)
  2560. pemr = try_get(
  2561. playability_status,
  2562. lambda x: x['errorScreen']['playerErrorMessageRenderer'],
  2563. dict) or {}
  2564. reason = get_text(pemr.get('reason')) or playability_status.get('reason') or ''
  2565. subreason = pemr.get('subreason')
  2566. if subreason:
  2567. subreason = clean_html(get_text(subreason))
  2568. if subreason.startswith('The uploader has not made this video available in your country'):
  2569. countries = microformat.get('availableCountries')
  2570. if not countries:
  2571. regions_allowed = search_meta('regionsAllowed')
  2572. countries = regions_allowed.split(',') if regions_allowed else None
  2573. self.raise_geo_restricted(
  2574. subreason, countries)
  2575. reason += '\n' + subreason
  2576. if reason:
  2577. if 'sign in' in reason.lower():
  2578. self.raise_login_required(remove_end(reason, 'This helps protect our community. Learn more'))
  2579. elif traverse_obj(playability_status, ('errorScreen', 'playerCaptchaViewModel', T(dict))):
  2580. reason += '. YouTube is requiring a captcha challenge before playback'
  2581. raise ExtractorError(reason, expected=True)
  2582. self._sort_formats(formats)
  2583. keywords = video_details.get('keywords') or []
  2584. if not keywords and webpage:
  2585. keywords = [
  2586. unescapeHTML(m.group('content'))
  2587. for m in re.finditer(self._meta_regex('og:video:tag'), webpage)]
  2588. for keyword in keywords:
  2589. if keyword.startswith('yt:stretch='):
  2590. mobj = re.search(r'(\d+)\s*:\s*(\d+)', keyword)
  2591. if mobj:
  2592. # NB: float is intentional for forcing float division
  2593. w, h = (float(v) for v in mobj.groups())
  2594. if w > 0 and h > 0:
  2595. ratio = w / h
  2596. for f in formats:
  2597. if f.get('vcodec') != 'none':
  2598. f['stretched_ratio'] = ratio
  2599. break
  2600. thumbnails = []
  2601. for container in (video_details, microformat):
  2602. for thumbnail in try_get(
  2603. container,
  2604. lambda x: x['thumbnail']['thumbnails'], list) or []:
  2605. thumbnail_url = url_or_none(thumbnail.get('url'))
  2606. if not thumbnail_url:
  2607. continue
  2608. thumbnails.append({
  2609. 'height': int_or_none(thumbnail.get('height')),
  2610. 'url': update_url(thumbnail_url, query=None, fragment=None),
  2611. 'width': int_or_none(thumbnail.get('width')),
  2612. })
  2613. if thumbnails:
  2614. break
  2615. else:
  2616. thumbnail = search_meta(['og:image', 'twitter:image'])
  2617. if thumbnail:
  2618. thumbnails = [{'url': thumbnail}]
  2619. category = microformat.get('category') or search_meta('genre')
  2620. channel_id = self._extract_channel_id(
  2621. webpage, videodetails=video_details, metadata=microformat)
  2622. duration = int_or_none(
  2623. video_details.get('lengthSeconds')
  2624. or microformat.get('lengthSeconds')) \
  2625. or parse_duration(search_meta('duration'))
  2626. for f in formats:
  2627. # Some formats may have much smaller duration than others (possibly damaged during encoding)
  2628. # but avoid false positives with small duration differences.
  2629. # Ref: https://github.com/yt-dlp/yt-dlp/issues/2823
  2630. if try_call(lambda x: float(x.pop('_duration_ms')) / duration < 500, args=(f,)):
  2631. self.report_warning(
  2632. '{0}: Some possibly damaged formats will be deprioritized'.format(video_id), only_once=True)
  2633. # Strictly de-prioritize damaged formats
  2634. f['preference'] = -10
  2635. owner_profile_url = self._yt_urljoin(self._extract_author_var(
  2636. webpage, 'url', videodetails=video_details, metadata=microformat))
  2637. uploader = self._extract_author_var(
  2638. webpage, 'name', videodetails=video_details, metadata=microformat)
  2639. info = {
  2640. 'id': video_id,
  2641. 'title': self._live_title(video_title) if is_live else video_title,
  2642. 'formats': formats,
  2643. 'thumbnails': thumbnails,
  2644. 'description': video_description,
  2645. 'upload_date': unified_strdate(
  2646. microformat.get('uploadDate')
  2647. or search_meta('uploadDate')),
  2648. 'uploader': uploader,
  2649. 'channel_id': channel_id,
  2650. 'duration': duration,
  2651. 'view_count': int_or_none(
  2652. video_details.get('viewCount')
  2653. or microformat.get('viewCount')
  2654. or search_meta('interactionCount')),
  2655. 'average_rating': float_or_none(video_details.get('averageRating')),
  2656. 'age_limit': 18 if (
  2657. microformat.get('isFamilySafe') is False
  2658. or search_meta('isFamilyFriendly') == 'false'
  2659. or search_meta('og:restrictions:age') == '18+') else 0,
  2660. 'webpage_url': webpage_url,
  2661. 'categories': [category] if category else None,
  2662. 'tags': keywords,
  2663. 'is_live': is_live,
  2664. }
  2665. pctr = traverse_obj(
  2666. (player_response, api_player_response),
  2667. (Ellipsis, 'captions', 'playerCaptionsTracklistRenderer', T(dict)))
  2668. if pctr:
  2669. def process_language(container, base_url, lang_code, query):
  2670. lang_subs = []
  2671. for fmt in self._SUBTITLE_FORMATS:
  2672. query.update({
  2673. 'fmt': fmt,
  2674. # xosf=1 causes undesirable text position data for vtt, json3 & srv* subtitles
  2675. # See: https://github.com/yt-dlp/yt-dlp/issues/13654
  2676. 'xosf': [],
  2677. })
  2678. lang_subs.append({
  2679. 'ext': fmt,
  2680. 'url': update_url_query(base_url, query),
  2681. })
  2682. container[lang_code] = lang_subs
  2683. def process_subtitles():
  2684. subtitles = {}
  2685. for caption_track in traverse_obj(pctr, (
  2686. Ellipsis, 'captionTracks', lambda _, v: (
  2687. v.get('baseUrl') and v.get('languageCode')))):
  2688. base_url = self._yt_urljoin(caption_track['baseUrl'])
  2689. if not base_url:
  2690. continue
  2691. lang_code = caption_track['languageCode']
  2692. if caption_track.get('kind') != 'asr':
  2693. process_language(
  2694. subtitles, base_url, lang_code, {})
  2695. continue
  2696. automatic_captions = {}
  2697. process_language(
  2698. automatic_captions, base_url, lang_code, {})
  2699. for translation_language in traverse_obj(pctr, (
  2700. Ellipsis, 'translationLanguages', lambda _, v: v.get('languageCode'))):
  2701. translation_language_code = translation_language['languageCode']
  2702. process_language(
  2703. automatic_captions, base_url, translation_language_code,
  2704. {'tlang': translation_language_code})
  2705. info['automatic_captions'] = automatic_captions
  2706. info['subtitles'] = subtitles
  2707. process_subtitles()
  2708. parsed_url = compat_urllib_parse_urlparse(url)
  2709. for component in (parsed_url.fragment, parsed_url.query):
  2710. query = compat_parse_qs(component)
  2711. for k, v in query.items():
  2712. for d_k, s_ks in [('start', ('start', 't')), ('end', ('end',))]:
  2713. d_k += '_time'
  2714. if d_k not in info and k in s_ks:
  2715. info[d_k] = parse_duration(v[0])
  2716. if video_description:
  2717. # Youtube Music Auto-generated description
  2718. mobj = re.search(r'(?s)(?P<track>[^·\n]+)·(?P<artist>[^\n]+)\n+(?P<album>[^\n]+)(?:.+?℗\s*(?P<release_year>\d{4})(?!\d))?(?:.+?Released on\s*:\s*(?P<release_date>\d{4}-\d{2}-\d{2}))?(.+?\nArtist\s*:\s*(?P<clean_artist>[^\n]+))?.+\nAuto-generated by YouTube\.\s*$', video_description)
  2719. if mobj:
  2720. release_year = mobj.group('release_year')
  2721. release_date = mobj.group('release_date')
  2722. if release_date:
  2723. release_date = release_date.replace('-', '')
  2724. if not release_year:
  2725. release_year = release_date[:4]
  2726. info.update({
  2727. 'album': mobj.group('album'.strip()),
  2728. 'artist': mobj.group('clean_artist') or ', '.join(a.strip() for a in mobj.group('artist').split('·')),
  2729. 'track': mobj.group('track').strip(),
  2730. 'release_date': release_date,
  2731. 'release_year': int_or_none(release_year),
  2732. })
  2733. initial_data = None
  2734. if webpage:
  2735. initial_data = self._extract_yt_initial_variable(
  2736. webpage, self._YT_INITIAL_DATA_RE, video_id,
  2737. 'yt initial data')
  2738. if not initial_data:
  2739. initial_data = self._call_api(
  2740. 'next', {'videoId': video_id}, video_id, fatal=False)
  2741. initial_sdcr = None
  2742. if initial_data:
  2743. chapters = self._extract_chapters_from_json(
  2744. initial_data, video_id, duration)
  2745. if not chapters:
  2746. def chapter_time(mmlir):
  2747. return parse_duration(
  2748. get_text(mmlir.get('timeDescription')))
  2749. for markers in traverse_obj(initial_data, (
  2750. 'engagementPanels', Ellipsis, 'engagementPanelSectionListRenderer',
  2751. 'content', 'macroMarkersListRenderer', 'contents', T(list))):
  2752. chapters = []
  2753. for next_num, content in enumerate(markers, start=1):
  2754. mmlir = content.get('macroMarkersListItemRenderer') or {}
  2755. start_time = chapter_time(mmlir)
  2756. end_time = (traverse_obj(markers, (
  2757. next_num, 'macroMarkersListItemRenderer', T(chapter_time)))
  2758. if next_num < len(markers) else duration)
  2759. if start_time is None or end_time is None:
  2760. continue
  2761. chapters.append({
  2762. 'start_time': start_time,
  2763. 'end_time': end_time,
  2764. 'title': get_text(mmlir.get('title')),
  2765. })
  2766. if chapters:
  2767. break
  2768. if chapters:
  2769. info['chapters'] = chapters
  2770. contents = try_get(
  2771. initial_data,
  2772. lambda x: x['contents']['twoColumnWatchNextResults']['results']['results']['contents'],
  2773. list) or []
  2774. if not info['channel_id']:
  2775. channel_id = self._extract_channel_id('', renderers=contents)
  2776. if not info['uploader']:
  2777. info['uploader'] = self._extract_author_var('', 'name', renderers=contents)
  2778. if not owner_profile_url:
  2779. owner_profile_url = self._yt_urljoin(self._extract_author_var('', 'url', renderers=contents))
  2780. for content in contents:
  2781. vpir = content.get('videoPrimaryInfoRenderer')
  2782. if vpir:
  2783. stl = vpir.get('superTitleLink')
  2784. if stl:
  2785. stl = get_text(stl)
  2786. if try_get(
  2787. vpir,
  2788. lambda x: x['superTitleIcon']['iconType']) == 'LOCATION_PIN':
  2789. info['location'] = stl
  2790. else:
  2791. # •? doesn't match, but [•]? does; \xa0 = non-breaking space
  2792. mobj = re.search(r'([^\xa0\s].*?)[\xa0\s]*S(\d+)[\xa0\s]*[•]?[\xa0\s]*E(\d+)', stl)
  2793. if mobj:
  2794. info.update({
  2795. 'series': mobj.group(1),
  2796. 'season_number': int(mobj.group(2)),
  2797. 'episode_number': int(mobj.group(3)),
  2798. })
  2799. for tlb in (try_get(
  2800. vpir,
  2801. lambda x: x['videoActions']['menuRenderer']['topLevelButtons'],
  2802. list) or []):
  2803. tbr = traverse_obj(tlb, ('segmentedLikeDislikeButtonRenderer', 'likeButton', 'toggleButtonRenderer'), 'toggleButtonRenderer') or {}
  2804. for getter, regex in [(
  2805. lambda x: x['defaultText']['accessibility']['accessibilityData'],
  2806. r'(?P<count>[\d,]+)\s*(?P<type>(?:dis)?like)'), ([
  2807. lambda x: x['accessibility'],
  2808. lambda x: x['accessibilityData']['accessibilityData'],
  2809. ], r'(?P<type>(?:dis)?like) this video along with (?P<count>[\d,]+) other people')]:
  2810. label = (try_get(tbr, getter, dict) or {}).get('label')
  2811. if label:
  2812. mobj = re.match(regex, label)
  2813. if mobj:
  2814. info[mobj.group('type') + '_count'] = str_to_int(mobj.group('count'))
  2815. break
  2816. sbr_tooltip = try_get(
  2817. vpir, lambda x: x['sentimentBar']['sentimentBarRenderer']['tooltip'])
  2818. if sbr_tooltip:
  2819. # however dislike_count was hidden by YT, as if there could ever be dislikable content on YT
  2820. like_count, dislike_count = sbr_tooltip.split(' / ')
  2821. info.update({
  2822. 'like_count': str_to_int(like_count),
  2823. 'dislike_count': str_to_int(dislike_count),
  2824. })
  2825. else:
  2826. info['like_count'] = traverse_obj(vpir, (
  2827. 'videoActions', 'menuRenderer', 'topLevelButtons', Ellipsis,
  2828. 'segmentedLikeDislikeButtonViewModel', 'likeButtonViewModel', 'likeButtonViewModel',
  2829. 'toggleButtonViewModel', 'toggleButtonViewModel', 'defaultButtonViewModel',
  2830. 'buttonViewModel', (('title', ('accessibilityText', T(lambda s: s.split()), Ellipsis))), T(parse_count)),
  2831. get_all=False)
  2832. vsir = content.get('videoSecondaryInfoRenderer')
  2833. if vsir:
  2834. rows = try_get(
  2835. vsir,
  2836. lambda x: x['metadataRowContainer']['metadataRowContainerRenderer']['rows'],
  2837. list) or []
  2838. multiple_songs = False
  2839. for row in rows:
  2840. if try_get(row, lambda x: x['metadataRowRenderer']['hasDividerLine']) is True:
  2841. multiple_songs = True
  2842. break
  2843. for row in rows:
  2844. mrr = row.get('metadataRowRenderer') or {}
  2845. mrr_title = mrr.get('title')
  2846. if not mrr_title:
  2847. continue
  2848. mrr_title = get_text(mrr['title'])
  2849. mrr_contents_text = get_text(mrr['contents'][0])
  2850. if mrr_title == 'License':
  2851. info['license'] = mrr_contents_text
  2852. elif not multiple_songs:
  2853. if mrr_title == 'Album':
  2854. info['album'] = mrr_contents_text
  2855. elif mrr_title == 'Artist':
  2856. info['artist'] = mrr_contents_text
  2857. elif mrr_title == 'Song':
  2858. info['track'] = mrr_contents_text
  2859. # this is not extraction but spelunking!
  2860. initial_sdcr = traverse_obj(initial_data, (
  2861. 'engagementPanels', Ellipsis, 'engagementPanelSectionListRenderer',
  2862. 'content', 'structuredDescriptionContentRenderer', T(dict)),
  2863. get_all=False)
  2864. carousel_lockups = traverse_obj(initial_sdcr, (
  2865. 'items', Ellipsis, 'videoDescriptionMusicSectionRenderer',
  2866. 'carouselLockups', Ellipsis, T(dict))) or []
  2867. # try to reproduce logic from metadataRowContainerRenderer above (if it still is)
  2868. fields = (('ALBUM', 'album'), ('ARTIST', 'artist'), ('SONG', 'track'), ('LICENSES', 'license'))
  2869. # multiple_songs ?
  2870. if len(carousel_lockups) > 1:
  2871. fields = fields[-1:]
  2872. for info_row in traverse_obj(
  2873. carousel_lockups,
  2874. (0, 'carouselLockupRenderer', 'infoRows', Ellipsis, 'infoRowRenderer'),
  2875. expected_type=dict):
  2876. row_title = traverse_obj(info_row, ('title', 'simpleText'))
  2877. row_text = traverse_obj(info_row, 'defaultMetadata', 'expandedMetadata', expected_type=get_text)
  2878. if not row_text:
  2879. continue
  2880. for name, field in fields:
  2881. if name == row_title and not info.get(field):
  2882. info[field] = row_text
  2883. for s_k, d_k in [('artist', 'creator'), ('track', 'alt_title')]:
  2884. v = info.get(s_k)
  2885. if v:
  2886. info[d_k] = v
  2887. self.mark_watched(video_id, player_response)
  2888. # Fallbacks for missing metadata
  2889. if initial_sdcr:
  2890. if info.get('description') is None:
  2891. info['description'] = traverse_obj(initial_sdcr, (
  2892. 'items', Ellipsis, 'expandableVideoDescriptionBodyRenderer',
  2893. 'attributedDescriptionBodyText', 'content', T(compat_str)),
  2894. get_all=False)
  2895. # videoDescriptionHeaderRenderer also has publishDate/channel/handle/ucid, but not needed
  2896. if info.get('title') is None:
  2897. info['title'] = traverse_obj(
  2898. (initial_sdcr, initial_data),
  2899. (0, 'items', Ellipsis, 'videoDescriptionHeaderRenderer', T(dict)),
  2900. (1, 'playerOverlays', 'playerOverlayRenderer', 'videoDetails',
  2901. 'playerOverlayVideoDetailsRenderer', T(dict)),
  2902. expected_type=lambda x: self._get_text(x, 'title'),
  2903. get_all=False)
  2904. return merge_dicts(
  2905. info, {
  2906. 'uploader_id': self._extract_uploader_id(owner_profile_url),
  2907. 'uploader_url': owner_profile_url,
  2908. 'channel_id': channel_id,
  2909. 'channel_url': channel_id and self._yt_urljoin('/channel/' + channel_id),
  2910. 'channel': info['uploader'],
  2911. })
  2912. class YoutubeTabIE(YoutubeBaseInfoExtractor):
  2913. IE_DESC = 'YouTube.com tab'
  2914. _VALID_URL = r'''(?x)
  2915. https?://
  2916. (?:\w+\.)?
  2917. (?:
  2918. youtube(?:kids)?\.com|
  2919. invidio\.us
  2920. )/
  2921. (?:
  2922. (?:channel|c|user|feed|hashtag)/|
  2923. (?:playlist|watch)\?.*?\blist=|
  2924. (?!(?:watch|embed|v|e|results)\b)
  2925. )
  2926. (?P<id>[^/?\#&]+)
  2927. '''
  2928. IE_NAME = 'youtube:tab'
  2929. _TESTS = [{
  2930. # Shorts
  2931. 'url': 'https://www.youtube.com/@SuperCooperShorts/shorts',
  2932. 'playlist_mincount': 5,
  2933. 'info_dict': {
  2934. 'description': 'Short clips from Super Cooper Sundays!',
  2935. 'id': 'UCKMA8kHZ8bPYpnMNaUSxfEQ',
  2936. 'title': 'Super Cooper Shorts - Shorts',
  2937. 'uploader': 'Super Cooper Shorts',
  2938. 'uploader_id': '@SuperCooperShorts',
  2939. },
  2940. }, {
  2941. # Channel that does not have a Shorts tab. Test should just download videos on Home tab instead
  2942. 'url': 'https://www.youtube.com/@emergencyawesome/shorts',
  2943. 'info_dict': {
  2944. 'description': 'md5:592c080c06fef4de3c902c4a8eecd850',
  2945. 'id': 'UCDiFRMQWpcp8_KD4vwIVicw',
  2946. 'title': 'Emergency Awesome - Home',
  2947. },
  2948. 'playlist_mincount': 5,
  2949. 'skip': 'new test page needed to replace `Emergency Awesome - Shorts`',
  2950. }, {
  2951. # playlists, multipage
  2952. 'url': 'https://www.youtube.com/c/ИгорьКлейнер/playlists?view=1&flow=grid',
  2953. 'playlist_mincount': 94,
  2954. 'info_dict': {
  2955. 'id': 'UCqj7Cz7revf5maW9g5pgNcg',
  2956. 'title': r're:Igor Kleiner(?: Ph\.D\.)? - Playlists',
  2957. 'description': 'md5:be97ee0f14ee314f1f002cf187166ee2',
  2958. 'uploader': 'Igor Kleiner',
  2959. 'uploader_id': '@IgorDataScience',
  2960. },
  2961. }, {
  2962. # playlists, multipage, different order
  2963. 'url': 'https://www.youtube.com/user/igorkle1/playlists?view=1&sort=dd',
  2964. 'playlist_mincount': 94,
  2965. 'info_dict': {
  2966. 'id': 'UCqj7Cz7revf5maW9g5pgNcg',
  2967. 'title': r're:Igor Kleiner(?: Ph\.D\.)? - Playlists',
  2968. 'description': 'md5:be97ee0f14ee314f1f002cf187166ee2',
  2969. 'uploader': 'Igor Kleiner',
  2970. 'uploader_id': '@IgorDataScience',
  2971. },
  2972. }, {
  2973. # playlists, series
  2974. 'url': 'https://www.youtube.com/c/3blue1brown/playlists?view=50&sort=dd&shelf_id=3',
  2975. 'playlist_mincount': 5,
  2976. 'info_dict': {
  2977. 'id': 'UCYO_jab_esuFRV4b17AJtAw',
  2978. 'title': '3Blue1Brown - Playlists',
  2979. 'description': 'md5:e1384e8a133307dd10edee76e875d62f',
  2980. 'uploader': '3Blue1Brown',
  2981. 'uploader_id': '@3blue1brown',
  2982. },
  2983. }, {
  2984. # playlists, singlepage
  2985. 'url': 'https://www.youtube.com/user/ThirstForScience/playlists',
  2986. 'playlist_mincount': 4,
  2987. 'info_dict': {
  2988. 'id': 'UCAEtajcuhQ6an9WEzY9LEMQ',
  2989. 'title': 'ThirstForScience - Playlists',
  2990. 'description': 'md5:609399d937ea957b0f53cbffb747a14c',
  2991. 'uploader': 'ThirstForScience',
  2992. 'uploader_id': '@ThirstForScience',
  2993. },
  2994. }, {
  2995. 'url': 'https://www.youtube.com/c/ChristophLaimer/playlists',
  2996. 'only_matching': True,
  2997. }, {
  2998. # basic, single video playlist
  2999. 'url': 'https://www.youtube.com/playlist?list=PL4lCao7KL_QFVb7Iudeipvc2BCavECqzc',
  3000. 'info_dict': {
  3001. 'id': 'PL4lCao7KL_QFVb7Iudeipvc2BCavECqzc',
  3002. 'title': 'youtube-dl public playlist',
  3003. 'uploader': 'Sergey M.',
  3004. 'uploader_id': '@sergeym.6173',
  3005. 'channel_id': 'UCmlqkdCBesrv2Lak1mF_MxA',
  3006. },
  3007. 'playlist_count': 1,
  3008. }, {
  3009. # empty playlist
  3010. 'url': 'https://www.youtube.com/playlist?list=PL4lCao7KL_QFodcLWhDpGCYnngnHtQ-Xf',
  3011. 'info_dict': {
  3012. 'id': 'PL4lCao7KL_QFodcLWhDpGCYnngnHtQ-Xf',
  3013. 'title': 'youtube-dl empty playlist',
  3014. 'uploader': 'Sergey M.',
  3015. 'uploader_id': '@sergeym.6173',
  3016. 'channel_id': 'UCmlqkdCBesrv2Lak1mF_MxA',
  3017. },
  3018. 'playlist_count': 0,
  3019. }, {
  3020. # Home tab
  3021. 'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w/featured',
  3022. 'info_dict': {
  3023. 'id': 'UCKfVa3S1e4PHvxWcwyMMg8w',
  3024. 'title': 'lex will - Home',
  3025. 'description': 'md5:2163c5d0ff54ed5f598d6a7e6211e488',
  3026. 'uploader': 'lex will',
  3027. 'uploader_id': '@lexwill718',
  3028. },
  3029. 'playlist_mincount': 2,
  3030. }, {
  3031. # Videos tab
  3032. 'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w/videos',
  3033. 'info_dict': {
  3034. 'id': 'UCKfVa3S1e4PHvxWcwyMMg8w',
  3035. 'title': 'lex will - Videos',
  3036. 'description': 'md5:2163c5d0ff54ed5f598d6a7e6211e488',
  3037. 'uploader': 'lex will',
  3038. 'uploader_id': '@lexwill718',
  3039. },
  3040. 'playlist_mincount': 975,
  3041. }, {
  3042. # Videos tab, sorted by popular
  3043. 'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w/videos?view=0&sort=p&flow=grid',
  3044. 'info_dict': {
  3045. 'id': 'UCKfVa3S1e4PHvxWcwyMMg8w',
  3046. 'title': 'lex will - Videos',
  3047. 'description': 'md5:2163c5d0ff54ed5f598d6a7e6211e488',
  3048. 'uploader': 'lex will',
  3049. 'uploader_id': '@lexwill718',
  3050. },
  3051. 'playlist_mincount': 199,
  3052. }, {
  3053. # Playlists tab
  3054. 'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w/playlists',
  3055. 'info_dict': {
  3056. 'id': 'UCKfVa3S1e4PHvxWcwyMMg8w',
  3057. 'title': 'lex will - Playlists',
  3058. 'description': 'md5:2163c5d0ff54ed5f598d6a7e6211e488',
  3059. 'uploader': 'lex will',
  3060. 'uploader_id': '@lexwill718',
  3061. },
  3062. 'playlist_mincount': 17,
  3063. }, {
  3064. # Community tab
  3065. 'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w/community',
  3066. 'info_dict': {
  3067. 'id': 'UCKfVa3S1e4PHvxWcwyMMg8w',
  3068. 'title': 'lex will - Community',
  3069. 'description': 'md5:2163c5d0ff54ed5f598d6a7e6211e488',
  3070. 'uploader': 'lex will',
  3071. 'uploader_id': '@lexwill718',
  3072. },
  3073. 'playlist_mincount': 18,
  3074. }, {
  3075. # Channels tab
  3076. 'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w/channels',
  3077. 'info_dict': {
  3078. 'id': 'UCKfVa3S1e4PHvxWcwyMMg8w',
  3079. 'title': r're:lex will - (?:Home|Channels)',
  3080. 'description': 'md5:2163c5d0ff54ed5f598d6a7e6211e488',
  3081. 'uploader': 'lex will',
  3082. 'uploader_id': '@lexwill718',
  3083. },
  3084. 'playlist_mincount': 75,
  3085. }, {
  3086. # Releases tab
  3087. 'url': 'https://www.youtube.com/@daftpunk/releases',
  3088. 'info_dict': {
  3089. 'id': 'UC_kRDKYrUlrbtrSiyu5Tflg',
  3090. 'title': 'Daft Punk - Releases',
  3091. 'description': 'Daft Punk (1993 - 2021) - Official YouTube Channel',
  3092. 'uploader_id': '@daftpunk',
  3093. 'uploader': 'Daft Punk',
  3094. },
  3095. 'playlist_mincount': 36,
  3096. }, {
  3097. 'url': 'https://invidio.us/channel/UCmlqkdCBesrv2Lak1mF_MxA',
  3098. 'only_matching': True,
  3099. }, {
  3100. 'url': 'https://www.youtubekids.com/channel/UCmlqkdCBesrv2Lak1mF_MxA',
  3101. 'only_matching': True,
  3102. }, {
  3103. 'url': 'https://music.youtube.com/channel/UCmlqkdCBesrv2Lak1mF_MxA',
  3104. 'only_matching': True,
  3105. }, {
  3106. 'note': 'Playlist with deleted videos (#651). As a bonus, the video #51 is also twice in this list.',
  3107. 'url': 'https://www.youtube.com/playlist?list=PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
  3108. 'info_dict': {
  3109. 'title': '29C3: Not my department',
  3110. 'id': 'PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
  3111. 'uploader': 'Christiaan008',
  3112. 'uploader_id': '@ChRiStIaAn008',
  3113. 'channel_id': 'UCEPzS1rYsrkqzSLNp76nrcg',
  3114. },
  3115. 'playlist_count': 96,
  3116. }, {
  3117. 'note': 'Large playlist',
  3118. 'url': 'https://www.youtube.com/playlist?list=UUBABnxM4Ar9ten8Mdjj1j0Q',
  3119. 'info_dict': {
  3120. 'title': 'Uploads from Cauchemar',
  3121. 'id': 'UUBABnxM4Ar9ten8Mdjj1j0Q',
  3122. 'uploader': 'Cauchemar',
  3123. 'uploader_id': '@Cauchemar89',
  3124. 'channel_id': 'UCBABnxM4Ar9ten8Mdjj1j0Q',
  3125. },
  3126. 'playlist_mincount': 1123,
  3127. }, {
  3128. # even larger playlist, 8832 videos
  3129. 'url': 'http://www.youtube.com/user/NASAgovVideo/videos',
  3130. 'only_matching': True,
  3131. }, {
  3132. 'note': 'Buggy playlist: the webpage has a "Load more" button but it doesn\'t have more videos',
  3133. 'url': 'https://www.youtube.com/playlist?list=UUXw-G3eDE9trcvY2sBMM_aA',
  3134. 'info_dict': {
  3135. 'title': 'Uploads from Interstellar Movie',
  3136. 'id': 'UUXw-G3eDE9trcvY2sBMM_aA',
  3137. 'uploader': 'Interstellar Movie',
  3138. 'uploader_id': '@InterstellarMovie',
  3139. 'channel_id': 'UCXw-G3eDE9trcvY2sBMM_aA',
  3140. },
  3141. 'playlist_mincount': 21,
  3142. }, {
  3143. # https://github.com/ytdl-org/youtube-dl/issues/21844
  3144. 'url': 'https://www.youtube.com/playlist?list=PLzH6n4zXuckpfMu_4Ff8E7Z1behQks5ba',
  3145. 'info_dict': {
  3146. 'title': 'Data Analysis with Dr Mike Pound',
  3147. 'id': 'PLzH6n4zXuckpfMu_4Ff8E7Z1behQks5ba',
  3148. 'uploader': 'Computerphile',
  3149. 'uploader_id': '@Computerphile',
  3150. 'channel_id': 'UC9-y-6csu5WGm29I7JiwpnA',
  3151. },
  3152. 'playlist_mincount': 11,
  3153. }, {
  3154. 'url': 'https://invidio.us/playlist?list=PL4lCao7KL_QFVb7Iudeipvc2BCavECqzc',
  3155. 'only_matching': True,
  3156. }, {
  3157. # Playlist URL that does not actually serve a playlist
  3158. 'url': 'https://www.youtube.com/watch?v=FqZTN594JQw&list=PLMYEtVRpaqY00V9W81Cwmzp6N6vZqfUKD4',
  3159. 'info_dict': {
  3160. 'id': 'FqZTN594JQw',
  3161. 'ext': 'webm',
  3162. 'title': "Smiley's People 01 detective, Adventure Series, Action",
  3163. 'uploader': 'STREEM',
  3164. 'uploader_id': 'UCyPhqAZgwYWZfxElWVbVJng',
  3165. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UCyPhqAZgwYWZfxElWVbVJng',
  3166. 'upload_date': '20150526',
  3167. 'license': 'Standard YouTube License',
  3168. 'description': 'md5:507cdcb5a49ac0da37a920ece610be80',
  3169. 'categories': ['People & Blogs'],
  3170. 'tags': list,
  3171. 'view_count': int,
  3172. 'like_count': int,
  3173. },
  3174. 'params': {
  3175. 'skip_download': True,
  3176. },
  3177. 'skip': 'This video is not available.',
  3178. 'add_ie': [YoutubeIE.ie_key()],
  3179. }, {
  3180. 'url': 'https://www.youtubekids.com/watch?v=Agk7R8I8o5U&list=PUZ6jURNr1WQZCNHF0ao-c0g',
  3181. 'only_matching': True,
  3182. }, {
  3183. 'url': 'https://www.youtube.com/watch?v=MuAGGZNfUkU&list=RDMM',
  3184. 'only_matching': True,
  3185. }, {
  3186. 'url': 'https://www.youtube.com/channel/UCoMdktPbSTixAyNGwb-UYkQ/live',
  3187. 'info_dict': {
  3188. 'id': r're:[\da-zA-Z_-]{8,}',
  3189. 'ext': 'mp4',
  3190. 'title': r're:(?s)[A-Z].{20,}',
  3191. 'uploader': 'Sky News',
  3192. 'uploader_id': '@SkyNews',
  3193. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@SkyNews',
  3194. 'upload_date': r're:\d{8}',
  3195. 'description': r're:(?s)(?:.*\n)+SUBSCRIBE to our YouTube channel for more videos: http://www\.youtube\.com/skynews *\n.*',
  3196. 'categories': ['News & Politics'],
  3197. 'tags': list,
  3198. 'like_count': int,
  3199. },
  3200. 'params': {
  3201. 'skip_download': True,
  3202. },
  3203. }, {
  3204. 'url': 'https://www.youtube.com/user/TheYoungTurks/live',
  3205. 'info_dict': {
  3206. 'id': 'a48o2S1cPoo',
  3207. 'ext': 'mp4',
  3208. 'title': 'The Young Turks - Live Main Show',
  3209. 'uploader': 'The Young Turks',
  3210. 'uploader_id': 'TheYoungTurks',
  3211. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/TheYoungTurks',
  3212. 'upload_date': '20150715',
  3213. 'license': 'Standard YouTube License',
  3214. 'description': 'md5:438179573adcdff3c97ebb1ee632b891',
  3215. 'categories': ['News & Politics'],
  3216. 'tags': ['Cenk Uygur (TV Program Creator)', 'The Young Turks (Award-Winning Work)', 'Talk Show (TV Genre)'],
  3217. 'like_count': int,
  3218. },
  3219. 'params': {
  3220. 'skip_download': True,
  3221. },
  3222. 'only_matching': True,
  3223. }, {
  3224. 'url': 'https://www.youtube.com/channel/UC1yBKRuGpC1tSM73A0ZjYjQ/live',
  3225. 'only_matching': True,
  3226. }, {
  3227. 'url': 'https://www.youtube.com/c/CommanderVideoHq/live',
  3228. 'only_matching': True,
  3229. }, {
  3230. 'url': 'https://www.youtube.com/feed/trending',
  3231. 'only_matching': True,
  3232. }, {
  3233. # needs auth
  3234. 'url': 'https://www.youtube.com/feed/library',
  3235. 'only_matching': True,
  3236. }, {
  3237. # needs auth
  3238. 'url': 'https://www.youtube.com/feed/history',
  3239. 'only_matching': True,
  3240. }, {
  3241. # needs auth
  3242. 'url': 'https://www.youtube.com/feed/subscriptions',
  3243. 'only_matching': True,
  3244. }, {
  3245. # needs auth
  3246. 'url': 'https://www.youtube.com/feed/watch_later',
  3247. 'only_matching': True,
  3248. }, {
  3249. # no longer available?
  3250. 'url': 'https://www.youtube.com/feed/recommended',
  3251. 'only_matching': True,
  3252. }, {
  3253. # inline playlist with not always working continuations
  3254. 'url': 'https://www.youtube.com/watch?v=UC6u0Tct-Fo&list=PL36D642111D65BE7C',
  3255. 'only_matching': True,
  3256. }, {
  3257. 'url': 'https://www.youtube.com/course?list=ECUl4u3cNGP61MdtwGTqZA0MreSaDybji8',
  3258. 'only_matching': True,
  3259. }, {
  3260. 'url': 'https://www.youtube.com/course',
  3261. 'only_matching': True,
  3262. }, {
  3263. 'url': 'https://www.youtube.com/zsecurity',
  3264. 'only_matching': True,
  3265. }, {
  3266. 'url': 'http://www.youtube.com/NASAgovVideo/videos',
  3267. 'only_matching': True,
  3268. }, {
  3269. 'url': 'https://www.youtube.com/TheYoungTurks/live',
  3270. 'only_matching': True,
  3271. }, {
  3272. 'url': 'https://www.youtube.com/hashtag/cctv9',
  3273. 'info_dict': {
  3274. 'id': 'cctv9',
  3275. 'title': '#cctv9',
  3276. },
  3277. 'playlist_mincount': 350,
  3278. }, {
  3279. 'url': 'https://www.youtube.com/watch?list=PLW4dVinRY435CBE_JD3t-0SRXKfnZHS1P&feature=youtu.be&v=M9cJMXmQ_ZU',
  3280. 'only_matching': True,
  3281. }, {
  3282. 'note': 'Search tab',
  3283. 'url': 'https://www.youtube.com/c/3blue1brown/search?query=linear%20algebra',
  3284. 'playlist_mincount': 20,
  3285. 'info_dict': {
  3286. 'id': 'UCYO_jab_esuFRV4b17AJtAw',
  3287. 'title': '3Blue1Brown - Search - linear algebra',
  3288. 'description': 'md5:e1384e8a133307dd10edee76e875d62f',
  3289. 'uploader': '3Blue1Brown',
  3290. 'uploader_id': '@3blue1brown',
  3291. 'channel_id': 'UCYO_jab_esuFRV4b17AJtAw',
  3292. },
  3293. }]
  3294. @classmethod
  3295. def suitable(cls, url):
  3296. return not YoutubeIE.suitable(url) and super(
  3297. YoutubeTabIE, cls).suitable(url)
  3298. @staticmethod
  3299. def _extract_grid_item_renderer(item):
  3300. return traverse_obj(item, (
  3301. T(dict.items), lambda _, k_v: k_v[0].startswith('grid') and k_v[0].endswith('Renderer'),
  3302. 1, T(dict)), get_all=False)
  3303. def _grid_entries(self, grid_renderer):
  3304. for item in traverse_obj(grid_renderer, ('items', Ellipsis, T(dict))):
  3305. lockup_view_model = traverse_obj(item, ('lockupViewModel', T(dict)))
  3306. if lockup_view_model:
  3307. entry = self._extract_lockup_view_model(lockup_view_model)
  3308. if entry:
  3309. yield entry
  3310. continue
  3311. renderer = self._extract_grid_item_renderer(item)
  3312. if not isinstance(renderer, dict):
  3313. continue
  3314. title = self._get_text(renderer, 'title')
  3315. # playlist
  3316. playlist_id = renderer.get('playlistId')
  3317. if playlist_id:
  3318. yield self.url_result(
  3319. 'https://www.youtube.com/playlist?list=%s' % playlist_id,
  3320. ie=YoutubeTabIE.ie_key(), video_id=playlist_id,
  3321. video_title=title)
  3322. continue
  3323. # video
  3324. video_id = renderer.get('videoId')
  3325. if video_id:
  3326. yield self._extract_video(renderer)
  3327. continue
  3328. # channel
  3329. channel_id = renderer.get('channelId')
  3330. if channel_id:
  3331. title = self._get_text(renderer, 'title')
  3332. yield self.url_result(
  3333. 'https://www.youtube.com/channel/%s' % channel_id,
  3334. ie=YoutubeTabIE.ie_key(), video_title=title)
  3335. continue
  3336. # generic endpoint URL support
  3337. ep_url = urljoin('https://www.youtube.com/', try_get(
  3338. renderer, lambda x: x['navigationEndpoint']['commandMetadata']['webCommandMetadata']['url'],
  3339. compat_str))
  3340. if ep_url:
  3341. for ie in (YoutubeTabIE, YoutubePlaylistIE, YoutubeIE):
  3342. if ie.suitable(ep_url):
  3343. yield self.url_result(
  3344. ep_url, ie=ie.ie_key(), video_id=ie._match_id(ep_url), video_title=title)
  3345. break
  3346. def _shelf_entries_from_content(self, shelf_renderer):
  3347. content = shelf_renderer.get('content')
  3348. if not isinstance(content, dict):
  3349. return
  3350. renderer = content.get('gridRenderer')
  3351. if renderer:
  3352. # TODO: add support for nested playlists so each shelf is processed
  3353. # as separate playlist
  3354. # TODO: this includes only first N items
  3355. for entry in self._grid_entries(renderer):
  3356. yield entry
  3357. renderer = content.get('horizontalListRenderer')
  3358. if renderer:
  3359. # TODO
  3360. pass
  3361. def _shelf_entries(self, shelf_renderer, skip_channels=False):
  3362. ep = try_get(
  3363. shelf_renderer, lambda x: x['endpoint']['commandMetadata']['webCommandMetadata']['url'],
  3364. compat_str)
  3365. shelf_url = urljoin('https://www.youtube.com', ep)
  3366. if shelf_url:
  3367. # Skipping links to another channels, note that checking for
  3368. # endpoint.commandMetadata.webCommandMetadata.webPageTypwebPageType == WEB_PAGE_TYPE_CHANNEL
  3369. # will not work
  3370. if skip_channels and '/channels?' in shelf_url:
  3371. return
  3372. title = try_get(
  3373. shelf_renderer, lambda x: x['title']['runs'][0]['text'], compat_str)
  3374. yield self.url_result(shelf_url, video_title=title)
  3375. # Shelf may not contain shelf URL, fallback to extraction from content
  3376. for from_ in self._shelf_entries_from_content(shelf_renderer):
  3377. yield from_
  3378. def _playlist_entries(self, video_list_renderer):
  3379. for content in video_list_renderer['contents']:
  3380. if not isinstance(content, dict):
  3381. continue
  3382. renderer = content.get('playlistVideoRenderer') or content.get('playlistPanelVideoRenderer')
  3383. if not isinstance(renderer, dict):
  3384. continue
  3385. video_id = renderer.get('videoId')
  3386. if not video_id:
  3387. continue
  3388. yield self._extract_video(renderer)
  3389. def _extract_lockup_view_model(self, view_model):
  3390. content_id = view_model.get('contentId')
  3391. if not content_id:
  3392. return
  3393. content_type = view_model.get('contentType')
  3394. if content_type == 'LOCKUP_CONTENT_TYPE_VIDEO':
  3395. ie = YoutubeIE
  3396. url = update_url_query(
  3397. 'https://www.youtube.com/watch', {'v': content_id})
  3398. thumb_keys = (None,)
  3399. elif content_type in ('LOCKUP_CONTENT_TYPE_PLAYLIST', 'LOCKUP_CONTENT_TYPE_PODCAST'):
  3400. ie = YoutubeTabIE
  3401. url = update_url_query(
  3402. 'https://www.youtube.com/playlist', {'list': content_id})
  3403. thumb_keys = ('collectionThumbnailViewModel', 'primaryThumbnail')
  3404. else:
  3405. self.report_warning(
  3406. 'Unsupported lockup view model content type "{0}"{1}'.format(content_type, bug_reports_message()),
  3407. only_once=True)
  3408. return
  3409. thumb_keys = ('contentImage',) + thumb_keys + ('thumbnailViewModel', 'image')
  3410. return merge_dicts(self.url_result(
  3411. url, ie=ie.ie_key(), video_id=content_id),
  3412. traverse_obj(view_model, {
  3413. 'title': ('metadata', 'lockupMetadataViewModel', 'title',
  3414. 'content', T(compat_str)),
  3415. 'thumbnails': T(lambda vm: self._extract_thumbnails(
  3416. vm, thumb_keys, final_key='sources')),
  3417. 'duration': (
  3418. 'contentImage', 'thumbnailViewModel', 'overlays',
  3419. Ellipsis, (
  3420. ('thumbnailBottomOverlayViewModel', 'badges'),
  3421. ('thumbnailOverlayBadgeViewModel', 'thumbnailBadges')
  3422. ), Ellipsis, 'thumbnailBadgeViewModel', 'text',
  3423. T(parse_duration), any),
  3424. })
  3425. )
  3426. def _extract_shorts_lockup_view_model(self, view_model):
  3427. content_id = traverse_obj(view_model, (
  3428. 'onTap', 'innertubeCommand', 'reelWatchEndpoint', 'videoId',
  3429. T(lambda v: v if YoutubeIE.suitable(v) else None)))
  3430. return merge_dicts(self.url_result(
  3431. content_id, ie=YoutubeIE.ie_key(), video_id=content_id), {
  3432. 'title': traverse_obj(view_model, (
  3433. 'overlayMetadata', 'primaryText', 'content', T(compat_str))),
  3434. 'thumbnails': self._extract_thumbnails(
  3435. view_model, 'thumbnail', final_key='sources'),
  3436. }) if content_id else None
  3437. def _video_entry(self, video_renderer):
  3438. video_id = video_renderer.get('videoId')
  3439. return self._extract_video(video_renderer) if video_id else None
  3440. def _post_thread_entries(self, post_thread_renderer):
  3441. post_renderer = try_get(
  3442. post_thread_renderer, lambda x: x['post']['backstagePostRenderer'], dict)
  3443. if not post_renderer:
  3444. return
  3445. # video attachment
  3446. video_renderer = try_get(
  3447. post_renderer, lambda x: x['backstageAttachment']['videoRenderer'], dict)
  3448. video_id = None
  3449. if video_renderer:
  3450. entry = self._video_entry(video_renderer)
  3451. if entry:
  3452. yield entry
  3453. # inline video links
  3454. runs = try_get(post_renderer, lambda x: x['contentText']['runs'], list) or []
  3455. for run in runs:
  3456. if not isinstance(run, dict):
  3457. continue
  3458. ep_url = try_get(
  3459. run, lambda x: x['navigationEndpoint']['urlEndpoint']['url'], compat_str)
  3460. if not ep_url:
  3461. continue
  3462. if not YoutubeIE.suitable(ep_url):
  3463. continue
  3464. ep_video_id = YoutubeIE._match_id(ep_url)
  3465. if video_id == ep_video_id:
  3466. continue
  3467. yield self.url_result(ep_url, ie=YoutubeIE.ie_key(), video_id=video_id)
  3468. def _post_thread_continuation_entries(self, post_thread_continuation):
  3469. for renderer in traverse_obj(post_thread_continuation, (
  3470. 'contents', Ellipsis, 'backstagePostThreadRenderer', T(dict))):
  3471. for from_ in self._post_thread_entries(renderer):
  3472. yield from_
  3473. def _rich_grid_entries(self, contents):
  3474. for content in traverse_obj(
  3475. contents, (Ellipsis, 'richItemRenderer', 'content'),
  3476. expected_type=dict):
  3477. video_renderer = traverse_obj(
  3478. content, 'videoRenderer', 'reelItemRenderer',
  3479. expected_type=dict)
  3480. if video_renderer:
  3481. entry = self._video_entry(video_renderer)
  3482. if entry:
  3483. yield entry
  3484. # shorts item
  3485. shorts_lockup_view_model = content.get('shortsLockupViewModel')
  3486. if shorts_lockup_view_model:
  3487. entry = self._extract_shorts_lockup_view_model(shorts_lockup_view_model)
  3488. if entry:
  3489. yield entry
  3490. # playlist
  3491. renderer = traverse_obj(
  3492. content, 'playlistRenderer', expected_type=dict) or {}
  3493. title = self._get_text(renderer, 'title')
  3494. playlist_id = renderer.get('playlistId')
  3495. if playlist_id:
  3496. yield self.url_result(
  3497. 'https://www.youtube.com/playlist?list=%s' % playlist_id,
  3498. ie=YoutubeTabIE.ie_key(), video_id=playlist_id,
  3499. video_title=title)
  3500. @staticmethod
  3501. def _build_continuation_query(continuation, ctp=None):
  3502. query = {
  3503. 'ctoken': continuation,
  3504. 'continuation': continuation,
  3505. }
  3506. if ctp:
  3507. query['itct'] = ctp
  3508. return query
  3509. @staticmethod
  3510. def _extract_next_continuation_data(renderer):
  3511. next_continuation = try_get(
  3512. renderer, lambda x: x['continuations'][0]['nextContinuationData'], dict)
  3513. if not next_continuation:
  3514. return
  3515. continuation = next_continuation.get('continuation')
  3516. if not continuation:
  3517. return
  3518. ctp = next_continuation.get('clickTrackingParams')
  3519. return YoutubeTabIE._build_continuation_query(continuation, ctp)
  3520. @classmethod
  3521. def _extract_continuation(cls, renderer):
  3522. next_continuation = cls._extract_next_continuation_data(renderer)
  3523. if next_continuation:
  3524. return next_continuation
  3525. for command in traverse_obj(renderer, (
  3526. ('contents', 'items', 'rows'), Ellipsis, 'continuationItemRenderer',
  3527. ('continuationEndpoint', ('button', 'buttonRenderer', 'command')),
  3528. (('commandExecutorCommand', 'commands', Ellipsis), None), T(dict))):
  3529. continuation = traverse_obj(command, ('continuationCommand', 'token', T(compat_str)))
  3530. if not continuation:
  3531. continue
  3532. ctp = command.get('clickTrackingParams')
  3533. return cls._build_continuation_query(continuation, ctp)
  3534. def _entries(self, tab, item_id, webpage):
  3535. tab_content = try_get(tab, lambda x: x['content'], dict)
  3536. if not tab_content:
  3537. return
  3538. slr_renderer = try_get(tab_content, lambda x: x['sectionListRenderer'], dict)
  3539. if slr_renderer:
  3540. is_channels_tab = tab.get('title') == 'Channels'
  3541. continuation = None
  3542. for is_renderer in traverse_obj(slr_renderer, (
  3543. 'contents', Ellipsis, 'itemSectionRenderer', T(dict))):
  3544. for isr_content in traverse_obj(slr_renderer, (
  3545. 'contents', Ellipsis, T(dict))):
  3546. renderer = isr_content.get('playlistVideoListRenderer')
  3547. if renderer:
  3548. for entry in self._playlist_entries(renderer):
  3549. yield entry
  3550. continuation = self._extract_continuation(renderer)
  3551. continue
  3552. renderer = isr_content.get('gridRenderer')
  3553. if renderer:
  3554. for entry in self._grid_entries(renderer):
  3555. yield entry
  3556. continuation = self._extract_continuation(renderer)
  3557. continue
  3558. renderer = isr_content.get('shelfRenderer')
  3559. if renderer:
  3560. for entry in self._shelf_entries(renderer, not is_channels_tab):
  3561. yield entry
  3562. continue
  3563. renderer = isr_content.get('backstagePostThreadRenderer')
  3564. if renderer:
  3565. for entry in self._post_thread_entries(renderer):
  3566. yield entry
  3567. continuation = self._extract_continuation(renderer)
  3568. continue
  3569. renderer = isr_content.get('videoRenderer')
  3570. if renderer:
  3571. entry = self._video_entry(renderer)
  3572. if entry:
  3573. yield entry
  3574. renderer = isr_content.get('richGridRenderer')
  3575. if renderer:
  3576. for from_ in self._rich_grid_entries(
  3577. traverse_obj(renderer, ('contents', Ellipsis, T(dict)))):
  3578. yield from_
  3579. continuation = self._extract_continuation(renderer)
  3580. continue
  3581. if not continuation:
  3582. continuation = self._extract_continuation(is_renderer)
  3583. if not continuation:
  3584. continuation = self._extract_continuation(slr_renderer)
  3585. else:
  3586. rich_grid_renderer = tab_content.get('richGridRenderer')
  3587. if not rich_grid_renderer:
  3588. return
  3589. for from_ in self._rich_grid_entries(
  3590. traverse_obj(rich_grid_renderer, ('contents', Ellipsis, T(dict)))):
  3591. yield from_
  3592. continuation = self._extract_continuation(rich_grid_renderer)
  3593. ytcfg = self._extract_ytcfg(item_id, webpage)
  3594. client_version = try_get(
  3595. ytcfg, lambda x: x['INNERTUBE_CLIENT_VERSION'], compat_str) or '2.20210407.08.00'
  3596. headers = {
  3597. 'x-youtube-client-name': '1',
  3598. 'x-youtube-client-version': client_version,
  3599. 'content-type': 'application/json',
  3600. }
  3601. context = try_get(ytcfg, lambda x: x['INNERTUBE_CONTEXT'], dict) or {
  3602. 'client': {
  3603. 'clientName': 'WEB',
  3604. 'clientVersion': client_version,
  3605. },
  3606. }
  3607. visitor_data = try_get(context, lambda x: x['client']['visitorData'], compat_str)
  3608. identity_token = self._extract_identity_token(ytcfg, webpage)
  3609. if identity_token:
  3610. headers['x-youtube-identity-token'] = identity_token
  3611. data = {
  3612. 'context': context,
  3613. }
  3614. for page_num in itertools.count(1):
  3615. if not continuation:
  3616. break
  3617. if visitor_data:
  3618. headers['X-Goog-Visitor-Id'] = visitor_data
  3619. data['continuation'] = continuation['continuation']
  3620. data['clickTracking'] = {
  3621. 'clickTrackingParams': continuation['itct'],
  3622. }
  3623. count = 0
  3624. retries = 3
  3625. while count <= retries:
  3626. try:
  3627. # Downloading page may result in intermittent 5xx HTTP error
  3628. # that is usually worked around with a retry
  3629. response = self._download_json(
  3630. 'https://www.youtube.com/youtubei/v1/browse',
  3631. None, 'Downloading page %d%s' % (page_num, ' (retry #%d)' % count if count else ''),
  3632. query={
  3633. # 'key': 'AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8',
  3634. 'prettyPrint': 'false',
  3635. },
  3636. headers=headers, data=json.dumps(data).encode('utf8'))
  3637. break
  3638. except ExtractorError as e:
  3639. if isinstance(e.cause, compat_HTTPError) and e.cause.code in (500, 503):
  3640. count += 1
  3641. if count <= retries:
  3642. continue
  3643. raise
  3644. if not response:
  3645. break
  3646. visitor_data = try_get(
  3647. response, lambda x: x['responseContext']['visitorData'], compat_str) or visitor_data
  3648. continuation_contents = try_get(
  3649. response, lambda x: x['continuationContents'], dict)
  3650. if continuation_contents:
  3651. continuation_renderer = continuation_contents.get('playlistVideoListContinuation')
  3652. if continuation_renderer:
  3653. for entry in self._playlist_entries(continuation_renderer):
  3654. yield entry
  3655. continuation = self._extract_continuation(continuation_renderer)
  3656. continue
  3657. continuation_renderer = continuation_contents.get('gridContinuation')
  3658. if continuation_renderer:
  3659. for entry in self._grid_entries(continuation_renderer):
  3660. yield entry
  3661. continuation = self._extract_continuation(continuation_renderer)
  3662. continue
  3663. continuation_renderer = continuation_contents.get('itemSectionContinuation')
  3664. if continuation_renderer:
  3665. for entry in self._post_thread_continuation_entries(continuation_renderer):
  3666. yield entry
  3667. continuation = self._extract_continuation(continuation_renderer)
  3668. continue
  3669. on_response_received = dict_get(response, ('onResponseReceivedActions', 'onResponseReceivedEndpoints'))
  3670. continuation_items = try_get(
  3671. on_response_received, lambda x: x[0]['appendContinuationItemsAction']['continuationItems'], list)
  3672. if continuation_items:
  3673. continuation_item = continuation_items[0]
  3674. if not isinstance(continuation_item, dict):
  3675. continue
  3676. renderer = self._extract_grid_item_renderer(continuation_item)
  3677. if renderer:
  3678. grid_renderer = {'items': continuation_items}
  3679. for entry in self._grid_entries(grid_renderer):
  3680. yield entry
  3681. continuation = self._extract_continuation(grid_renderer)
  3682. continue
  3683. renderer = continuation_item.get('playlistVideoRenderer') or continuation_item.get('itemSectionRenderer')
  3684. if renderer:
  3685. video_list_renderer = {'contents': continuation_items}
  3686. for entry in self._playlist_entries(video_list_renderer):
  3687. yield entry
  3688. continuation = self._extract_continuation(video_list_renderer)
  3689. continue
  3690. renderer = continuation_item.get('backstagePostThreadRenderer')
  3691. if renderer:
  3692. continuation_renderer = {'contents': continuation_items}
  3693. for entry in self._post_thread_continuation_entries(continuation_renderer):
  3694. yield entry
  3695. continuation = self._extract_continuation(continuation_renderer)
  3696. continue
  3697. renderer = continuation_item.get('richItemRenderer')
  3698. if renderer:
  3699. for entry in self._rich_grid_entries(continuation_items):
  3700. yield entry
  3701. continuation = self._extract_continuation({'contents': continuation_items})
  3702. continue
  3703. break
  3704. @staticmethod
  3705. def _extract_selected_tab(tabs):
  3706. for tab in tabs:
  3707. renderer = dict_get(tab, ('tabRenderer', 'expandableTabRenderer')) or {}
  3708. if renderer.get('selected') is True:
  3709. return renderer
  3710. else:
  3711. raise ExtractorError('Unable to find selected tab')
  3712. def _extract_uploader(self, metadata, data):
  3713. uploader = {}
  3714. renderers = traverse_obj(data,
  3715. ('sidebar', 'playlistSidebarRenderer', 'items'))
  3716. uploader['channel_id'] = self._extract_channel_id('', metadata=metadata, renderers=renderers)
  3717. uploader['uploader'] = (
  3718. self._extract_author_var('', 'name', renderers=renderers)
  3719. or self._extract_author_var('', 'name', metadata=metadata))
  3720. uploader['uploader_url'] = self._yt_urljoin(
  3721. self._extract_author_var('', 'url', metadata=metadata, renderers=renderers))
  3722. uploader['uploader_id'] = self._extract_uploader_id(uploader['uploader_url'])
  3723. uploader['channel'] = uploader['uploader']
  3724. return uploader
  3725. def _extract_and_report_alerts(self, data, expected=True, fatal=True, only_once=False):
  3726. def alerts():
  3727. for alert in traverse_obj(data, ('alerts', Ellipsis), expected_type=dict):
  3728. alert_dict = traverse_obj(
  3729. alert, 'alertRenderer', None, expected_type=dict, get_all=False)
  3730. alert_type = traverse_obj(alert_dict, 'type')
  3731. if not alert_type:
  3732. continue
  3733. message = self._get_text(alert_dict, 'text')
  3734. if message:
  3735. yield alert_type, message
  3736. errors, warnings = [], []
  3737. _IGNORED_WARNINGS = T('Unavailable videos will be hidden during playback')
  3738. for alert_type, alert_message in alerts():
  3739. if alert_type.lower() == 'error' and fatal:
  3740. errors.append([alert_type, alert_message])
  3741. elif alert_message not in _IGNORED_WARNINGS:
  3742. warnings.append([alert_type, alert_message])
  3743. for alert_type, alert_message in itertools.chain(warnings, errors[:-1]):
  3744. self.report_warning(
  3745. 'YouTube said: %s - %s' % (alert_type, alert_message),
  3746. only_once=only_once)
  3747. if errors:
  3748. raise ExtractorError(
  3749. 'YouTube said: %s' % (errors[-1][1],), expected=expected)
  3750. def _extract_from_tabs(self, item_id, webpage, data, tabs):
  3751. selected_tab = self._extract_selected_tab(tabs)
  3752. renderer = traverse_obj(data, ('metadata', 'channelMetadataRenderer'),
  3753. expected_type=dict) or {}
  3754. playlist_id = item_id
  3755. title = description = None
  3756. if renderer:
  3757. channel_title = txt_or_none(renderer.get('title')) or item_id
  3758. tab_title = txt_or_none(selected_tab.get('title'))
  3759. title = join_nonempty(
  3760. channel_title or item_id, tab_title,
  3761. txt_or_none(selected_tab.get('expandedText')),
  3762. delim=' - ')
  3763. description = txt_or_none(renderer.get('description'))
  3764. playlist_id = txt_or_none(renderer.get('externalId')) or playlist_id
  3765. else:
  3766. renderer = traverse_obj(data,
  3767. ('metadata', 'playlistMetadataRenderer'),
  3768. ('header', 'hashtagHeaderRenderer'),
  3769. expected_type=dict) or {}
  3770. title = traverse_obj(renderer, 'title', ('hashtag', 'simpleText'),
  3771. expected_type=txt_or_none)
  3772. playlist = self.playlist_result(
  3773. self._entries(selected_tab, item_id, webpage),
  3774. playlist_id=playlist_id, playlist_title=title,
  3775. playlist_description=description)
  3776. return merge_dicts(playlist, self._extract_uploader(renderer, data))
  3777. def _extract_from_playlist(self, item_id, url, data, playlist):
  3778. title = traverse_obj((playlist, data),
  3779. (0, 'title'), (1, 'titleText', 'simpleText'),
  3780. expected_type=txt_or_none)
  3781. playlist_id = txt_or_none(playlist.get('playlistId')) or item_id
  3782. # Inline playlist rendition continuation does not always work
  3783. # at Youtube side, so delegating regular tab-based playlist URL
  3784. # processing whenever possible.
  3785. playlist_url = urljoin(url, traverse_obj(
  3786. playlist, ('endpoint', 'commandMetadata', 'webCommandMetadata', 'url'),
  3787. expected_type=url_or_none))
  3788. if playlist_url and playlist_url != url:
  3789. return self.url_result(
  3790. playlist_url, ie=YoutubeTabIE.ie_key(), video_id=playlist_id,
  3791. video_title=title)
  3792. return self.playlist_result(
  3793. self._playlist_entries(playlist), playlist_id=playlist_id,
  3794. playlist_title=title)
  3795. def _extract_identity_token(self, ytcfg, webpage):
  3796. if ytcfg:
  3797. token = try_get(ytcfg, lambda x: x['ID_TOKEN'], compat_str)
  3798. if token:
  3799. return token
  3800. return self._search_regex(
  3801. r'\bID_TOKEN["\']\s*:\s*["\'](.+?)["\']', webpage,
  3802. 'identity token', default=None)
  3803. def _real_extract(self, url):
  3804. item_id = self._match_id(url)
  3805. url = update_url(url, netloc='www.youtube.com')
  3806. qs = parse_qs(url)
  3807. def qs_get(key, default=None):
  3808. return qs.get(key, [default])[-1]
  3809. # Go around for /feeds/videos.xml?playlist_id={pl_id}
  3810. if item_id == 'feeds' and '/feeds/videos.xml?' in url:
  3811. playlist_id = qs_get('playlist_id')
  3812. if playlist_id:
  3813. return self.url_result(
  3814. update_url_query('https://www.youtube.com/playlist', {
  3815. 'list': playlist_id,
  3816. }), ie=self.ie_key(), video_id=playlist_id)
  3817. # Handle both video/playlist URLs
  3818. video_id = qs_get('v')
  3819. playlist_id = qs_get('list')
  3820. if video_id and playlist_id:
  3821. if self._downloader.params.get('noplaylist'):
  3822. self.to_screen('Downloading just video %s because of --no-playlist' % video_id)
  3823. return self.url_result(video_id, ie=YoutubeIE.ie_key(), video_id=video_id)
  3824. self.to_screen('Downloading playlist %s - add --no-playlist to just download video %s' % (playlist_id, video_id))
  3825. webpage = self._download_webpage(url, item_id)
  3826. data = self._extract_yt_initial_data(item_id, webpage)
  3827. tabs = try_get(
  3828. data, lambda x: x['contents']['twoColumnBrowseResultsRenderer']['tabs'], list)
  3829. if tabs:
  3830. return self._extract_from_tabs(item_id, webpage, data, tabs)
  3831. playlist = try_get(
  3832. data, lambda x: x['contents']['twoColumnWatchNextResults']['playlist']['playlist'], dict)
  3833. if playlist:
  3834. return self._extract_from_playlist(item_id, url, data, playlist)
  3835. # Fallback to video extraction if no playlist alike page is recognized.
  3836. # First check for the current video then try the v attribute of URL query.
  3837. video_id = try_get(
  3838. data, lambda x: x['currentVideoEndpoint']['watchEndpoint']['videoId'],
  3839. compat_str) or video_id
  3840. if video_id:
  3841. return self.url_result(video_id, ie=YoutubeIE.ie_key(), video_id=video_id)
  3842. # Capture and output alerts
  3843. self._extract_and_report_alerts(data)
  3844. # Failed to recognize
  3845. raise ExtractorError('Unable to recognize tab page')
  3846. class YoutubePlaylistIE(InfoExtractor):
  3847. IE_DESC = 'YouTube.com playlists'
  3848. _VALID_URL = r'''(?x)(?:
  3849. (?:https?://)?
  3850. (?:\w+\.)?
  3851. (?:
  3852. (?:
  3853. youtube(?:kids)?\.com|
  3854. invidio\.us
  3855. )
  3856. /.*?\?.*?\blist=
  3857. )?
  3858. (?P<id>%(playlist_id)s)
  3859. )''' % {'playlist_id': YoutubeBaseInfoExtractor._PLAYLIST_ID_RE}
  3860. IE_NAME = 'youtube:playlist'
  3861. _TESTS = [{
  3862. 'note': 'issue #673',
  3863. 'url': 'PLBB231211A4F62143',
  3864. 'info_dict': {
  3865. 'title': '[OLD]Team Fortress 2 (Class-based LP)',
  3866. 'id': 'PLBB231211A4F62143',
  3867. 'uploader': 'Wickman',
  3868. 'uploader_id': '@WickmanVT',
  3869. 'channel_id': 'UCKSpbfbl5kRQpTdL7kMc-1Q',
  3870. },
  3871. 'playlist_mincount': 29,
  3872. }, {
  3873. 'url': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
  3874. 'info_dict': {
  3875. 'title': 'YDL_safe_search',
  3876. 'id': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
  3877. },
  3878. 'playlist_count': 2,
  3879. 'skip': 'This playlist is private',
  3880. }, {
  3881. 'note': 'embedded',
  3882. 'url': 'https://www.youtube.com/embed/videoseries?list=PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
  3883. # TODO: full playlist requires _reload_with_unavailable_videos()
  3884. # 'playlist_count': 4,
  3885. 'playlist_mincount': 1,
  3886. 'info_dict': {
  3887. 'title': 'JODA15',
  3888. 'id': 'PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
  3889. 'uploader': 'milan',
  3890. 'uploader_id': '@milan5503',
  3891. 'channel_id': 'UCEI1-PVPcYXjB73Hfelbmaw',
  3892. },
  3893. }, {
  3894. 'url': 'http://www.youtube.com/embed/_xDOZElKyNU?list=PLsyOSbh5bs16vubvKePAQ1x3PhKavfBIl',
  3895. 'playlist_mincount': 455,
  3896. 'info_dict': {
  3897. 'title': '2018 Chinese New Singles (11/6 updated)',
  3898. 'id': 'PLsyOSbh5bs16vubvKePAQ1x3PhKavfBIl',
  3899. 'uploader': 'LBK',
  3900. 'uploader_id': '@music_king',
  3901. 'channel_id': 'UC21nz3_MesPLqtDqwdvnoxA',
  3902. },
  3903. }, {
  3904. 'url': 'TLGGrESM50VT6acwMjAyMjAxNw',
  3905. 'only_matching': True,
  3906. }, {
  3907. # music album playlist
  3908. 'url': 'OLAK5uy_m4xAFdmMC5rX3Ji3g93pQe3hqLZw_9LhM',
  3909. 'only_matching': True,
  3910. }]
  3911. @classmethod
  3912. def suitable(cls, url):
  3913. if YoutubeTabIE.suitable(url):
  3914. return False
  3915. if parse_qs(url).get('v', [None])[0]:
  3916. return False
  3917. return super(YoutubePlaylistIE, cls).suitable(url)
  3918. def _real_extract(self, url):
  3919. playlist_id = self._match_id(url)
  3920. qs = parse_qs(url)
  3921. if not qs:
  3922. qs = {'list': playlist_id}
  3923. return self.url_result(
  3924. update_url_query('https://www.youtube.com/playlist', qs),
  3925. ie=YoutubeTabIE.ie_key(), video_id=playlist_id)
  3926. class YoutubeYtBeIE(InfoExtractor):
  3927. _VALID_URL = r'https?://youtu\.be/(?P<id>[0-9A-Za-z_-]{11})/*?.*?\blist=(?P<playlist_id>%(playlist_id)s)' % {'playlist_id': YoutubeBaseInfoExtractor._PLAYLIST_ID_RE}
  3928. _TESTS = [{
  3929. 'url': 'https://youtu.be/yeWKywCrFtk?list=PL2qgrgXsNUG5ig9cat4ohreBjYLAPC0J5',
  3930. 'info_dict': {
  3931. 'id': 'yeWKywCrFtk',
  3932. 'ext': 'mp4',
  3933. 'title': 'Small Scale Baler and Braiding Rugs',
  3934. 'uploader': 'Backus-Page House Museum',
  3935. 'uploader_id': '@backuspagemuseum',
  3936. 'uploader_url': r're:https?://(?:www\.)?youtube\.com/@backuspagemuseum',
  3937. 'upload_date': '20161008',
  3938. 'description': 'md5:800c0c78d5eb128500bffd4f0b4f2e8a',
  3939. 'categories': ['Nonprofits & Activism'],
  3940. 'tags': list,
  3941. 'like_count': int,
  3942. },
  3943. 'params': {
  3944. 'noplaylist': True,
  3945. 'skip_download': True,
  3946. },
  3947. }, {
  3948. 'url': 'https://youtu.be/uWyaPkt-VOI?list=PL9D9FC436B881BA21',
  3949. 'only_matching': True,
  3950. }]
  3951. def _real_extract(self, url):
  3952. mobj = re.match(self._VALID_URL, url)
  3953. video_id = mobj.group('id')
  3954. playlist_id = mobj.group('playlist_id')
  3955. return self.url_result(
  3956. update_url_query('https://www.youtube.com/watch', {
  3957. 'v': video_id,
  3958. 'list': playlist_id,
  3959. 'feature': 'youtu.be',
  3960. }), ie=YoutubeTabIE.ie_key(), video_id=playlist_id)
  3961. class YoutubeYtUserIE(InfoExtractor):
  3962. _VALID_URL = r'ytuser:(?P<id>.+)'
  3963. _TESTS = [{
  3964. 'url': 'ytuser:phihag',
  3965. 'only_matching': True,
  3966. }]
  3967. def _real_extract(self, url):
  3968. user_id = self._match_id(url)
  3969. return self.url_result(
  3970. 'https://www.youtube.com/user/%s' % user_id,
  3971. ie=YoutubeTabIE.ie_key(), video_id=user_id)
  3972. class YoutubeFavouritesIE(YoutubeBaseInfoExtractor):
  3973. IE_NAME = 'youtube:favorites'
  3974. IE_DESC = 'YouTube.com favourite videos, ":ytfav" for short (requires authentication)'
  3975. _VALID_URL = r'https?://(?:www\.)?youtube\.com/my_favorites|:ytfav(?:ou?rites)?'
  3976. _LOGIN_REQUIRED = True
  3977. _TESTS = [{
  3978. 'url': ':ytfav',
  3979. 'only_matching': True,
  3980. }, {
  3981. 'url': ':ytfavorites',
  3982. 'only_matching': True,
  3983. }]
  3984. def _real_extract(self, _):
  3985. return self.url_result(
  3986. 'https://www.youtube.com/playlist?list=LL',
  3987. ie=YoutubeTabIE.ie_key())
  3988. class YoutubeSearchIE(SearchInfoExtractor, YoutubeBaseInfoExtractor):
  3989. IE_DESC = 'YouTube.com searches'
  3990. IE_NAME = 'youtube:search'
  3991. _SEARCH_KEY = 'ytsearch'
  3992. _SEARCH_PARAMS = 'EgIQAQ%3D%3D' # Videos only
  3993. _MAX_RESULTS = float('inf')
  3994. _TESTS = [{
  3995. 'url': 'ytsearch10:youtube-dl test video',
  3996. 'playlist_count': 10,
  3997. 'info_dict': {
  3998. 'id': 'youtube-dl test video',
  3999. 'title': 'youtube-dl test video',
  4000. },
  4001. }]
  4002. def _get_n_results(self, query, n):
  4003. """Get a specified number of results for a query"""
  4004. entries = itertools.islice(self._search_results(query, self._SEARCH_PARAMS), 0, None if n == float('inf') else n)
  4005. return self.playlist_result(entries, query, query)
  4006. class YoutubeSearchDateIE(YoutubeSearchIE):
  4007. IE_NAME = YoutubeSearchIE.IE_NAME + ':date'
  4008. _SEARCH_KEY = 'ytsearchdate'
  4009. IE_DESC = 'YouTube.com searches, newest videos first'
  4010. _SEARCH_PARAMS = 'CAISAhAB' # Videos only, sorted by date
  4011. _TESTS = [{
  4012. 'url': 'ytsearchdate10:youtube-dl test video',
  4013. 'playlist_count': 10,
  4014. 'info_dict': {
  4015. 'id': 'youtube-dl test video',
  4016. 'title': 'youtube-dl test video',
  4017. },
  4018. }]
  4019. class YoutubeSearchURLIE(YoutubeBaseInfoExtractor):
  4020. IE_DESC = 'YouTube search URLs with sorting and filter support'
  4021. IE_NAME = YoutubeSearchIE.IE_NAME + '_url'
  4022. _VALID_URL = r'https?://(?:www\.)?youtube\.com/results\?(.*?&)?(?:search_query|q)=(?:[^&]+)(?:[&]|$)'
  4023. _TESTS = [{
  4024. 'url': 'https://www.youtube.com/results?baz=bar&search_query=youtube-dl+test+video&filters=video&lclk=video',
  4025. 'playlist_mincount': 5,
  4026. 'info_dict': {
  4027. 'id': 'youtube-dl test video',
  4028. 'title': 'youtube-dl test video',
  4029. },
  4030. 'params': {'playlistend': 5},
  4031. }, {
  4032. 'url': 'https://www.youtube.com/results?q=test&sp=EgQIBBgB',
  4033. 'only_matching': True,
  4034. }]
  4035. def _real_extract(self, url):
  4036. qs = parse_qs(url)
  4037. query = (qs.get('search_query') or qs.get('q'))[-1]
  4038. params = qs.get('sp', ('',))[-1]
  4039. return self.playlist_result(self._search_results(query, params), query, query)
  4040. class YoutubeFeedsInfoExtractor(YoutubeTabIE):
  4041. """
  4042. Base class for feed extractors
  4043. Subclasses must define the _FEED_NAME property.
  4044. """
  4045. _LOGIN_REQUIRED = True
  4046. @property
  4047. def IE_NAME(self):
  4048. return 'youtube:%s' % self._FEED_NAME
  4049. def _real_initialize(self):
  4050. self._login()
  4051. def _real_extract(self, _):
  4052. return self.url_result(
  4053. 'https://www.youtube.com/feed/%s' % self._FEED_NAME,
  4054. ie=YoutubeTabIE.ie_key())
  4055. class YoutubeWatchLaterIE(InfoExtractor):
  4056. IE_NAME = 'youtube:watchlater'
  4057. IE_DESC = 'Youtube watch later list, ":ytwatchlater" for short (requires authentication)'
  4058. _VALID_URL = r':ytwatchlater'
  4059. _TESTS = [{
  4060. 'url': ':ytwatchlater',
  4061. 'only_matching': True,
  4062. }]
  4063. def _real_extract(self, _):
  4064. return self.url_result(
  4065. 'https://www.youtube.com/playlist?list=WL', ie=YoutubeTabIE.ie_key())
  4066. class YoutubeRecommendedIE(YoutubeFeedsInfoExtractor):
  4067. IE_DESC = 'YouTube.com recommended videos, ":ytrec" for short (requires authentication)'
  4068. _VALID_URL = r':ytrec(?:ommended)?'
  4069. _FEED_NAME = 'recommended'
  4070. _TESTS = [{
  4071. 'url': ':ytrec',
  4072. 'only_matching': True,
  4073. }, {
  4074. 'url': ':ytrecommended',
  4075. 'only_matching': True,
  4076. }]
  4077. class YoutubeSubscriptionsIE(YoutubeFeedsInfoExtractor):
  4078. IE_DESC = 'YouTube.com subscriptions feed, "ytsubs" keyword (requires authentication)'
  4079. _VALID_URL = r':ytsubs(?:criptions)?'
  4080. _FEED_NAME = 'subscriptions'
  4081. _TESTS = [{
  4082. 'url': ':ytsubs',
  4083. 'only_matching': True,
  4084. }, {
  4085. 'url': ':ytsubscriptions',
  4086. 'only_matching': True,
  4087. }]
  4088. class YoutubeHistoryIE(YoutubeFeedsInfoExtractor):
  4089. IE_DESC = 'Youtube watch history, ":ythistory" for short (requires authentication)'
  4090. _VALID_URL = r':ythistory'
  4091. _FEED_NAME = 'history'
  4092. _TESTS = [{
  4093. 'url': ':ythistory',
  4094. 'only_matching': True,
  4095. }]
  4096. class YoutubeTruncatedURLIE(InfoExtractor):
  4097. IE_NAME = 'youtube:truncated_url'
  4098. IE_DESC = False # Do not list
  4099. _VALID_URL = r'''(?x)
  4100. (?:https?://)?
  4101. (?:\w+\.)?[yY][oO][uU][tT][uU][bB][eE](?:-nocookie)?\.com/
  4102. (?:watch\?(?:
  4103. feature=[a-z_]+|
  4104. annotation_id=annotation_[^&]+|
  4105. x-yt-cl=[0-9]+|
  4106. hl=[^&]*|
  4107. t=[0-9]+
  4108. )?
  4109. |
  4110. attribution_link\?a=[^&]+
  4111. )
  4112. $
  4113. '''
  4114. _TESTS = [{
  4115. 'url': 'https://www.youtube.com/watch?annotation_id=annotation_3951667041',
  4116. 'only_matching': True,
  4117. }, {
  4118. 'url': 'https://www.youtube.com/watch?',
  4119. 'only_matching': True,
  4120. }, {
  4121. 'url': 'https://www.youtube.com/watch?x-yt-cl=84503534',
  4122. 'only_matching': True,
  4123. }, {
  4124. 'url': 'https://www.youtube.com/watch?feature=foo',
  4125. 'only_matching': True,
  4126. }, {
  4127. 'url': 'https://www.youtube.com/watch?hl=en-GB',
  4128. 'only_matching': True,
  4129. }, {
  4130. 'url': 'https://www.youtube.com/watch?t=2372',
  4131. 'only_matching': True,
  4132. }]
  4133. def _real_extract(self, _):
  4134. raise ExtractorError(
  4135. 'Did you forget to quote the URL? Remember that & is a meta '
  4136. 'character in most shells, so you want to put the URL in quotes, '
  4137. 'like youtube-dl '
  4138. '"https://www.youtube.com/watch?feature=foo&v=BaW_jenozKc" '
  4139. ' or simply youtube-dl BaW_jenozKc .',
  4140. expected=True)
  4141. class YoutubeTruncatedIDIE(InfoExtractor):
  4142. IE_NAME = 'youtube:truncated_id'
  4143. IE_DESC = False # Do not list
  4144. _VALID_URL = r'https?://(?:www\.)?youtube\.com/watch\?v=(?P<id>[0-9A-Za-z_-]{1,10})$'
  4145. _TESTS = [{
  4146. 'url': 'https://www.youtube.com/watch?v=N_708QY7Ob',
  4147. 'only_matching': True,
  4148. }]
  4149. def _real_extract(self, url):
  4150. video_id = self._match_id(url)
  4151. raise ExtractorError(
  4152. 'Incomplete YouTube ID %s. URL %s looks truncated.' % (video_id, url),
  4153. expected=True)