_ Git - youtube-dl/blob - youtube_dl/extractor/youtube.py

   1 # coding: utf-8
   2
   3 from __future__ import unicode_literals
   4
   5
   6 import itertools
   7 import json
   8 import os.path
   9 import random
  10 import re
  11 import time
  12 import traceback
  13
  14 from .common import InfoExtractor, SearchInfoExtractor
  15 from ..jsinterp import JSInterpreter
  16 from ..swfinterp import SWFInterpreter
  17 from ..compat import (
  18     compat_chr,
  19     compat_parse_qs,
  20     compat_urllib_parse_unquote,
  21     compat_urllib_parse_unquote_plus,
  22     compat_urllib_parse_urlencode,
  23     compat_urllib_parse_urlparse,
  24     compat_urlparse,
  25     compat_str,
  26 )
  27 from ..utils import (
  28     clean_html,
  29     error_to_compat_str,
  30     ExtractorError,
  31     float_or_none,
  32     get_element_by_attribute,
  33     get_element_by_id,
  34     int_or_none,
  35     mimetype2ext,
  36     orderedSet,
  37     parse_codecs,
  38     parse_duration,
  39     remove_quotes,
  40     remove_start,
  41     smuggle_url,
  42     str_to_int,
  43     try_get,
  44     unescapeHTML,
  45     unified_strdate,
  46     unsmuggle_url,
  47     uppercase_escape,
  48     urlencode_postdata,
  49 )
  50
  51
  52 class YoutubeBaseInfoExtractor(InfoExtractor):
  53     """Provide base functions for Youtube extractors"""
  54     _LOGIN_URL = 'https://accounts.google.com/ServiceLogin'
  55     _TWOFACTOR_URL = 'https://accounts.google.com/signin/challenge'
  56
  57     _LOOKUP_URL = 'https://accounts.google.com/_/signin/sl/lookup'
  58     _CHALLENGE_URL = 'https://accounts.google.com/_/signin/sl/challenge'
  59     _TFA_URL = 'https://accounts.google.com/_/signin/challenge?hl=en&TL={0}'
  60
  61     _NETRC_MACHINE = 'youtube'
  62     # If True it will raise an error if no login info is provided
  63     _LOGIN_REQUIRED = False
  64
  65     _PLAYLIST_ID_RE = r'(?:PL|LL|EC|UU|FL|RD|UL|TL)[0-9A-Za-z-_]{10,}'
  66
  67     def _set_language(self):
  68         self._set_cookie(
  69             '.youtube.com', 'PREF', 'f1=50000000&hl=en',
  70             # YouTube sets the expire time to about two months
  71             expire_time=time.time() + 2 * 30 * 24 * 3600)
  72
  73     def _ids_to_results(self, ids):
  74         return [
  75             self.url_result(vid_id, 'Youtube', video_id=vid_id)
  76             for vid_id in ids]
  77
  78     def _login(self):
  79         """
  80         Attempt to log in to YouTube.
  81         True is returned if successful or skipped.
  82         False is returned if login failed.
  83
  84         If _LOGIN_REQUIRED is set and no authentication was provided, an error is raised.
  85         """
  86         (username, password) = self._get_login_info()
  87         # No authentication to be performed
  88         if username is None:
  89             if self._LOGIN_REQUIRED:
  90                 raise ExtractorError('No login info available, needed for using %s.' % self.IE_NAME, expected=True)
  91             return True
  92
  93         login_page = self._download_webpage(
  94             self._LOGIN_URL, None,
  95             note='Downloading login page',
  96             errnote='unable to fetch login page', fatal=False)
  97         if login_page is False:
  98             return
  99
 100         login_form = self._hidden_inputs(login_page)
 101
 102         def req(url, f_req, note, errnote):
 103             data = login_form.copy()
 104             data.update({
 105                 'pstMsg': 1,
 106                 'checkConnection': 'youtube',
 107                 'checkedDomains': 'youtube',
 108                 'hl': 'en',
 109                 'deviceinfo': '[null,null,null,[],null,"US",null,null,[],"GlifWebSignIn",null,[null,null,[]]]',
 110                 'f.req': json.dumps(f_req),
 111                 'flowName': 'GlifWebSignIn',
 112                 'flowEntry': 'ServiceLogin',
 113             })
 114             return self._download_json(
 115                 url, None, note=note, errnote=errnote,
 116                 transform_source=lambda s: re.sub(r'^[^[]*', '', s),
 117                 fatal=False,
 118                 data=urlencode_postdata(data), headers={
 119                     'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8',
 120                     'Google-Accounts-XSRF': 1,
 121                 })
 122
 123         def warn(message):
 124             self._downloader.report_warning(message)
 125
 126         lookup_req = [
 127             username,
 128             None, [], None, 'US', None, None, 2, False, True,
 129             [
 130                 None, None,
 131                 [2, 1, None, 1,
 132                  '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',
 133                  None, [], 4],
 134                 1, [None, None, []], None, None, None, True
 135             ],
 136             username,
 137         ]
 138
 139         lookup_results = req(
 140             self._LOOKUP_URL, lookup_req,
 141             'Looking up account info', 'Unable to look up account info')
 142
 143         if lookup_results is False:
 144             return False
 145
 146         user_hash = try_get(lookup_results, lambda x: x[0][2], compat_str)
 147         if not user_hash:
 148             warn('Unable to extract user hash')
 149             return False
 150
 151         challenge_req = [
 152             user_hash,
 153             None, 1, None, [1, None, None, None, [password, None, True]],
 154             [
 155                 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],
 156                 1, [None, None, []], None, None, None, True
 157             ]]
 158
 159         challenge_results = req(
 160             self._CHALLENGE_URL, challenge_req,
 161             'Logging in', 'Unable to log in')
 162
 163         if challenge_results is False:
 164             return
 165
 166         login_res = try_get(challenge_results, lambda x: x[0][5], list)
 167         if login_res:
 168             login_msg = try_get(login_res, lambda x: x[5], compat_str)
 169             warn(
 170                 'Unable to login: %s' % 'Invalid password'
 171                 if login_msg == 'INCORRECT_ANSWER_ENTERED' else login_msg)
 172             return False
 173
 174         res = try_get(challenge_results, lambda x: x[0][-1], list)
 175         if not res:
 176             warn('Unable to extract result entry')
 177             return False
 178
 179         tfa = try_get(res, lambda x: x[0][0], list)
 180         if tfa:
 181             tfa_str = try_get(tfa, lambda x: x[2], compat_str)
 182             if tfa_str == 'TWO_STEP_VERIFICATION':
 183                 # SEND_SUCCESS - TFA code has been successfully sent to phone
 184                 # QUOTA_EXCEEDED - reached the limit of TFA codes
 185                 status = try_get(tfa, lambda x: x[5], compat_str)
 186                 if status == 'QUOTA_EXCEEDED':
 187                     warn('Exceeded the limit of TFA codes, try later')
 188                     return False
 189
 190                 tl = try_get(challenge_results, lambda x: x[1][2], compat_str)
 191                 if not tl:
 192                     warn('Unable to extract TL')
 193                     return False
 194
 195                 tfa_code = self._get_tfa_info('2-step verification code')
 196
 197                 if not tfa_code:
 198                     warn(
 199                         'Two-factor authentication required. Provide it either interactively or with --twofactor <code>'
 200                         '(Note that only TOTP (Google Authenticator App) codes work at this time.)')
 201                     return False
 202
 203                 tfa_code = remove_start(tfa_code, 'G-')
 204
 205                 tfa_req = [
 206                     user_hash, None, 2, None,
 207                     [
 208                         9, None, None, None, None, None, None, None,
 209                         [None, tfa_code, True, 2]
 210                     ]]
 211
 212                 tfa_results = req(
 213                     self._TFA_URL.format(tl), tfa_req,
 214                     'Submitting TFA code', 'Unable to submit TFA code')
 215
 216                 if tfa_results is False:
 217                     return False
 218
 219                 tfa_res = try_get(tfa_results, lambda x: x[0][5], list)
 220                 if tfa_res:
 221                     tfa_msg = try_get(tfa_res, lambda x: x[5], compat_str)
 222                     warn(
 223                         'Unable to finish TFA: %s' % 'Invalid TFA code'
 224                         if tfa_msg == 'INCORRECT_ANSWER_ENTERED' else tfa_msg)
 225                     return False
 226
 227                 check_cookie_url = try_get(
 228                     tfa_results, lambda x: x[0][-1][2], compat_str)
 229         else:
 230             check_cookie_url = try_get(res, lambda x: x[2], compat_str)
 231
 232         if not check_cookie_url:
 233             warn('Unable to extract CheckCookie URL')
 234             return False
 235
 236         check_cookie_results = self._download_webpage(
 237             check_cookie_url, None, 'Checking cookie', fatal=False)
 238
 239         if check_cookie_results is False:
 240             return False
 241
 242         if 'https://myaccount.google.com/' not in check_cookie_results:
 243             warn('Unable to log in')
 244             return False
 245
 246         return True
 247
 248     def _real_initialize(self):
 249         if self._downloader is None:
 250             return
 251         self._set_language()
 252         if not self._login():
 253             return
 254
 255
 256 class YoutubeEntryListBaseInfoExtractor(YoutubeBaseInfoExtractor):
 257     # Extract entries from page with "Load more" button
 258     def _entries(self, page, playlist_id):
 259         more_widget_html = content_html = page
 260         for page_num in itertools.count(1):
 261             for entry in self._process_page(content_html):
 262                 yield entry
 263
 264             mobj = re.search(r'data-uix-load-more-href="/?(?P<more>[^"]+)"', more_widget_html)
 265             if not mobj:
 266                 break
 267
 268             more = self._download_json(
 269                 'https://youtube.com/%s' % mobj.group('more'), playlist_id,
 270                 'Downloading page #%s' % page_num,
 271                 transform_source=uppercase_escape)
 272             content_html = more['content_html']
 273             if not content_html.strip():
 274                 # Some webpages show a "Load more" button but they don't
 275                 # have more videos
 276                 break
 277             more_widget_html = more['load_more_widget_html']
 278
 279
 280 class YoutubePlaylistBaseInfoExtractor(YoutubeEntryListBaseInfoExtractor):
 281     def _process_page(self, content):
 282         for video_id, video_title in self.extract_videos_from_page(content):
 283             yield self.url_result(video_id, 'Youtube', video_id, video_title)
 284
 285     def extract_videos_from_page(self, page):
 286         ids_in_page = []
 287         titles_in_page = []
 288         for mobj in re.finditer(self._VIDEO_RE, page):
 289             # The link with index 0 is not the first video of the playlist (not sure if still actual)
 290             if 'index' in mobj.groupdict() and mobj.group('id') == '0':
 291                 continue
 292             video_id = mobj.group('id')
 293             video_title = unescapeHTML(mobj.group('title'))
 294             if video_title:
 295                 video_title = video_title.strip()
 296             try:
 297                 idx = ids_in_page.index(video_id)
 298                 if video_title and not titles_in_page[idx]:
 299                     titles_in_page[idx] = video_title
 300             except ValueError:
 301                 ids_in_page.append(video_id)
 302                 titles_in_page.append(video_title)
 303         return zip(ids_in_page, titles_in_page)
 304
 305
 306 class YoutubePlaylistsBaseInfoExtractor(YoutubeEntryListBaseInfoExtractor):
 307     def _process_page(self, content):
 308         for playlist_id in orderedSet(re.findall(
 309                 r'<h3[^>]+class="[^"]*yt-lockup-title[^"]*"[^>]*><a[^>]+href="/?playlist\?list=([0-9A-Za-z-_]{10,})"',
 310                 content)):
 311             yield self.url_result(
 312                 'https://www.youtube.com/playlist?list=%s' % playlist_id, 'YoutubePlaylist')
 313
 314     def _real_extract(self, url):
 315         playlist_id = self._match_id(url)
 316         webpage = self._download_webpage(url, playlist_id)
 317         title = self._og_search_title(webpage, fatal=False)
 318         return self.playlist_result(self._entries(webpage, playlist_id), playlist_id, title)
 319
 320
 321 class YoutubeIE(YoutubeBaseInfoExtractor):
 322     IE_DESC = 'YouTube.com'
 323     _VALID_URL = r"""(?x)^
 324                      (
 325                          (?:https?://|//)                                    # http(s):// or protocol-independent URL
 326                          (?:(?:(?:(?:\w+\.)?[yY][oO][uU][tT][uU][bB][eE](?:-nocookie)?\.com/|
 327                             (?:www\.)?deturl\.com/www\.youtube\.com/|
 328                             (?:www\.)?pwnyoutube\.com/|
 329                             (?:www\.)?yourepeat\.com/|
 330                             tube\.majestyc\.net/|
 331                             youtube\.googleapis\.com/)                        # the various hostnames, with wildcard subdomains
 332                          (?:.*?\#/)?                                          # handle anchor (#/) redirect urls
 333                          (?:                                                  # the various things that can precede the ID:
 334                              (?:(?:v|embed|e)/(?!videoseries))                # v/ or embed/ or e/
 335                              |(?:                                             # or the v= param in all its forms
 336                                  (?:(?:watch|movie)(?:_popup)?(?:\.php)?/?)?  # preceding watch(_popup|.php) or nothing (like /?v=xxxx)
 337                                  (?:\?|\#!?)                                  # the params delimiter ? or # or #!
 338                                  (?:.*?[&;])??                                # any other preceding param (like /?s=tuff&v=xxxx or ?s=tuff&amp;v=V36LpHqtcDY)
 339                                  v=
 340                              )
 341                          ))
 342                          |(?:
 343                             youtu\.be|                                        # just youtu.be/xxxx
 344                             vid\.plus|                                        # or vid.plus/xxxx
 345                             zwearz\.com/watch|                                # or zwearz.com/watch/xxxx
 346                          )/
 347                          |(?:www\.)?cleanvideosearch\.com/media/action/yt/watch\?videoId=
 348                          )
 349                      )?                                                       # all until now is optional -> you can pass the naked ID
 350                      ([0-9A-Za-z_-]{11})                                      # here is it! the YouTube video ID
 351                      (?!.*?\blist=
 352                         (?:
 353                             %(playlist_id)s|                                  # combined list/video URLs are handled by the playlist IE
 354                             WL                                                # WL are handled by the watch later IE
 355                         )
 356                      )
 357                      (?(1).+)?                                                # if we found the ID, everything can follow
 358                      $""" % {'playlist_id': YoutubeBaseInfoExtractor._PLAYLIST_ID_RE}
 359     _NEXT_URL_RE = r'[\?&]next_url=([^&]+)'
 360     _formats = {
 361         '5': {'ext': 'flv', 'width': 400, 'height': 240, 'acodec': 'mp3', 'abr': 64, 'vcodec': 'h263'},
 362         '6': {'ext': 'flv', 'width': 450, 'height': 270, 'acodec': 'mp3', 'abr': 64, 'vcodec': 'h263'},
 363         '13': {'ext': '3gp', 'acodec': 'aac', 'vcodec': 'mp4v'},
 364         '17': {'ext': '3gp', 'width': 176, 'height': 144, 'acodec': 'aac', 'abr': 24, 'vcodec': 'mp4v'},
 365         '18': {'ext': 'mp4', 'width': 640, 'height': 360, 'acodec': 'aac', 'abr': 96, 'vcodec': 'h264'},
 366         '22': {'ext': 'mp4', 'width': 1280, 'height': 720, 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264'},
 367         '34': {'ext': 'flv', 'width': 640, 'height': 360, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
 368         '35': {'ext': 'flv', 'width': 854, 'height': 480, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
 369         # itag 36 videos are either 320x180 (BaW_jenozKc) or 320x240 (__2ABJjxzNo), abr varies as well
 370         '36': {'ext': '3gp', 'width': 320, 'acodec': 'aac', 'vcodec': 'mp4v'},
 371         '37': {'ext': 'mp4', 'width': 1920, 'height': 1080, 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264'},
 372         '38': {'ext': 'mp4', 'width': 4096, 'height': 3072, 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264'},
 373         '43': {'ext': 'webm', 'width': 640, 'height': 360, 'acodec': 'vorbis', 'abr': 128, 'vcodec': 'vp8'},
 374         '44': {'ext': 'webm', 'width': 854, 'height': 480, 'acodec': 'vorbis', 'abr': 128, 'vcodec': 'vp8'},
 375         '45': {'ext': 'webm', 'width': 1280, 'height': 720, 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8'},
 376         '46': {'ext': 'webm', 'width': 1920, 'height': 1080, 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8'},
 377         '59': {'ext': 'mp4', 'width': 854, 'height': 480, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
 378         '78': {'ext': 'mp4', 'width': 854, 'height': 480, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
 379
 380
 381         # 3D videos
 382         '82': {'ext': 'mp4', 'height': 360, 'format_note': '3D', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -20},
 383         '83': {'ext': 'mp4', 'height': 480, 'format_note': '3D', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -20},
 384         '84': {'ext': 'mp4', 'height': 720, 'format_note': '3D', 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264', 'preference': -20},
 385         '85': {'ext': 'mp4', 'height': 1080, 'format_note': '3D', 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264', 'preference': -20},
 386         '100': {'ext': 'webm', 'height': 360, 'format_note': '3D', 'acodec': 'vorbis', 'abr': 128, 'vcodec': 'vp8', 'preference': -20},
 387         '101': {'ext': 'webm', 'height': 480, 'format_note': '3D', 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8', 'preference': -20},
 388         '102': {'ext': 'webm', 'height': 720, 'format_note': '3D', 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8', 'preference': -20},
 389
 390         # Apple HTTP Live Streaming
 391         '91': {'ext': 'mp4', 'height': 144, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 48, 'vcodec': 'h264', 'preference': -10},
 392         '92': {'ext': 'mp4', 'height': 240, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 48, 'vcodec': 'h264', 'preference': -10},
 393         '93': {'ext': 'mp4', 'height': 360, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -10},
 394         '94': {'ext': 'mp4', 'height': 480, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -10},
 395         '95': {'ext': 'mp4', 'height': 720, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 256, 'vcodec': 'h264', 'preference': -10},
 396         '96': {'ext': 'mp4', 'height': 1080, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 256, 'vcodec': 'h264', 'preference': -10},
 397         '132': {'ext': 'mp4', 'height': 240, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 48, 'vcodec': 'h264', 'preference': -10},
 398         '151': {'ext': 'mp4', 'height': 72, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 24, 'vcodec': 'h264', 'preference': -10},
 399
 400         # DASH mp4 video
 401         '133': {'ext': 'mp4', 'height': 240, 'format_note': 'DASH video', 'vcodec': 'h264'},
 402         '134': {'ext': 'mp4', 'height': 360, 'format_note': 'DASH video', 'vcodec': 'h264'},
 403         '135': {'ext': 'mp4', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'h264'},
 404         '136': {'ext': 'mp4', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'h264'},
 405         '137': {'ext': 'mp4', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'h264'},
 406         '138': {'ext': 'mp4', 'format_note': 'DASH video', 'vcodec': 'h264'},  # Height can vary (https://github.com/rg3/youtube-dl/issues/4559)
 407         '160': {'ext': 'mp4', 'height': 144, 'format_note': 'DASH video', 'vcodec': 'h264'},
 408         '212': {'ext': 'mp4', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'h264'},
 409         '264': {'ext': 'mp4', 'height': 1440, 'format_note': 'DASH video', 'vcodec': 'h264'},
 410         '298': {'ext': 'mp4', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'h264', 'fps': 60},
 411         '299': {'ext': 'mp4', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'h264', 'fps': 60},
 412         '266': {'ext': 'mp4', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'h264'},
 413
 414         # Dash mp4 audio
 415         '139': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'abr': 48, 'container': 'm4a_dash'},
 416         '140': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'abr': 128, 'container': 'm4a_dash'},
 417         '141': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'abr': 256, 'container': 'm4a_dash'},
 418         '256': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'container': 'm4a_dash'},
 419         '258': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'container': 'm4a_dash'},
 420         '325': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'dtse', 'container': 'm4a_dash'},
 421         '328': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'ec-3', 'container': 'm4a_dash'},
 422
 423         # Dash webm
 424         '167': {'ext': 'webm', 'height': 360, 'width': 640, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
 425         '168': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
 426         '169': {'ext': 'webm', 'height': 720, 'width': 1280, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
 427         '170': {'ext': 'webm', 'height': 1080, 'width': 1920, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
 428         '218': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
 429         '219': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8'},
 430         '278': {'ext': 'webm', 'height': 144, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp9'},
 431         '242': {'ext': 'webm', 'height': 240, 'format_note': 'DASH video', 'vcodec': 'vp9'},
 432         '243': {'ext': 'webm', 'height': 360, 'format_note': 'DASH video', 'vcodec': 'vp9'},
 433         '244': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'vp9'},
 434         '245': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'vp9'},
 435         '246': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'vp9'},
 436         '247': {'ext': 'webm', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'vp9'},
 437         '248': {'ext': 'webm', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'vp9'},
 438         '271': {'ext': 'webm', 'height': 1440, 'format_note': 'DASH video', 'vcodec': 'vp9'},
 439         # itag 272 videos are either 3840x2160 (e.g. RtoitU2A-3E) or 7680x4320 (sLprVF6d7Ug)
 440         '272': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'vp9'},
 441         '302': {'ext': 'webm', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60},
 442         '303': {'ext': 'webm', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60},
 443         '308': {'ext': 'webm', 'height': 1440, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60},
 444         '313': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'vp9'},
 445         '315': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60},
 446
 447         # Dash webm audio
 448         '171': {'ext': 'webm', 'acodec': 'vorbis', 'format_note': 'DASH audio', 'abr': 128},
 449         '172': {'ext': 'webm', 'acodec': 'vorbis', 'format_note': 'DASH audio', 'abr': 256},
 450
 451         # Dash webm audio with opus inside
 452         '249': {'ext': 'webm', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 50},
 453         '250': {'ext': 'webm', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 70},
 454         '251': {'ext': 'webm', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 160},
 455
 456         # RTMP (unnamed)
 457         '_rtmp': {'protocol': 'rtmp'},
 458     }
 459     _SUBTITLE_FORMATS = ('ttml', 'vtt')
 460
 461     _GEO_BYPASS = False
 462
 463     IE_NAME = 'youtube'
 464     _TESTS = [
 465         {
 466             'url': 'https://www.youtube.com/watch?v=BaW_jenozKc&t=1s&end=9',
 467             'info_dict': {
 468                 'id': 'BaW_jenozKc',
 469                 'ext': 'mp4',
 470                 'title': 'youtube-dl test video "\'/\\ä↭𝕐',
 471                 'uploader': 'Philipp Hagemeister',
 472                 'uploader_id': 'phihag',
 473                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/phihag',
 474                 'upload_date': '20121002',
 475                 'license': 'Standard YouTube License',
 476                 '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 .',
 477                 'categories': ['Science & Technology'],
 478                 'tags': ['youtube-dl'],
 479                 'duration': 10,
 480                 'like_count': int,
 481                 'dislike_count': int,
 482                 'start_time': 1,
 483                 'end_time': 9,
 484             }
 485         },
 486         {
 487             'url': 'https://www.youtube.com/watch?v=UxxajLWwzqY',
 488             'note': 'Test generic use_cipher_signature video (#897)',
 489             'info_dict': {
 490                 'id': 'UxxajLWwzqY',
 491                 'ext': 'mp4',
 492                 'upload_date': '20120506',
 493                 'title': 'Icona Pop - I Love It (feat. Charli XCX) [OFFICIAL VIDEO]',
 494                 'alt_title': 'I Love It (feat. Charli XCX)',
 495                 'description': 'md5:f3ceb5ef83a08d95b9d146f973157cc8',
 496                 'tags': ['Icona Pop i love it', 'sweden', 'pop music', 'big beat records', 'big beat', 'charli',
 497                          'xcx', 'charli xcx', 'girls', 'hbo', 'i love it', "i don't care", 'icona', 'pop',
 498                          'iconic ep', 'iconic', 'love', 'it'],
 499                 'duration': 180,
 500                 'uploader': 'Icona Pop',
 501                 'uploader_id': 'IconaPop',
 502                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/IconaPop',
 503                 'license': 'Standard YouTube License',
 504                 'creator': 'Icona Pop',
 505             }
 506         },
 507         {
 508             'url': 'https://www.youtube.com/watch?v=07FYdnEawAQ',
 509             'note': 'Test VEVO video with age protection (#956)',
 510             'info_dict': {
 511                 'id': '07FYdnEawAQ',
 512                 'ext': 'mp4',
 513                 'upload_date': '20130703',
 514                 'title': 'Justin Timberlake - Tunnel Vision (Explicit)',
 515                 'alt_title': 'Tunnel Vision',
 516                 'description': 'md5:64249768eec3bc4276236606ea996373',
 517                 'duration': 419,
 518                 'uploader': 'justintimberlakeVEVO',
 519                 'uploader_id': 'justintimberlakeVEVO',
 520                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/justintimberlakeVEVO',
 521                 'license': 'Standard YouTube License',
 522                 'creator': 'Justin Timberlake',
 523                 'age_limit': 18,
 524             }
 525         },
 526         {
 527             'url': '//www.YouTube.com/watch?v=yZIXLfi8CZQ',
 528             'note': 'Embed-only video (#1746)',
 529             'info_dict': {
 530                 'id': 'yZIXLfi8CZQ',
 531                 'ext': 'mp4',
 532                 'upload_date': '20120608',
 533                 'title': 'Principal Sexually Assaults A Teacher - Episode 117 - 8th June 2012',
 534                 'description': 'md5:09b78bd971f1e3e289601dfba15ca4f7',
 535                 'uploader': 'SET India',
 536                 'uploader_id': 'setindia',
 537                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/setindia',
 538                 'license': 'Standard YouTube License',
 539                 'age_limit': 18,
 540             }
 541         },
 542         {
 543             'url': 'https://www.youtube.com/watch?v=BaW_jenozKc&v=UxxajLWwzqY',
 544             'note': 'Use the first video ID in the URL',
 545             'info_dict': {
 546                 'id': 'BaW_jenozKc',
 547                 'ext': 'mp4',
 548                 'title': 'youtube-dl test video "\'/\\ä↭𝕐',
 549                 'uploader': 'Philipp Hagemeister',
 550                 'uploader_id': 'phihag',
 551                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/phihag',
 552                 'upload_date': '20121002',
 553                 'license': 'Standard YouTube License',
 554                 '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 .',
 555                 'categories': ['Science & Technology'],
 556                 'tags': ['youtube-dl'],
 557                 'duration': 10,
 558                 'like_count': int,
 559                 'dislike_count': int,
 560             },
 561             'params': {
 562                 'skip_download': True,
 563             },
 564         },
 565         {
 566             'url': 'https://www.youtube.com/watch?v=a9LDPn-MO4I',
 567             'note': '256k DASH audio (format 141) via DASH manifest',
 568             'info_dict': {
 569                 'id': 'a9LDPn-MO4I',
 570                 'ext': 'm4a',
 571                 'upload_date': '20121002',
 572                 'uploader_id': '8KVIDEO',
 573                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/8KVIDEO',
 574                 'description': '',
 575                 'uploader': '8KVIDEO',
 576                 'license': 'Standard YouTube License',
 577                 'title': 'UHDTV TEST 8K VIDEO.mp4'
 578             },
 579             'params': {
 580                 'youtube_include_dash_manifest': True,
 581                 'format': '141',
 582             },
 583             'skip': 'format 141 not served anymore',
 584         },
 585         # DASH manifest with encrypted signature
 586         {
 587             'url': 'https://www.youtube.com/watch?v=IB3lcPjvWLA',
 588             'info_dict': {
 589                 'id': 'IB3lcPjvWLA',
 590                 'ext': 'm4a',
 591                 'title': 'Afrojack, Spree Wilson - The Spark ft. Spree Wilson',
 592                 'description': 'md5:12e7067fa6735a77bdcbb58cb1187d2d',
 593                 'duration': 244,
 594                 'uploader': 'AfrojackVEVO',
 595                 'uploader_id': 'AfrojackVEVO',
 596                 'upload_date': '20131011',
 597                 'license': 'Standard YouTube License',
 598             },
 599             'params': {
 600                 'youtube_include_dash_manifest': True,
 601                 'format': '141/bestaudio[ext=m4a]',
 602             },
 603         },
 604         # JS player signature function name containing $
 605         {
 606             'url': 'https://www.youtube.com/watch?v=nfWlot6h_JM',
 607             'info_dict': {
 608                 'id': 'nfWlot6h_JM',
 609                 'ext': 'm4a',
 610                 'title': 'Taylor Swift - Shake It Off',
 611                 'alt_title': 'Shake It Off',
 612                 'description': 'md5:95f66187cd7c8b2c13eb78e1223b63c3',
 613                 'duration': 242,
 614                 'uploader': 'TaylorSwiftVEVO',
 615                 'uploader_id': 'TaylorSwiftVEVO',
 616                 'upload_date': '20140818',
 617                 'license': 'Standard YouTube License',
 618                 'creator': 'Taylor Swift',
 619             },
 620             'params': {
 621                 'youtube_include_dash_manifest': True,
 622                 'format': '141/bestaudio[ext=m4a]',
 623             },
 624         },
 625         # Controversy video
 626         {
 627             'url': 'https://www.youtube.com/watch?v=T4XJQO3qol8',
 628             'info_dict': {
 629                 'id': 'T4XJQO3qol8',
 630                 'ext': 'mp4',
 631                 'duration': 219,
 632                 'upload_date': '20100909',
 633                 'uploader': 'The Amazing Atheist',
 634                 'uploader_id': 'TheAmazingAtheist',
 635                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/TheAmazingAtheist',
 636                 'license': 'Standard YouTube License',
 637                 'title': 'Burning Everyone\'s Koran',
 638                 'description': 'SUBSCRIBE: http://www.youtube.com/saturninefilms\n\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',
 639             }
 640         },
 641         # Normal age-gate video (No vevo, embed allowed)
 642         {
 643             'url': 'https://youtube.com/watch?v=HtVdAasjOgU',
 644             'info_dict': {
 645                 'id': 'HtVdAasjOgU',
 646                 'ext': 'mp4',
 647                 'title': 'The Witcher 3: Wild Hunt - The Sword Of Destiny Trailer',
 648                 'description': r're:(?s).{100,}About the Game\n.*?The Witcher 3: Wild Hunt.{100,}',
 649                 'duration': 142,
 650                 'uploader': 'The Witcher',
 651                 'uploader_id': 'WitcherGame',
 652                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/WitcherGame',
 653                 'upload_date': '20140605',
 654                 'license': 'Standard YouTube License',
 655                 'age_limit': 18,
 656             },
 657         },
 658         # Age-gate video with encrypted signature
 659         {
 660             'url': 'https://www.youtube.com/watch?v=6kLq3WMV1nU',
 661             'info_dict': {
 662                 'id': '6kLq3WMV1nU',
 663                 'ext': 'mp4',
 664                 'title': 'Dedication To My Ex (Miss That) (Lyric Video)',
 665                 'description': 'md5:33765bb339e1b47e7e72b5490139bb41',
 666                 'duration': 247,
 667                 'uploader': 'LloydVEVO',
 668                 'uploader_id': 'LloydVEVO',
 669                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/LloydVEVO',
 670                 'upload_date': '20110629',
 671                 'license': 'Standard YouTube License',
 672                 'age_limit': 18,
 673             },
 674         },
 675         # video_info is None (https://github.com/rg3/youtube-dl/issues/4421)
 676         # YouTube Red ad is not captured for creator
 677         {
 678             'url': '__2ABJjxzNo',
 679             'info_dict': {
 680                 'id': '__2ABJjxzNo',
 681                 'ext': 'mp4',
 682                 'duration': 266,
 683                 'upload_date': '20100430',
 684                 'uploader_id': 'deadmau5',
 685                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/deadmau5',
 686                 'creator': 'deadmau5',
 687                 'description': 'md5:12c56784b8032162bb936a5f76d55360',
 688                 'uploader': 'deadmau5',
 689                 'license': 'Standard YouTube License',
 690                 'title': 'Deadmau5 - Some Chords (HD)',
 691                 'alt_title': 'Some Chords',
 692             },
 693             'expected_warnings': [
 694                 'DASH manifest missing',
 695             ]
 696         },
 697         # Olympics (https://github.com/rg3/youtube-dl/issues/4431)
 698         {
 699             'url': 'lqQg6PlCWgI',
 700             'info_dict': {
 701                 'id': 'lqQg6PlCWgI',
 702                 'ext': 'mp4',
 703                 'duration': 6085,
 704                 'upload_date': '20150827',
 705                 'uploader_id': 'olympic',
 706                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/olympic',
 707                 'license': 'Standard YouTube License',
 708                 'description': 'HO09  - Women -  GER-AUS - Hockey - 31 July 2012 - London 2012 Olympic Games',
 709                 'uploader': 'Olympic',
 710                 'title': 'Hockey - Women -  GER-AUS - London 2012 Olympic Games',
 711             },
 712             'params': {
 713                 'skip_download': 'requires avconv',
 714             }
 715         },
 716         # Non-square pixels
 717         {
 718             'url': 'https://www.youtube.com/watch?v=_b-2C3KPAM0',
 719             'info_dict': {
 720                 'id': '_b-2C3KPAM0',
 721                 'ext': 'mp4',
 722                 'stretched_ratio': 16 / 9.,
 723                 'duration': 85,
 724                 'upload_date': '20110310',
 725                 'uploader_id': 'AllenMeow',
 726                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/AllenMeow',
 727                 'description': 'made by Wacom from Korea | 字幕&加油添醋 by TY\'s Allen | 感謝heylisa00cavey1001同學熱情提供梗及翻譯',
 728                 'uploader': '孫艾倫',
 729                 'license': 'Standard YouTube License',
 730                 'title': '[A-made] 變態妍字幕版 太妍 我就是這樣的人',
 731             },
 732         },
 733         # url_encoded_fmt_stream_map is empty string
 734         {
 735             'url': 'qEJwOuvDf7I',
 736             'info_dict': {
 737                 'id': 'qEJwOuvDf7I',
 738                 'ext': 'webm',
 739                 'title': 'Обсуждение судебной практики по выборам 14 сентября 2014 года в Санкт-Петербурге',
 740                 'description': '',
 741                 'upload_date': '20150404',
 742                 'uploader_id': 'spbelect',
 743                 'uploader': 'Наблюдатели Петербурга',
 744             },
 745             'params': {
 746                 'skip_download': 'requires avconv',
 747             },
 748             'skip': 'This live event has ended.',
 749         },
 750         # Extraction from multiple DASH manifests (https://github.com/rg3/youtube-dl/pull/6097)
 751         {
 752             'url': 'https://www.youtube.com/watch?v=FIl7x6_3R5Y',
 753             'info_dict': {
 754                 'id': 'FIl7x6_3R5Y',
 755                 'ext': 'mp4',
 756                 'title': 'md5:7b81415841e02ecd4313668cde88737a',
 757                 'description': 'md5:116377fd2963b81ec4ce64b542173306',
 758                 'duration': 220,
 759                 'upload_date': '20150625',
 760                 'uploader_id': 'dorappi2000',
 761                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/dorappi2000',
 762                 'uploader': 'dorappi2000',
 763                 'license': 'Standard YouTube License',
 764                 'formats': 'mincount:32',
 765             },
 766         },
 767         # DASH manifest with segment_list
 768         {
 769             'url': 'https://www.youtube.com/embed/CsmdDsKjzN8',
 770             'md5': '8ce563a1d667b599d21064e982ab9e31',
 771             'info_dict': {
 772                 'id': 'CsmdDsKjzN8',
 773                 'ext': 'mp4',
 774                 'upload_date': '20150501',  # According to '<meta itemprop="datePublished"', but in other places it's 20150510
 775                 'uploader': 'Airtek',
 776                 'description': 'Retransmisión en directo de la XVIII media maratón de Zaragoza.',
 777                 'uploader_id': 'UCzTzUmjXxxacNnL8I3m4LnQ',
 778                 'license': 'Standard YouTube License',
 779                 'title': 'Retransmisión XVIII Media maratón Zaragoza 2015',
 780             },
 781             'params': {
 782                 'youtube_include_dash_manifest': True,
 783                 'format': '135',  # bestvideo
 784             },
 785             'skip': 'This live event has ended.',
 786         },
 787         {
 788             # Multifeed videos (multiple cameras), URL is for Main Camera
 789             'url': 'https://www.youtube.com/watch?v=jqWvoWXjCVs',
 790             'info_dict': {
 791                 'id': 'jqWvoWXjCVs',
 792                 'title': 'teamPGP: Rocket League Noob Stream',
 793                 'description': 'md5:dc7872fb300e143831327f1bae3af010',
 794             },
 795             'playlist': [{
 796                 'info_dict': {
 797                     'id': 'jqWvoWXjCVs',
 798                     'ext': 'mp4',
 799                     'title': 'teamPGP: Rocket League Noob Stream (Main Camera)',
 800                     'description': 'md5:dc7872fb300e143831327f1bae3af010',
 801                     'duration': 7335,
 802                     'upload_date': '20150721',
 803                     'uploader': 'Beer Games Beer',
 804                     'uploader_id': 'beergamesbeer',
 805                     'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/beergamesbeer',
 806                     'license': 'Standard YouTube License',
 807                 },
 808             }, {
 809                 'info_dict': {
 810                     'id': '6h8e8xoXJzg',
 811                     'ext': 'mp4',
 812                     'title': 'teamPGP: Rocket League Noob Stream (kreestuh)',
 813                     'description': 'md5:dc7872fb300e143831327f1bae3af010',
 814                     'duration': 7337,
 815                     'upload_date': '20150721',
 816                     'uploader': 'Beer Games Beer',
 817                     'uploader_id': 'beergamesbeer',
 818                     'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/beergamesbeer',
 819                     'license': 'Standard YouTube License',
 820                 },
 821             }, {
 822                 'info_dict': {
 823                     'id': 'PUOgX5z9xZw',
 824                     'ext': 'mp4',
 825                     'title': 'teamPGP: Rocket League Noob Stream (grizzle)',
 826                     'description': 'md5:dc7872fb300e143831327f1bae3af010',
 827                     'duration': 7337,
 828                     'upload_date': '20150721',
 829                     'uploader': 'Beer Games Beer',
 830                     'uploader_id': 'beergamesbeer',
 831                     'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/beergamesbeer',
 832                     'license': 'Standard YouTube License',
 833                 },
 834             }, {
 835                 'info_dict': {
 836                     'id': 'teuwxikvS5k',
 837                     'ext': 'mp4',
 838                     'title': 'teamPGP: Rocket League Noob Stream (zim)',
 839                     'description': 'md5:dc7872fb300e143831327f1bae3af010',
 840                     'duration': 7334,
 841                     'upload_date': '20150721',
 842                     'uploader': 'Beer Games Beer',
 843                     'uploader_id': 'beergamesbeer',
 844                     'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/beergamesbeer',
 845                     'license': 'Standard YouTube License',
 846                 },
 847             }],
 848             'params': {
 849                 'skip_download': True,
 850             },
 851         },
 852         {
 853             # Multifeed video with comma in title (see https://github.com/rg3/youtube-dl/issues/8536)
 854             'url': 'https://www.youtube.com/watch?v=gVfLd0zydlo',
 855             'info_dict': {
 856                 'id': 'gVfLd0zydlo',
 857                 'title': 'DevConf.cz 2016 Day 2 Workshops 1 14:00 - 15:30',
 858             },
 859             'playlist_count': 2,
 860             'skip': 'Not multifeed anymore',
 861         },
 862         {
 863             'url': 'https://vid.plus/FlRa-iH7PGw',
 864             'only_matching': True,
 865         },
 866         {
 867             'url': 'https://zwearz.com/watch/9lWxNJF-ufM/electra-woman-dyna-girl-official-trailer-grace-helbig.html',
 868             'only_matching': True,
 869         },
 870         {
 871             # Title with JS-like syntax "};" (see https://github.com/rg3/youtube-dl/issues/7468)
 872             # Also tests cut-off URL expansion in video description (see
 873             # https://github.com/rg3/youtube-dl/issues/1892,
 874             # https://github.com/rg3/youtube-dl/issues/8164)
 875             'url': 'https://www.youtube.com/watch?v=lsguqyKfVQg',
 876             'info_dict': {
 877                 'id': 'lsguqyKfVQg',
 878                 'ext': 'mp4',
 879                 'title': '{dark walk}; Loki/AC/Dishonored; collab w/Elflover21',
 880                 'alt_title': 'Dark Walk',
 881                 'description': 'md5:8085699c11dc3f597ce0410b0dcbb34a',
 882                 'duration': 133,
 883                 'upload_date': '20151119',
 884                 'uploader_id': 'IronSoulElf',
 885                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/IronSoulElf',
 886                 'uploader': 'IronSoulElf',
 887                 'license': 'Standard YouTube License',
 888                 'creator': 'Todd Haberman, Daniel Law Heath & Aaron Kaplan',
 889             },
 890             'params': {
 891                 'skip_download': True,
 892             },
 893         },
 894         {
 895             # Tags with '};' (see https://github.com/rg3/youtube-dl/issues/7468)
 896             'url': 'https://www.youtube.com/watch?v=Ms7iBXnlUO8',
 897             'only_matching': True,
 898         },
 899         {
 900             # Video with yt:stretch=17:0
 901             'url': 'https://www.youtube.com/watch?v=Q39EVAstoRM',
 902             'info_dict': {
 903                 'id': 'Q39EVAstoRM',
 904                 'ext': 'mp4',
 905                 'title': 'Clash Of Clans#14 Dicas De Ataque Para CV 4',
 906                 'description': 'md5:ee18a25c350637c8faff806845bddee9',
 907                 'upload_date': '20151107',
 908                 'uploader_id': 'UCCr7TALkRbo3EtFzETQF1LA',
 909                 'uploader': 'CH GAMER DROID',
 910             },
 911             'params': {
 912                 'skip_download': True,
 913             },
 914             'skip': 'This video does not exist.',
 915         },
 916         {
 917             # Video licensed under Creative Commons
 918             'url': 'https://www.youtube.com/watch?v=M4gD1WSo5mA',
 919             'info_dict': {
 920                 'id': 'M4gD1WSo5mA',
 921                 'ext': 'mp4',
 922                 'title': 'md5:e41008789470fc2533a3252216f1c1d1',
 923                 'description': 'md5:a677553cf0840649b731a3024aeff4cc',
 924                 'duration': 721,
 925                 'upload_date': '20150127',
 926                 'uploader_id': 'BerkmanCenter',
 927                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/BerkmanCenter',
 928                 'uploader': 'The Berkman Klein Center for Internet & Society',
 929                 'license': 'Creative Commons Attribution license (reuse allowed)',
 930             },
 931             'params': {
 932                 'skip_download': True,
 933             },
 934         },
 935         {
 936             # Channel-like uploader_url
 937             'url': 'https://www.youtube.com/watch?v=eQcmzGIKrzg',
 938             'info_dict': {
 939                 'id': 'eQcmzGIKrzg',
 940                 'ext': 'mp4',
 941                 'title': 'Democratic Socialism and Foreign Policy | Bernie Sanders',
 942                 'description': 'md5:dda0d780d5a6e120758d1711d062a867',
 943                 'duration': 4060,
 944                 'upload_date': '20151119',
 945                 'uploader': 'Bernie 2016',
 946                 'uploader_id': 'UCH1dpzjCEiGAt8CXkryhkZg',
 947                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UCH1dpzjCEiGAt8CXkryhkZg',
 948                 'license': 'Creative Commons Attribution license (reuse allowed)',
 949             },
 950             'params': {
 951                 'skip_download': True,
 952             },
 953         },
 954         {
 955             'url': 'https://www.youtube.com/watch?feature=player_embedded&amp;amp;v=V36LpHqtcDY',
 956             'only_matching': True,
 957         },
 958         {
 959             # YouTube Red paid video (https://github.com/rg3/youtube-dl/issues/10059)
 960             'url': 'https://www.youtube.com/watch?v=i1Ko8UG-Tdo',
 961             'only_matching': True,
 962         },
 963         {
 964             # Rental video preview
 965             'url': 'https://www.youtube.com/watch?v=yYr8q0y5Jfg',
 966             'info_dict': {
 967                 'id': 'uGpuVWrhIzE',
 968                 'ext': 'mp4',
 969                 'title': 'Piku - Trailer',
 970                 'description': 'md5:c36bd60c3fd6f1954086c083c72092eb',
 971                 'upload_date': '20150811',
 972                 'uploader': 'FlixMatrix',
 973                 'uploader_id': 'FlixMatrixKaravan',
 974                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/FlixMatrixKaravan',
 975                 'license': 'Standard YouTube License',
 976             },
 977             'params': {
 978                 'skip_download': True,
 979             },
 980         },
 981         {
 982             # YouTube Red video with episode data
 983             'url': 'https://www.youtube.com/watch?v=iqKdEhx-dD4',
 984             'info_dict': {
 985                 'id': 'iqKdEhx-dD4',
 986                 'ext': 'mp4',
 987                 'title': 'Isolation - Mind Field (Ep 1)',
 988                 'description': 'md5:8013b7ddea787342608f63a13ddc9492',
 989                 'duration': 2085,
 990                 'upload_date': '20170118',
 991                 'uploader': 'Vsauce',
 992                 'uploader_id': 'Vsauce',
 993                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/Vsauce',
 994                 'license': 'Standard YouTube License',
 995                 'series': 'Mind Field',
 996                 'season_number': 1,
 997                 'episode_number': 1,
 998             },
 999             'params': {
1000                 'skip_download': True,
1001             },
1002             'expected_warnings': [
1003                 'Skipping DASH manifest',
1004             ],
1005         },
1006         {
1007             # itag 212
1008             'url': '1t24XAntNCY',
1009             'only_matching': True,
1010         },
1011         {
1012             # geo restricted to JP
1013             'url': 'sJL6WA-aGkQ',
1014             'only_matching': True,
1015         },
1016         {
1017             'url': 'https://www.youtube.com/watch?v=MuAGGZNfUkU&list=RDMM',
1018             'only_matching': True,
1019         },
1020     ]
1021
1022     def __init__(self, *args, **kwargs):
1023         super(YoutubeIE, self).__init__(*args, **kwargs)
1024         self._player_cache = {}
1025
1026     def report_video_info_webpage_download(self, video_id):
1027         """Report attempt to download video info webpage."""
1028         self.to_screen('%s: Downloading video info webpage' % video_id)
1029
1030     def report_information_extraction(self, video_id):
1031         """Report attempt to extract video information."""
1032         self.to_screen('%s: Extracting video information' % video_id)
1033
1034     def report_unavailable_format(self, video_id, format):
1035         """Report extracted video URL."""
1036         self.to_screen('%s: Format %s not available' % (video_id, format))
1037
1038     def report_rtmp_download(self):
1039         """Indicate the download will use the RTMP protocol."""
1040         self.to_screen('RTMP download detected')
1041
1042     def _signature_cache_id(self, example_sig):
1043         """ Return a string representation of a signature """
1044         return '.'.join(compat_str(len(part)) for part in example_sig.split('.'))
1045
1046     def _extract_signature_function(self, video_id, player_url, example_sig):
1047         id_m = re.match(
1048             r'.*?-(?P<id>[a-zA-Z0-9_-]+)(?:/watch_as3|/html5player(?:-new)?|(?:/[a-z]{2}_[A-Z]{2})?/base)?\.(?P<ext>[a-z]+)$',
1049             player_url)
1050         if not id_m:
1051             raise ExtractorError('Cannot identify player %r' % player_url)
1052         player_type = id_m.group('ext')
1053         player_id = id_m.group('id')
1054
1055         # Read from filesystem cache
1056         func_id = '%s_%s_%s' % (
1057             player_type, player_id, self._signature_cache_id(example_sig))
1058         assert os.path.basename(func_id) == func_id
1059
1060         cache_spec = self._downloader.cache.load('youtube-sigfuncs', func_id)
1061         if cache_spec is not None:
1062             return lambda s: ''.join(s[i] for i in cache_spec)
1063
1064         download_note = (
1065             'Downloading player %s' % player_url
1066             if self._downloader.params.get('verbose') else
1067             'Downloading %s player %s' % (player_type, player_id)
1068         )
1069         if player_type == 'js':
1070             code = self._download_webpage(
1071                 player_url, video_id,
1072                 note=download_note,
1073                 errnote='Download of %s failed' % player_url)
1074             res = self._parse_sig_js(code)
1075         elif player_type == 'swf':
1076             urlh = self._request_webpage(
1077                 player_url, video_id,
1078                 note=download_note,
1079                 errnote='Download of %s failed' % player_url)
1080             code = urlh.read()
1081             res = self._parse_sig_swf(code)
1082         else:
1083             assert False, 'Invalid player type %r' % player_type
1084
1085         test_string = ''.join(map(compat_chr, range(len(example_sig))))
1086         cache_res = res(test_string)
1087         cache_spec = [ord(c) for c in cache_res]
1088
1089         self._downloader.cache.store('youtube-sigfuncs', func_id, cache_spec)
1090         return res
1091
1092     def _print_sig_code(self, func, example_sig):
1093         def gen_sig_code(idxs):
1094             def _genslice(start, end, step):
1095                 starts = '' if start == 0 else str(start)
1096                 ends = (':%d' % (end + step)) if end + step >= 0 else ':'
1097                 steps = '' if step == 1 else (':%d' % step)
1098                 return 's[%s%s%s]' % (starts, ends, steps)
1099
1100             step = None
1101             # Quelch pyflakes warnings - start will be set when step is set
1102             start = '(Never used)'
1103             for i, prev in zip(idxs[1:], idxs[:-1]):
1104                 if step is not None:
1105                     if i - prev == step:
1106                         continue
1107                     yield _genslice(start, prev, step)
1108                     step = None
1109                     continue
1110                 if i - prev in [-1, 1]:
1111                     step = i - prev
1112                     start = prev
1113                     continue
1114                 else:
1115                     yield 's[%d]' % prev
1116             if step is None:
1117                 yield 's[%d]' % i
1118             else:
1119                 yield _genslice(start, i, step)
1120
1121         test_string = ''.join(map(compat_chr, range(len(example_sig))))
1122         cache_res = func(test_string)
1123         cache_spec = [ord(c) for c in cache_res]
1124         expr_code = ' + '.join(gen_sig_code(cache_spec))
1125         signature_id_tuple = '(%s)' % (
1126             ', '.join(compat_str(len(p)) for p in example_sig.split('.')))
1127         code = ('if tuple(len(p) for p in s.split(\'.\')) == %s:\n'
1128                 '    return %s\n') % (signature_id_tuple, expr_code)
1129         self.to_screen('Extracted signature function:\n' + code)
1130
1131     def _parse_sig_js(self, jscode):
1132         funcname = self._search_regex(
1133             (r'(["\'])signature\1\s*,\s*(?P<sig>[a-zA-Z0-9$]+)\(',
1134              r'\.sig\|\|(?P<sig>[a-zA-Z0-9$]+)\('),
1135             jscode, 'Initial JS player signature function name', group='sig')
1136
1137         jsi = JSInterpreter(jscode)
1138         initial_function = jsi.extract_function(funcname)
1139         return lambda s: initial_function([s])
1140
1141     def _parse_sig_swf(self, file_contents):
1142         swfi = SWFInterpreter(file_contents)
1143         TARGET_CLASSNAME = 'SignatureDecipher'
1144         searched_class = swfi.extract_class(TARGET_CLASSNAME)
1145         initial_function = swfi.extract_function(searched_class, 'decipher')
1146         return lambda s: initial_function([s])
1147
1148     def _decrypt_signature(self, s, video_id, player_url, age_gate=False):
1149         """Turn the encrypted s field into a working signature"""
1150
1151         if player_url is None:
1152             raise ExtractorError('Cannot decrypt signature without player_url')
1153
1154         if player_url.startswith('//'):
1155             player_url = 'https:' + player_url
1156         elif not re.match(r'https?://', player_url):
1157             player_url = compat_urlparse.urljoin(
1158                 'https://www.youtube.com', player_url)
1159         try:
1160             player_id = (player_url, self._signature_cache_id(s))
1161             if player_id not in self._player_cache:
1162                 func = self._extract_signature_function(
1163                     video_id, player_url, s
1164                 )
1165                 self._player_cache[player_id] = func
1166             func = self._player_cache[player_id]
1167             if self._downloader.params.get('youtube_print_sig_code'):
1168                 self._print_sig_code(func, s)
1169             return func(s)
1170         except Exception as e:
1171             tb = traceback.format_exc()
1172             raise ExtractorError(
1173                 'Signature extraction failed: ' + tb, cause=e)
1174
1175     def _get_subtitles(self, video_id, webpage):
1176         try:
1177             subs_doc = self._download_xml(
1178                 'https://video.google.com/timedtext?hl=en&type=list&v=%s' % video_id,
1179                 video_id, note=False)
1180         except ExtractorError as err:
1181             self._downloader.report_warning('unable to download video subtitles: %s' % error_to_compat_str(err))
1182             return {}
1183
1184         sub_lang_list = {}
1185         for track in subs_doc.findall('track'):
1186             lang = track.attrib['lang_code']
1187             if lang in sub_lang_list:
1188                 continue
1189             sub_formats = []
1190             for ext in self._SUBTITLE_FORMATS:
1191                 params = compat_urllib_parse_urlencode({
1192                     'lang': lang,
1193                     'v': video_id,
1194                     'fmt': ext,
1195                     'name': track.attrib['name'].encode('utf-8'),
1196                 })
1197                 sub_formats.append({
1198                     'url': 'https://www.youtube.com/api/timedtext?' + params,
1199                     'ext': ext,
1200                 })
1201             sub_lang_list[lang] = sub_formats
1202         if not sub_lang_list:
1203             self._downloader.report_warning('video doesn\'t have subtitles')
1204             return {}
1205         return sub_lang_list
1206
1207     def _get_ytplayer_config(self, video_id, webpage):
1208         patterns = (
1209             # User data may contain arbitrary character sequences that may affect
1210             # JSON extraction with regex, e.g. when '};' is contained the second
1211             # regex won't capture the whole JSON. Yet working around by trying more
1212             # concrete regex first keeping in mind proper quoted string handling
1213             # to be implemented in future that will replace this workaround (see
1214             # https://github.com/rg3/youtube-dl/issues/7468,
1215             # https://github.com/rg3/youtube-dl/pull/7599)
1216             r';ytplayer\.config\s*=\s*({.+?});ytplayer',
1217             r';ytplayer\.config\s*=\s*({.+?});',
1218         )
1219         config = self._search_regex(
1220             patterns, webpage, 'ytplayer.config', default=None)
1221         if config:
1222             return self._parse_json(
1223                 uppercase_escape(config), video_id, fatal=False)
1224
1225     def _get_automatic_captions(self, video_id, webpage):
1226         """We need the webpage for getting the captions url, pass it as an
1227            argument to speed up the process."""
1228         self.to_screen('%s: Looking for automatic captions' % video_id)
1229         player_config = self._get_ytplayer_config(video_id, webpage)
1230         err_msg = 'Couldn\'t find automatic captions for %s' % video_id
1231         if not player_config:
1232             self._downloader.report_warning(err_msg)
1233             return {}
1234         try:
1235             args = player_config['args']
1236             caption_url = args.get('ttsurl')
1237             if caption_url:
1238                 timestamp = args['timestamp']
1239                 # We get the available subtitles
1240                 list_params = compat_urllib_parse_urlencode({
1241                     'type': 'list',
1242                     'tlangs': 1,
1243                     'asrs': 1,
1244                 })
1245                 list_url = caption_url + '&' + list_params
1246                 caption_list = self._download_xml(list_url, video_id)
1247                 original_lang_node = caption_list.find('track')
1248                 if original_lang_node is None:
1249                     self._downloader.report_warning('Video doesn\'t have automatic captions')
1250                     return {}
1251                 original_lang = original_lang_node.attrib['lang_code']
1252                 caption_kind = original_lang_node.attrib.get('kind', '')
1253
1254                 sub_lang_list = {}
1255                 for lang_node in caption_list.findall('target'):
1256                     sub_lang = lang_node.attrib['lang_code']
1257                     sub_formats = []
1258                     for ext in self._SUBTITLE_FORMATS:
1259                         params = compat_urllib_parse_urlencode({
1260                             'lang': original_lang,
1261                             'tlang': sub_lang,
1262                             'fmt': ext,
1263                             'ts': timestamp,
1264                             'kind': caption_kind,
1265                         })
1266                         sub_formats.append({
1267                             'url': caption_url + '&' + params,
1268                             'ext': ext,
1269                         })
1270                     sub_lang_list[sub_lang] = sub_formats
1271                 return sub_lang_list
1272
1273             def make_captions(sub_url, sub_langs):
1274                 parsed_sub_url = compat_urllib_parse_urlparse(sub_url)
1275                 caption_qs = compat_parse_qs(parsed_sub_url.query)
1276                 captions = {}
1277                 for sub_lang in sub_langs:
1278                     sub_formats = []
1279                     for ext in self._SUBTITLE_FORMATS:
1280                         caption_qs.update({
1281                             'tlang': [sub_lang],
1282                             'fmt': [ext],
1283                         })
1284                         sub_url = compat_urlparse.urlunparse(parsed_sub_url._replace(
1285                             query=compat_urllib_parse_urlencode(caption_qs, True)))
1286                         sub_formats.append({
1287                             'url': sub_url,
1288                             'ext': ext,
1289                         })
1290                     captions[sub_lang] = sub_formats
1291                 return captions
1292
1293             # New captions format as of 22.06.2017
1294             player_response = args.get('player_response')
1295             if player_response and isinstance(player_response, compat_str):
1296                 player_response = self._parse_json(
1297                     player_response, video_id, fatal=False)
1298                 if player_response:
1299                     renderer = player_response['captions']['playerCaptionsTracklistRenderer']
1300                     base_url = renderer['captionTracks'][0]['baseUrl']
1301                     sub_lang_list = []
1302                     for lang in renderer['translationLanguages']:
1303                         lang_code = lang.get('languageCode')
1304                         if lang_code:
1305                             sub_lang_list.append(lang_code)
1306                     return make_captions(base_url, sub_lang_list)
1307
1308             # Some videos don't provide ttsurl but rather caption_tracks and
1309             # caption_translation_languages (e.g. 20LmZk1hakA)
1310             # Does not used anymore as of 22.06.2017
1311             caption_tracks = args['caption_tracks']
1312             caption_translation_languages = args['caption_translation_languages']
1313             caption_url = compat_parse_qs(caption_tracks.split(',')[0])['u'][0]
1314             sub_lang_list = []
1315             for lang in caption_translation_languages.split(','):
1316                 lang_qs = compat_parse_qs(compat_urllib_parse_unquote_plus(lang))
1317                 sub_lang = lang_qs.get('lc', [None])[0]
1318                 if sub_lang:
1319                     sub_lang_list.append(sub_lang)
1320             return make_captions(caption_url, sub_lang_list)
1321         # An extractor error can be raise by the download process if there are
1322         # no automatic captions but there are subtitles
1323         except (KeyError, IndexError, ExtractorError):
1324             self._downloader.report_warning(err_msg)
1325             return {}
1326
1327     def _mark_watched(self, video_id, video_info):
1328         playback_url = video_info.get('videostats_playback_base_url', [None])[0]
1329         if not playback_url:
1330             return
1331         parsed_playback_url = compat_urlparse.urlparse(playback_url)
1332         qs = compat_urlparse.parse_qs(parsed_playback_url.query)
1333
1334         # cpn generation algorithm is reverse engineered from base.js.
1335         # In fact it works even with dummy cpn.
1336         CPN_ALPHABET = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_'
1337         cpn = ''.join((CPN_ALPHABET[random.randint(0, 256) & 63] for _ in range(0, 16)))
1338
1339         qs.update({
1340             'ver': ['2'],
1341             'cpn': [cpn],
1342         })
1343         playback_url = compat_urlparse.urlunparse(
1344             parsed_playback_url._replace(query=compat_urllib_parse_urlencode(qs, True)))
1345
1346         self._download_webpage(
1347             playback_url, video_id, 'Marking watched',
1348             'Unable to mark watched', fatal=False)
1349
1350     @classmethod
1351     def extract_id(cls, url):
1352         mobj = re.match(cls._VALID_URL, url, re.VERBOSE)
1353         if mobj is None:
1354             raise ExtractorError('Invalid URL: %s' % url)
1355         video_id = mobj.group(2)
1356         return video_id
1357
1358     def _extract_annotations(self, video_id):
1359         url = 'https://www.youtube.com/annotations_invideo?features=1&legacy=1&video_id=%s' % video_id
1360         return self._download_webpage(url, video_id, note='Searching for annotations.', errnote='Unable to download video annotations.')
1361
1362     @staticmethod
1363     def _extract_chapters(description, duration):
1364         if not description:
1365             return None
1366         chapter_lines = re.findall(
1367             r'(?:^|<br\s*/>)([^<]*<a[^>]+onclick=["\']yt\.www\.watch\.player\.seekTo[^>]+>(\d{1,2}:\d{1,2}(?::\d{1,2})?)</a>[^>]*)(?=$|<br\s*/>)',
1368             description)
1369         if not chapter_lines:
1370             return None
1371         chapters = []
1372         for next_num, (chapter_line, time_point) in enumerate(
1373                 chapter_lines, start=1):
1374             start_time = parse_duration(time_point)
1375             if start_time is None:
1376                 continue
1377             if start_time > duration:
1378                 break
1379             end_time = (duration if next_num == len(chapter_lines)
1380                         else parse_duration(chapter_lines[next_num][1]))
1381             if end_time is None:
1382                 continue
1383             if end_time > duration:
1384                 end_time = duration
1385             if start_time > end_time:
1386                 break
1387             chapter_title = re.sub(
1388                 r'<a[^>]+>[^<]+</a>', '', chapter_line).strip(' \t-')
1389             chapter_title = re.sub(r'\s+', ' ', chapter_title)
1390             chapters.append({
1391                 'start_time': start_time,
1392                 'end_time': end_time,
1393                 'title': chapter_title,
1394             })
1395         return chapters
1396
1397     def _real_extract(self, url):
1398         url, smuggled_data = unsmuggle_url(url, {})
1399
1400         proto = (
1401             'http' if self._downloader.params.get('prefer_insecure', False)
1402             else 'https')
1403
1404         start_time = None
1405         end_time = None
1406         parsed_url = compat_urllib_parse_urlparse(url)
1407         for component in [parsed_url.fragment, parsed_url.query]:
1408             query = compat_parse_qs(component)
1409             if start_time is None and 't' in query:
1410                 start_time = parse_duration(query['t'][0])
1411             if start_time is None and 'start' in query:
1412                 start_time = parse_duration(query['start'][0])
1413             if end_time is None and 'end' in query:
1414                 end_time = parse_duration(query['end'][0])
1415
1416         # Extract original video URL from URL with redirection, like age verification, using next_url parameter
1417         mobj = re.search(self._NEXT_URL_RE, url)
1418         if mobj:
1419             url = proto + '://www.youtube.com/' + compat_urllib_parse_unquote(mobj.group(1)).lstrip('/')
1420         video_id = self.extract_id(url)
1421
1422         # Get video webpage
1423         url = proto + '://www.youtube.com/watch?v=%s&gl=US&hl=en&has_verified=1&bpctr=9999999999' % video_id
1424         video_webpage = self._download_webpage(url, video_id)
1425
1426         # Attempt to extract SWF player URL
1427         mobj = re.search(r'swfConfig.*?"(https?:\\/\\/.*?watch.*?-.*?\.swf)"', video_webpage)
1428         if mobj is not None:
1429             player_url = re.sub(r'\\(.)', r'\1', mobj.group(1))
1430         else:
1431             player_url = None
1432
1433         dash_mpds = []
1434
1435         def add_dash_mpd(video_info):
1436             dash_mpd = video_info.get('dashmpd')
1437             if dash_mpd and dash_mpd[0] not in dash_mpds:
1438                 dash_mpds.append(dash_mpd[0])
1439
1440         # Get video info
1441         embed_webpage = None
1442         is_live = None
1443         if re.search(r'player-age-gate-content">', video_webpage) is not None:
1444             age_gate = True
1445             # We simulate the access to the video from www.youtube.com/v/{video_id}
1446             # this can be viewed without login into Youtube
1447             url = proto + '://www.youtube.com/embed/%s' % video_id
1448             embed_webpage = self._download_webpage(url, video_id, 'Downloading embed webpage')
1449             data = compat_urllib_parse_urlencode({
1450                 'video_id': video_id,
1451                 'eurl': 'https://youtube.googleapis.com/v/' + video_id,
1452                 'sts': self._search_regex(
1453                     r'"sts"\s*:\s*(\d+)', embed_webpage, 'sts', default=''),
1454             })
1455             video_info_url = proto + '://www.youtube.com/get_video_info?' + data
1456             video_info_webpage = self._download_webpage(
1457                 video_info_url, video_id,
1458                 note='Refetching age-gated info webpage',
1459                 errnote='unable to download video info webpage')
1460             video_info = compat_parse_qs(video_info_webpage)
1461             add_dash_mpd(video_info)
1462         else:
1463             age_gate = False
1464             video_info = None
1465             sts = None
1466             # Try looking directly into the video webpage
1467             ytplayer_config = self._get_ytplayer_config(video_id, video_webpage)
1468             if ytplayer_config:
1469                 args = ytplayer_config['args']
1470                 if args.get('url_encoded_fmt_stream_map'):
1471                     # Convert to the same format returned by compat_parse_qs
1472                     video_info = dict((k, [v]) for k, v in args.items())
1473                     add_dash_mpd(video_info)
1474                 # Rental video is not rented but preview is available (e.g.
1475                 # https://www.youtube.com/watch?v=yYr8q0y5Jfg,
1476                 # https://github.com/rg3/youtube-dl/issues/10532)
1477                 if not video_info and args.get('ypc_vid'):
1478                     return self.url_result(
1479                         args['ypc_vid'], YoutubeIE.ie_key(), video_id=args['ypc_vid'])
1480                 if args.get('livestream') == '1' or args.get('live_playback') == 1:
1481                     is_live = True
1482                 sts = ytplayer_config.get('sts')
1483             if not video_info or self._downloader.params.get('youtube_include_dash_manifest', True):
1484                 # We also try looking in get_video_info since it may contain different dashmpd
1485                 # URL that points to a DASH manifest with possibly different itag set (some itags
1486                 # are missing from DASH manifest pointed by webpage's dashmpd, some - from DASH
1487                 # manifest pointed by get_video_info's dashmpd).
1488                 # The general idea is to take a union of itags of both DASH manifests (for example
1489                 # video with such 'manifest behavior' see https://github.com/rg3/youtube-dl/issues/6093)
1490                 self.report_video_info_webpage_download(video_id)
1491                 for el in ('info', 'embedded', 'detailpage', 'vevo', ''):
1492                     query = {
1493                         'video_id': video_id,
1494                         'ps': 'default',
1495                         'eurl': '',
1496                         'gl': 'US',
1497                         'hl': 'en',
1498                     }
1499                     if el:
1500                         query['el'] = el
1501                     if sts:
1502                         query['sts'] = sts
1503                     video_info_webpage = self._download_webpage(
1504                         '%s://www.youtube.com/get_video_info' % proto,
1505                         video_id, note=False,
1506                         errnote='unable to download video info webpage',
1507                         fatal=False, query=query)
1508                     if not video_info_webpage:
1509                         continue
1510                     get_video_info = compat_parse_qs(video_info_webpage)
1511                     add_dash_mpd(get_video_info)
1512                     if not video_info:
1513                         video_info = get_video_info
1514                     if 'token' in get_video_info:
1515                         # Different get_video_info requests may report different results, e.g.
1516                         # some may report video unavailability, but some may serve it without
1517                         # any complaint (see https://github.com/rg3/youtube-dl/issues/7362,
1518                         # the original webpage as well as el=info and el=embedded get_video_info
1519                         # requests report video unavailability due to geo restriction while
1520                         # el=detailpage succeeds and returns valid data). This is probably
1521                         # due to YouTube measures against IP ranges of hosting providers.
1522                         # Working around by preferring the first succeeded video_info containing
1523                         # the token if no such video_info yet was found.
1524                         if 'token' not in video_info:
1525                             video_info = get_video_info
1526                         break
1527         if 'token' not in video_info:
1528             if 'reason' in video_info:
1529                 if 'The uploader has not made this video available in your country.' in video_info['reason']:
1530                     regions_allowed = self._html_search_meta(
1531                         'regionsAllowed', video_webpage, default=None)
1532                     countries = regions_allowed.split(',') if regions_allowed else None
1533                     self.raise_geo_restricted(
1534                         msg=video_info['reason'][0], countries=countries)
1535                 raise ExtractorError(
1536                     'YouTube said: %s' % video_info['reason'][0],
1537                     expected=True, video_id=video_id)
1538             else:
1539                 raise ExtractorError(
1540                     '"token" parameter not in video info for unknown reason',
1541                     video_id=video_id)
1542
1543         # title
1544         if 'title' in video_info:
1545             video_title = video_info['title'][0]
1546         else:
1547             self._downloader.report_warning('Unable to extract video title')
1548             video_title = '_'
1549
1550         # description
1551         description_original = video_description = get_element_by_id("eow-description", video_webpage)
1552         if video_description:
1553             description_original = video_description = re.sub(r'''(?x)
1554                 <a\s+
1555                     (?:[a-zA-Z-]+="[^"]*"\s+)*?
1556                     (?:title|href)="([^"]+)"\s+
1557                     (?:[a-zA-Z-]+="[^"]*"\s+)*?
1558                     class="[^"]*"[^>]*>
1559                 [^<]+\.{3}\s*
1560                 </a>
1561             ''', r'\1', video_description)
1562             video_description = clean_html(video_description)
1563         else:
1564             fd_mobj = re.search(r'<meta name="description" content="([^"]+)"', video_webpage)
1565             if fd_mobj:
1566                 video_description = unescapeHTML(fd_mobj.group(1))
1567             else:
1568                 video_description = ''
1569
1570         if 'multifeed_metadata_list' in video_info and not smuggled_data.get('force_singlefeed', False):
1571             if not self._downloader.params.get('noplaylist'):
1572                 entries = []
1573                 feed_ids = []
1574                 multifeed_metadata_list = video_info['multifeed_metadata_list'][0]
1575                 for feed in multifeed_metadata_list.split(','):
1576                     # Unquote should take place before split on comma (,) since textual
1577                     # fields may contain comma as well (see
1578                     # https://github.com/rg3/youtube-dl/issues/8536)
1579                     feed_data = compat_parse_qs(compat_urllib_parse_unquote_plus(feed))
1580                     entries.append({
1581                         '_type': 'url_transparent',
1582                         'ie_key': 'Youtube',
1583                         'url': smuggle_url(
1584                             '%s://www.youtube.com/watch?v=%s' % (proto, feed_data['id'][0]),
1585                             {'force_singlefeed': True}),
1586                         'title': '%s (%s)' % (video_title, feed_data['title'][0]),
1587                     })
1588                     feed_ids.append(feed_data['id'][0])
1589                 self.to_screen(
1590                     'Downloading multifeed video (%s) - add --no-playlist to just download video %s'
1591                     % (', '.join(feed_ids), video_id))
1592                 return self.playlist_result(entries, video_id, video_title, video_description)
1593             self.to_screen('Downloading just video %s because of --no-playlist' % video_id)
1594
1595         if 'view_count' in video_info:
1596             view_count = int(video_info['view_count'][0])
1597         else:
1598             view_count = None
1599
1600         # Check for "rental" videos
1601         if 'ypc_video_rental_bar_text' in video_info and 'author' not in video_info:
1602             raise ExtractorError('"rental" videos not supported. See https://github.com/rg3/youtube-dl/issues/359 for more information.', expected=True)
1603
1604         # Start extracting information
1605         self.report_information_extraction(video_id)
1606
1607         # uploader
1608         if 'author' not in video_info:
1609             raise ExtractorError('Unable to extract uploader name')
1610         video_uploader = compat_urllib_parse_unquote_plus(video_info['author'][0])
1611
1612         # uploader_id
1613         video_uploader_id = None
1614         video_uploader_url = None
1615         mobj = re.search(
1616             r'<link itemprop="url" href="(?P<uploader_url>https?://www.youtube.com/(?:user|channel)/(?P<uploader_id>[^"]+))">',
1617             video_webpage)
1618         if mobj is not None:
1619             video_uploader_id = mobj.group('uploader_id')
1620             video_uploader_url = mobj.group('uploader_url')
1621         else:
1622             self._downloader.report_warning('unable to extract uploader nickname')
1623
1624         # thumbnail image
1625         # We try first to get a high quality image:
1626         m_thumb = re.search(r'<span itemprop="thumbnail".*?href="(.*?)">',
1627                             video_webpage, re.DOTALL)
1628         if m_thumb is not None:
1629             video_thumbnail = m_thumb.group(1)
1630         elif 'thumbnail_url' not in video_info:
1631             self._downloader.report_warning('unable to extract video thumbnail')
1632             video_thumbnail = None
1633         else:   # don't panic if we can't find it
1634             video_thumbnail = compat_urllib_parse_unquote_plus(video_info['thumbnail_url'][0])
1635
1636         # upload date
1637         upload_date = self._html_search_meta(
1638             'datePublished', video_webpage, 'upload date', default=None)
1639         if not upload_date:
1640             upload_date = self._search_regex(
1641                 [r'(?s)id="eow-date.*?>(.*?)</span>',
1642                  r'id="watch-uploader-info".*?>.*?(?:Published|Uploaded|Streamed live|Started) on (.+?)</strong>'],
1643                 video_webpage, 'upload date', default=None)
1644             if upload_date:
1645                 upload_date = ' '.join(re.sub(r'[/,-]', r' ', mobj.group(1)).split())
1646         upload_date = unified_strdate(upload_date)
1647
1648         video_license = self._html_search_regex(
1649             r'<h4[^>]+class="title"[^>]*>\s*License\s*</h4>\s*<ul[^>]*>\s*<li>(.+?)</li',
1650             video_webpage, 'license', default=None)
1651
1652         m_music = re.search(
1653             r'''(?x)
1654                 <h4[^>]+class="title"[^>]*>\s*Music\s*</h4>\s*
1655                 <ul[^>]*>\s*
1656                 <li>(?P<title>.+?)
1657                 by (?P<creator>.+?)
1658                 (?:
1659                     \(.+?\)|
1660                     <a[^>]*
1661                         (?:
1662                             \bhref=["\']/red[^>]*>|             # drop possible
1663                             >\s*Listen ad-free with YouTube Red # YouTube Red ad
1664                         )
1665                     .*?
1666                 )?</li
1667             ''',
1668             video_webpage)
1669         if m_music:
1670             video_alt_title = remove_quotes(unescapeHTML(m_music.group('title')))
1671             video_creator = clean_html(m_music.group('creator'))
1672         else:
1673             video_alt_title = video_creator = None
1674
1675         m_episode = re.search(
1676             r'<div[^>]+id="watch7-headline"[^>]*>\s*<span[^>]*>.*?>(?P<series>[^<]+)</a></b>\s*S(?P<season>\d+)\s*•\s*E(?P<episode>\d+)</span>',
1677             video_webpage)
1678         if m_episode:
1679             series = m_episode.group('series')
1680             season_number = int(m_episode.group('season'))
1681             episode_number = int(m_episode.group('episode'))
1682         else:
1683             series = season_number = episode_number = None
1684
1685         m_cat_container = self._search_regex(
1686             r'(?s)<h4[^>]*>\s*Category\s*</h4>\s*<ul[^>]*>(.*?)</ul>',
1687             video_webpage, 'categories', default=None)
1688         if m_cat_container:
1689             category = self._html_search_regex(
1690                 r'(?s)<a[^<]+>(.*?)</a>', m_cat_container, 'category',
1691                 default=None)
1692             video_categories = None if category is None else [category]
1693         else:
1694             video_categories = None
1695
1696         video_tags = [
1697             unescapeHTML(m.group('content'))
1698             for m in re.finditer(self._meta_regex('og:video:tag'), video_webpage)]
1699
1700         def _extract_count(count_name):
1701             return str_to_int(self._search_regex(
1702                 r'-%s-button[^>]+><span[^>]+class="yt-uix-button-content"[^>]*>([\d,]+)</span>'
1703                 % re.escape(count_name),
1704                 video_webpage, count_name, default=None))
1705
1706         like_count = _extract_count('like')
1707         dislike_count = _extract_count('dislike')
1708
1709         # subtitles
1710         video_subtitles = self.extract_subtitles(video_id, video_webpage)
1711         automatic_captions = self.extract_automatic_captions(video_id, video_webpage)
1712
1713         video_duration = try_get(
1714             video_info, lambda x: int_or_none(x['length_seconds'][0]))
1715         if not video_duration:
1716             video_duration = parse_duration(self._html_search_meta(
1717                 'duration', video_webpage, 'video duration'))
1718
1719         # annotations
1720         video_annotations = None
1721         if self._downloader.params.get('writeannotations', False):
1722             video_annotations = self._extract_annotations(video_id)
1723
1724         chapters = self._extract_chapters(description_original, video_duration)
1725
1726         if 'conn' in video_info and video_info['conn'][0].startswith('rtmp'):
1727             self.report_rtmp_download()
1728             formats = [{
1729                 'format_id': '_rtmp',
1730                 'protocol': 'rtmp',
1731                 'url': video_info['conn'][0],
1732                 'player_url': player_url,
1733             }]
1734         elif len(video_info.get('url_encoded_fmt_stream_map', [''])[0]) >= 1 or len(video_info.get('adaptive_fmts', [''])[0]) >= 1:
1735             encoded_url_map = video_info.get('url_encoded_fmt_stream_map', [''])[0] + ',' + video_info.get('adaptive_fmts', [''])[0]
1736             if 'rtmpe%3Dyes' in encoded_url_map:
1737                 raise ExtractorError('rtmpe downloads are not supported, see https://github.com/rg3/youtube-dl/issues/343 for more information.', expected=True)
1738             formats_spec = {}
1739             fmt_list = video_info.get('fmt_list', [''])[0]
1740             if fmt_list:
1741                 for fmt in fmt_list.split(','):
1742                     spec = fmt.split('/')
1743                     if len(spec) > 1:
1744                         width_height = spec[1].split('x')
1745                         if len(width_height) == 2:
1746                             formats_spec[spec[0]] = {
1747                                 'resolution': spec[1],
1748                                 'width': int_or_none(width_height[0]),
1749                                 'height': int_or_none(width_height[1]),
1750                             }
1751             formats = []
1752             for url_data_str in encoded_url_map.split(','):
1753                 url_data = compat_parse_qs(url_data_str)
1754                 if 'itag' not in url_data or 'url' not in url_data:
1755                     continue
1756                 format_id = url_data['itag'][0]
1757                 url = url_data['url'][0]
1758
1759                 if 's' in url_data or self._downloader.params.get('youtube_include_dash_manifest', True):
1760                     ASSETS_RE = r'"assets":.+?"js":\s*("[^"]+")'
1761                     jsplayer_url_json = self._search_regex(
1762                         ASSETS_RE,
1763                         embed_webpage if age_gate else video_webpage,
1764                         'JS player URL (1)', default=None)
1765                     if not jsplayer_url_json and not age_gate:
1766                         # We need the embed website after all
1767                         if embed_webpage is None:
1768                             embed_url = proto + '://www.youtube.com/embed/%s' % video_id
1769                             embed_webpage = self._download_webpage(
1770                                 embed_url, video_id, 'Downloading embed webpage')
1771                         jsplayer_url_json = self._search_regex(
1772                             ASSETS_RE, embed_webpage, 'JS player URL')
1773
1774                     player_url = json.loads(jsplayer_url_json)
1775                     if player_url is None:
1776                         player_url_json = self._search_regex(
1777                             r'ytplayer\.config.*?"url"\s*:\s*("[^"]+")',
1778                             video_webpage, 'age gate player URL')
1779                         player_url = json.loads(player_url_json)
1780
1781                 if 'sig' in url_data:
1782                     url += '&signature=' + url_data['sig'][0]
1783                 elif 's' in url_data:
1784                     encrypted_sig = url_data['s'][0]
1785
1786                     if self._downloader.params.get('verbose'):
1787                         if player_url is None:
1788                             player_version = 'unknown'
1789                             player_desc = 'unknown'
1790                         else:
1791                             if player_url.endswith('swf'):
1792                                 player_version = self._search_regex(
1793                                     r'-(.+?)(?:/watch_as3)?\.swf$', player_url,
1794                                     'flash player', fatal=False)
1795                                 player_desc = 'flash player %s' % player_version
1796                             else:
1797                                 player_version = self._search_regex(
1798                                     [r'html5player-([^/]+?)(?:/html5player(?:-new)?)?\.js',
1799                                      r'(?:www|player)-([^/]+)(?:/[a-z]{2}_[A-Z]{2})?/base\.js'],
1800                                     player_url,
1801                                     'html5 player', fatal=False)
1802                                 player_desc = 'html5 player %s' % player_version
1803
1804                         parts_sizes = self._signature_cache_id(encrypted_sig)
1805                         self.to_screen('{%s} signature length %s, %s' %
1806                                        (format_id, parts_sizes, player_desc))
1807
1808                     signature = self._decrypt_signature(
1809                         encrypted_sig, video_id, player_url, age_gate)
1810                     url += '&signature=' + signature
1811                 if 'ratebypass' not in url:
1812                     url += '&ratebypass=yes'
1813
1814                 dct = {
1815                     'format_id': format_id,
1816                     'url': url,
1817                     'player_url': player_url,
1818                 }
1819                 if format_id in self._formats:
1820                     dct.update(self._formats[format_id])
1821                 if format_id in formats_spec:
1822                     dct.update(formats_spec[format_id])
1823
1824                 # Some itags are not included in DASH manifest thus corresponding formats will
1825                 # lack metadata (see https://github.com/rg3/youtube-dl/pull/5993).
1826                 # Trying to extract metadata from url_encoded_fmt_stream_map entry.
1827                 mobj = re.search(r'^(?P<width>\d+)[xX](?P<height>\d+)$', url_data.get('size', [''])[0])
1828                 width, height = (int(mobj.group('width')), int(mobj.group('height'))) if mobj else (None, None)
1829
1830                 more_fields = {
1831                     'filesize': int_or_none(url_data.get('clen', [None])[0]),
1832                     'tbr': float_or_none(url_data.get('bitrate', [None])[0], 1000),
1833                     'width': width,
1834                     'height': height,
1835                     'fps': int_or_none(url_data.get('fps', [None])[0]),
1836                     'format_note': url_data.get('quality_label', [None])[0] or url_data.get('quality', [None])[0],
1837                 }
1838                 for key, value in more_fields.items():
1839                     if value:
1840                         dct[key] = value
1841                 type_ = url_data.get('type', [None])[0]
1842                 if type_:
1843                     type_split = type_.split(';')
1844                     kind_ext = type_split[0].split('/')
1845                     if len(kind_ext) == 2:
1846                         kind, _ = kind_ext
1847                         dct['ext'] = mimetype2ext(type_split[0])
1848                         if kind in ('audio', 'video'):
1849                             codecs = None
1850                             for mobj in re.finditer(
1851                                     r'(?P<key>[a-zA-Z_-]+)=(?P<quote>["\']?)(?P<val>.+?)(?P=quote)(?:;|$)', type_):
1852                                 if mobj.group('key') == 'codecs':
1853                                     codecs = mobj.group('val')
1854                                     break
1855                             if codecs:
1856                                 dct.update(parse_codecs(codecs))
1857                 formats.append(dct)
1858         elif video_info.get('hlsvp'):
1859             manifest_url = video_info['hlsvp'][0]
1860             formats = []
1861             m3u8_formats = self._extract_m3u8_formats(
1862                 manifest_url, video_id, 'mp4', fatal=False)
1863             for a_format in m3u8_formats:
1864                 itag = self._search_regex(
1865                     r'/itag/(\d+)/', a_format['url'], 'itag', default=None)
1866                 if itag:
1867                     a_format['format_id'] = itag
1868                     if itag in self._formats:
1869                         dct = self._formats[itag].copy()
1870                         dct.update(a_format)
1871                         a_format = dct
1872                 a_format['player_url'] = player_url
1873                 # Accept-Encoding header causes failures in live streams on Youtube and Youtube Gaming
1874                 a_format.setdefault('http_headers', {})['Youtubedl-no-compression'] = 'True'
1875                 formats.append(a_format)
1876         else:
1877             unavailable_message = self._html_search_regex(
1878                 r'(?s)<h1[^>]+id="unavailable-message"[^>]*>(.+?)</h1>',
1879                 video_webpage, 'unavailable message', default=None)
1880             if unavailable_message:
1881                 raise ExtractorError(unavailable_message, expected=True)
1882             raise ExtractorError('no conn, hlsvp or url_encoded_fmt_stream_map information found in video info')
1883
1884         # Look for the DASH manifest
1885         if self._downloader.params.get('youtube_include_dash_manifest', True):
1886             dash_mpd_fatal = True
1887             for mpd_url in dash_mpds:
1888                 dash_formats = {}
1889                 try:
1890                     def decrypt_sig(mobj):
1891                         s = mobj.group(1)
1892                         dec_s = self._decrypt_signature(s, video_id, player_url, age_gate)
1893                         return '/signature/%s' % dec_s
1894
1895                     mpd_url = re.sub(r'/s/([a-fA-F0-9\.]+)', decrypt_sig, mpd_url)
1896
1897                     for df in self._extract_mpd_formats(
1898                             mpd_url, video_id, fatal=dash_mpd_fatal,
1899                             formats_dict=self._formats):
1900                         # Do not overwrite DASH format found in some previous DASH manifest
1901                         if df['format_id'] not in dash_formats:
1902                             dash_formats[df['format_id']] = df
1903                         # Additional DASH manifests may end up in HTTP Error 403 therefore
1904                         # allow them to fail without bug report message if we already have
1905                         # some DASH manifest succeeded. This is temporary workaround to reduce
1906                         # burst of bug reports until we figure out the reason and whether it
1907                         # can be fixed at all.
1908                         dash_mpd_fatal = False
1909                 except (ExtractorError, KeyError) as e:
1910                     self.report_warning(
1911                         'Skipping DASH manifest: %r' % e, video_id)
1912                 if dash_formats:
1913                     # Remove the formats we found through non-DASH, they
1914                     # contain less info and it can be wrong, because we use
1915                     # fixed values (for example the resolution). See
1916                     # https://github.com/rg3/youtube-dl/issues/5774 for an
1917                     # example.
1918                     formats = [f for f in formats if f['format_id'] not in dash_formats.keys()]
1919                     formats.extend(dash_formats.values())
1920
1921         # Check for malformed aspect ratio
1922         stretched_m = re.search(
1923             r'<meta\s+property="og:video:tag".*?content="yt:stretch=(?P<w>[0-9]+):(?P<h>[0-9]+)">',
1924             video_webpage)
1925         if stretched_m:
1926             w = float(stretched_m.group('w'))
1927             h = float(stretched_m.group('h'))
1928             # yt:stretch may hold invalid ratio data (e.g. for Q39EVAstoRM ratio is 17:0).
1929             # We will only process correct ratios.
1930             if w > 0 and h > 0:
1931                 ratio = w / h
1932                 for f in formats:
1933                     if f.get('vcodec') != 'none':
1934                         f['stretched_ratio'] = ratio
1935
1936         self._sort_formats(formats)
1937
1938         self.mark_watched(video_id, video_info)
1939
1940         return {
1941             'id': video_id,
1942             'uploader': video_uploader,
1943             'uploader_id': video_uploader_id,
1944             'uploader_url': video_uploader_url,
1945             'upload_date': upload_date,
1946             'license': video_license,
1947             'creator': video_creator,
1948             'title': video_title,
1949             'alt_title': video_alt_title,
1950             'thumbnail': video_thumbnail,
1951             'description': video_description,
1952             'categories': video_categories,
1953             'tags': video_tags,
1954             'subtitles': video_subtitles,
1955             'automatic_captions': automatic_captions,
1956             'duration': video_duration,
1957             'age_limit': 18 if age_gate else 0,
1958             'annotations': video_annotations,
1959             'chapters': chapters,
1960             'webpage_url': proto + '://www.youtube.com/watch?v=%s' % video_id,
1961             'view_count': view_count,
1962             'like_count': like_count,
1963             'dislike_count': dislike_count,
1964             'average_rating': float_or_none(video_info.get('avg_rating', [None])[0]),
1965             'formats': formats,
1966             'is_live': is_live,
1967             'start_time': start_time,
1968             'end_time': end_time,
1969             'series': series,
1970             'season_number': season_number,
1971             'episode_number': episode_number,
1972         }
1973
1974
1975 class YoutubeSharedVideoIE(InfoExtractor):
1976     _VALID_URL = r'(?:https?:)?//(?:www\.)?youtube\.com/shared\?.*\bci=(?P<id>[0-9A-Za-z_-]{11})'
1977     IE_NAME = 'youtube:shared'
1978
1979     _TEST = {
1980         'url': 'https://www.youtube.com/shared?ci=1nEzmT-M4fU',
1981         'info_dict': {
1982             'id': 'uPDB5I9wfp8',
1983             'ext': 'webm',
1984             'title': 'Pocoyo: 90 minutos de episódios completos Português para crianças - PARTE 3',
1985             'description': 'md5:d9e4d9346a2dfff4c7dc4c8cec0f546d',
1986             'upload_date': '20160219',
1987             'uploader': 'Pocoyo - Português (BR)',
1988             'uploader_id': 'PocoyoBrazil',
1989         },
1990         'add_ie': ['Youtube'],
1991         'params': {
1992             # There are already too many Youtube downloads
1993             'skip_download': True,
1994         },
1995     }
1996
1997     def _real_extract(self, url):
1998         video_id = self._match_id(url)
1999
2000         webpage = self._download_webpage(url, video_id)
2001
2002         real_video_id = self._html_search_meta(
2003             'videoId', webpage, 'YouTube video id', fatal=True)
2004
2005         return self.url_result(real_video_id, YoutubeIE.ie_key())
2006
2007
2008 class YoutubePlaylistIE(YoutubePlaylistBaseInfoExtractor):
2009     IE_DESC = 'YouTube.com playlists'
2010     _VALID_URL = r"""(?x)(?:
2011                         (?:https?://)?
2012                         (?:\w+\.)?
2013                         (?:
2014                             youtube\.com/
2015                             (?:
2016                                (?:course|view_play_list|my_playlists|artist|playlist|watch|embed/(?:videoseries|[0-9A-Za-z_-]{11}))
2017                                \? (?:.*?[&;])*? (?:p|a|list)=
2018                             |  p/
2019                             )|
2020                             youtu\.be/[0-9A-Za-z_-]{11}\?.*?\blist=
2021                         )
2022                         (
2023                             (?:PL|LL|EC|UU|FL|RD|UL|TL)?[0-9A-Za-z-_]{10,}
2024                             # Top tracks, they can also include dots
2025                             |(?:MC)[\w\.]*
2026                         )
2027                         .*
2028                      |
2029                         (%(playlist_id)s)
2030                      )""" % {'playlist_id': YoutubeBaseInfoExtractor._PLAYLIST_ID_RE}
2031     _TEMPLATE_URL = 'https://www.youtube.com/playlist?list=%s&disable_polymer=true'
2032     _VIDEO_RE = r'href="\s*/watch\?v=(?P<id>[0-9A-Za-z_-]{11})&amp;[^"]*?index=(?P<index>\d+)(?:[^>]+>(?P<title>[^<]+))?'
2033     IE_NAME = 'youtube:playlist'
2034     _TESTS = [{
2035         'url': 'https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re',
2036         'info_dict': {
2037             'title': 'ytdl test PL',
2038             'id': 'PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re',
2039         },
2040         'playlist_count': 3,
2041     }, {
2042         'url': 'https://www.youtube.com/playlist?list=PLtPgu7CB4gbZDA7i_euNxn75ISqxwZPYx',
2043         'info_dict': {
2044             'id': 'PLtPgu7CB4gbZDA7i_euNxn75ISqxwZPYx',
2045             'title': 'YDL_Empty_List',
2046         },
2047         'playlist_count': 0,
2048         'skip': 'This playlist is private',
2049     }, {
2050         'note': 'Playlist with deleted videos (#651). As a bonus, the video #51 is also twice in this list.',
2051         'url': 'https://www.youtube.com/playlist?list=PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
2052         'info_dict': {
2053             'title': '29C3: Not my department',
2054             'id': 'PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
2055         },
2056         'playlist_count': 95,
2057     }, {
2058         'note': 'issue #673',
2059         'url': 'PLBB231211A4F62143',
2060         'info_dict': {
2061             'title': '[OLD]Team Fortress 2 (Class-based LP)',
2062             'id': 'PLBB231211A4F62143',
2063         },
2064         'playlist_mincount': 26,
2065     }, {
2066         'note': 'Large playlist',
2067         'url': 'https://www.youtube.com/playlist?list=UUBABnxM4Ar9ten8Mdjj1j0Q',
2068         'info_dict': {
2069             'title': 'Uploads from Cauchemar',
2070             'id': 'UUBABnxM4Ar9ten8Mdjj1j0Q',
2071         },
2072         'playlist_mincount': 799,
2073     }, {
2074         'url': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
2075         'info_dict': {
2076             'title': 'YDL_safe_search',
2077             'id': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
2078         },
2079         'playlist_count': 2,
2080         'skip': 'This playlist is private',
2081     }, {
2082         'note': 'embedded',
2083         'url': 'https://www.youtube.com/embed/videoseries?list=PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
2084         'playlist_count': 4,
2085         'info_dict': {
2086             'title': 'JODA15',
2087             'id': 'PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
2088         }
2089     }, {
2090         'url': 'http://www.youtube.com/embed/_xDOZElKyNU?list=PLsyOSbh5bs16vubvKePAQ1x3PhKavfBIl',
2091         'playlist_mincount': 485,
2092         'info_dict': {
2093             'title': '2017 華語最新單曲 (2/24更新)',
2094             'id': 'PLsyOSbh5bs16vubvKePAQ1x3PhKavfBIl',
2095         }
2096     }, {
2097         'note': 'Embedded SWF player',
2098         'url': 'https://www.youtube.com/p/YN5VISEtHet5D4NEvfTd0zcgFk84NqFZ?hl=en_US&fs=1&rel=0',
2099         'playlist_count': 4,
2100         'info_dict': {
2101             'title': 'JODA7',
2102             'id': 'YN5VISEtHet5D4NEvfTd0zcgFk84NqFZ',
2103         }
2104     }, {
2105         'note': 'Buggy playlist: the webpage has a "Load more" button but it doesn\'t have more videos',
2106         'url': 'https://www.youtube.com/playlist?list=UUXw-G3eDE9trcvY2sBMM_aA',
2107         'info_dict': {
2108             'title': 'Uploads from Interstellar Movie',
2109             'id': 'UUXw-G3eDE9trcvY2sBMM_aA',
2110         },
2111         'playlist_mincount': 21,
2112     }, {
2113         # Playlist URL that does not actually serve a playlist
2114         'url': 'https://www.youtube.com/watch?v=FqZTN594JQw&list=PLMYEtVRpaqY00V9W81Cwmzp6N6vZqfUKD4',
2115         'info_dict': {
2116             'id': 'FqZTN594JQw',
2117             'ext': 'webm',
2118             'title': "Smiley's People 01 detective, Adventure Series, Action",
2119             'uploader': 'STREEM',
2120             'uploader_id': 'UCyPhqAZgwYWZfxElWVbVJng',
2121             'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UCyPhqAZgwYWZfxElWVbVJng',
2122             'upload_date': '20150526',
2123             'license': 'Standard YouTube License',
2124             'description': 'md5:507cdcb5a49ac0da37a920ece610be80',
2125             'categories': ['People & Blogs'],
2126             'tags': list,
2127             'like_count': int,
2128             'dislike_count': int,
2129         },
2130         'params': {
2131             'skip_download': True,
2132         },
2133         'add_ie': [YoutubeIE.ie_key()],
2134     }, {
2135         'url': 'https://youtu.be/yeWKywCrFtk?list=PL2qgrgXsNUG5ig9cat4ohreBjYLAPC0J5',
2136         'info_dict': {
2137             'id': 'yeWKywCrFtk',
2138             'ext': 'mp4',
2139             'title': 'Small Scale Baler and Braiding Rugs',
2140             'uploader': 'Backus-Page House Museum',
2141             'uploader_id': 'backuspagemuseum',
2142             'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/backuspagemuseum',
2143             'upload_date': '20161008',
2144             'license': 'Standard YouTube License',
2145             'description': 'md5:800c0c78d5eb128500bffd4f0b4f2e8a',
2146             'categories': ['Nonprofits & Activism'],
2147             'tags': list,
2148             'like_count': int,
2149             'dislike_count': int,
2150         },
2151         'params': {
2152             'noplaylist': True,
2153             'skip_download': True,
2154         },
2155     }, {
2156         'url': 'https://youtu.be/uWyaPkt-VOI?list=PL9D9FC436B881BA21',
2157         'only_matching': True,
2158     }, {
2159         'url': 'TLGGrESM50VT6acwMjAyMjAxNw',
2160         'only_matching': True,
2161     }]
2162
2163     def _real_initialize(self):
2164         self._login()
2165
2166     def _extract_mix(self, playlist_id):
2167         # The mixes are generated from a single video
2168         # the id of the playlist is just 'RD' + video_id
2169         ids = []
2170         last_id = playlist_id[-11:]
2171         for n in itertools.count(1):
2172             url = 'https://youtube.com/watch?v=%s&list=%s' % (last_id, playlist_id)
2173             webpage = self._download_webpage(
2174                 url, playlist_id, 'Downloading page {0} of Youtube mix'.format(n))
2175             new_ids = orderedSet(re.findall(
2176                 r'''(?xs)data-video-username=".*?".*?
2177                            href="/watch\?v=([0-9A-Za-z_-]{11})&amp;[^"]*?list=%s''' % re.escape(playlist_id),
2178                 webpage))
2179             # Fetch new pages until all the videos are repeated, it seems that
2180             # there are always 51 unique videos.
2181             new_ids = [_id for _id in new_ids if _id not in ids]
2182             if not new_ids:
2183                 break
2184             ids.extend(new_ids)
2185             last_id = ids[-1]
2186
2187         url_results = self._ids_to_results(ids)
2188
2189         search_title = lambda class_name: get_element_by_attribute('class', class_name, webpage)
2190         title_span = (
2191             search_title('playlist-title') or
2192             search_title('title long-title') or
2193             search_title('title'))
2194         title = clean_html(title_span)
2195
2196         return self.playlist_result(url_results, playlist_id, title)
2197
2198     def _extract_playlist(self, playlist_id):
2199         url = self._TEMPLATE_URL % playlist_id
2200         page = self._download_webpage(url, playlist_id)
2201
2202         # the yt-alert-message now has tabindex attribute (see https://github.com/rg3/youtube-dl/issues/11604)
2203         for match in re.findall(r'<div class="yt-alert-message"[^>]*>([^<]+)</div>', page):
2204             match = match.strip()
2205             # Check if the playlist exists or is private
2206             mobj = re.match(r'[^<]*(?:The|This) playlist (?P<reason>does not exist|is private)[^<]*', match)
2207             if mobj:
2208                 reason = mobj.group('reason')
2209                 message = 'This playlist %s' % reason
2210                 if 'private' in reason:
2211                     message += ', use --username or --netrc to access it'
2212                 message += '.'
2213                 raise ExtractorError(message, expected=True)
2214             elif re.match(r'[^<]*Invalid parameters[^<]*', match):
2215                 raise ExtractorError(
2216                     'Invalid parameters. Maybe URL is incorrect.',
2217                     expected=True)
2218             elif re.match(r'[^<]*Choose your language[^<]*', match):
2219                 continue
2220             else:
2221                 self.report_warning('Youtube gives an alert message: ' + match)
2222
2223         playlist_title = self._html_search_regex(
2224             r'(?s)<h1 class="pl-header-title[^"]*"[^>]*>\s*(.*?)\s*</h1>',
2225             page, 'title', default=None)
2226
2227         has_videos = True
2228
2229         if not playlist_title:
2230             try:
2231                 # Some playlist URLs don't actually serve a playlist (e.g.
2232                 # https://www.youtube.com/watch?v=FqZTN594JQw&list=PLMYEtVRpaqY00V9W81Cwmzp6N6vZqfUKD4)
2233                 next(self._entries(page, playlist_id))
2234             except StopIteration:
2235                 has_videos = False
2236
2237         return has_videos, self.playlist_result(
2238             self._entries(page, playlist_id), playlist_id, playlist_title)
2239
2240     def _check_download_just_video(self, url, playlist_id):
2241         # Check if it's a video-specific URL
2242         query_dict = compat_urlparse.parse_qs(compat_urlparse.urlparse(url).query)
2243         video_id = query_dict.get('v', [None])[0] or self._search_regex(
2244             r'(?:(?:^|//)youtu\.be/|youtube\.com/embed/(?!videoseries))([0-9A-Za-z_-]{11})', url,
2245             'video id', default=None)
2246         if video_id:
2247             if self._downloader.params.get('noplaylist'):
2248                 self.to_screen('Downloading just video %s because of --no-playlist' % video_id)
2249                 return video_id, self.url_result(video_id, 'Youtube', video_id=video_id)
2250             else:
2251                 self.to_screen('Downloading playlist %s - add --no-playlist to just download video %s' % (playlist_id, video_id))
2252                 return video_id, None
2253         return None, None
2254
2255     def _real_extract(self, url):
2256         # Extract playlist id
2257         mobj = re.match(self._VALID_URL, url)
2258         if mobj is None:
2259             raise ExtractorError('Invalid URL: %s' % url)
2260         playlist_id = mobj.group(1) or mobj.group(2)
2261
2262         video_id, video = self._check_download_just_video(url, playlist_id)
2263         if video:
2264             return video
2265
2266         if playlist_id.startswith(('RD', 'UL', 'PU')):
2267             # Mixes require a custom extraction process
2268             return self._extract_mix(playlist_id)
2269
2270         has_videos, playlist = self._extract_playlist(playlist_id)
2271         if has_videos or not video_id:
2272             return playlist
2273
2274         # Some playlist URLs don't actually serve a playlist (see
2275         # https://github.com/rg3/youtube-dl/issues/10537).
2276         # Fallback to plain video extraction if there is a video id
2277         # along with playlist id.
2278         return self.url_result(video_id, 'Youtube', video_id=video_id)
2279
2280
2281 class YoutubeChannelIE(YoutubePlaylistBaseInfoExtractor):
2282     IE_DESC = 'YouTube.com channels'
2283     _VALID_URL = r'https?://(?:youtu\.be|(?:\w+\.)?youtube(?:-nocookie)?\.com)/channel/(?P<id>[0-9A-Za-z_-]+)'
2284     _TEMPLATE_URL = 'https://www.youtube.com/channel/%s/videos'
2285     _VIDEO_RE = r'(?:title="(?P<title>[^"]+)"[^>]+)?href="/watch\?v=(?P<id>[0-9A-Za-z_-]+)&?'
2286     IE_NAME = 'youtube:channel'
2287     _TESTS = [{
2288         'note': 'paginated channel',
2289         'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w',
2290         'playlist_mincount': 91,
2291         'info_dict': {
2292             'id': 'UUKfVa3S1e4PHvxWcwyMMg8w',
2293             'title': 'Uploads from lex will',
2294         }
2295     }, {
2296         'note': 'Age restricted channel',
2297         # from https://www.youtube.com/user/DeusExOfficial
2298         'url': 'https://www.youtube.com/channel/UCs0ifCMCm1icqRbqhUINa0w',
2299         'playlist_mincount': 64,
2300         'info_dict': {
2301             'id': 'UUs0ifCMCm1icqRbqhUINa0w',
2302             'title': 'Uploads from Deus Ex',
2303         },
2304     }]
2305
2306     @classmethod
2307     def suitable(cls, url):
2308         return (False if YoutubePlaylistsIE.suitable(url) or YoutubeLiveIE.suitable(url)
2309                 else super(YoutubeChannelIE, cls).suitable(url))
2310
2311     def _build_template_url(self, url, channel_id):
2312         return self._TEMPLATE_URL % channel_id
2313
2314     def _real_extract(self, url):
2315         channel_id = self._match_id(url)
2316
2317         url = self._build_template_url(url, channel_id)
2318
2319         # Channel by page listing is restricted to 35 pages of 30 items, i.e. 1050 videos total (see #5778)
2320         # Workaround by extracting as a playlist if managed to obtain channel playlist URL
2321         # otherwise fallback on channel by page extraction
2322         channel_page = self._download_webpage(
2323             url + '?view=57', channel_id,
2324             'Downloading channel page', fatal=False)
2325         if channel_page is False:
2326             channel_playlist_id = False
2327         else:
2328             channel_playlist_id = self._html_search_meta(
2329                 'channelId', channel_page, 'channel id', default=None)
2330             if not channel_playlist_id:
2331                 channel_url = self._html_search_meta(
2332                     ('al:ios:url', 'twitter:app:url:iphone', 'twitter:app:url:ipad'),
2333                     channel_page, 'channel url', default=None)
2334                 if channel_url:
2335                     channel_playlist_id = self._search_regex(
2336                         r'vnd\.youtube://user/([0-9A-Za-z_-]+)',
2337                         channel_url, 'channel id', default=None)
2338         if channel_playlist_id and channel_playlist_id.startswith('UC'):
2339             playlist_id = 'UU' + channel_playlist_id[2:]
2340             return self.url_result(
2341                 compat_urlparse.urljoin(url, '/playlist?list=%s' % playlist_id), 'YoutubePlaylist')
2342
2343         channel_page = self._download_webpage(url, channel_id, 'Downloading page #1')
2344         autogenerated = re.search(r'''(?x)
2345                 class="[^"]*?(?:
2346                     channel-header-autogenerated-label|
2347                     yt-channel-title-autogenerated
2348                 )[^"]*"''', channel_page) is not None
2349
2350         if autogenerated:
2351             # The videos are contained in a single page
2352             # the ajax pages can't be used, they are empty
2353             entries = [
2354                 self.url_result(
2355                     video_id, 'Youtube', video_id=video_id,
2356                     video_title=video_title)
2357                 for video_id, video_title in self.extract_videos_from_page(channel_page)]
2358             return self.playlist_result(entries, channel_id)
2359
2360         try:
2361             next(self._entries(channel_page, channel_id))
2362         except StopIteration:
2363             alert_message = self._html_search_regex(
2364                 r'(?s)<div[^>]+class=(["\']).*?\byt-alert-message\b.*?\1[^>]*>(?P<alert>[^<]+)</div>',
2365                 channel_page, 'alert', default=None, group='alert')
2366             if alert_message:
2367                 raise ExtractorError('Youtube said: %s' % alert_message, expected=True)
2368
2369         return self.playlist_result(self._entries(channel_page, channel_id), channel_id)
2370
2371
2372 class YoutubeUserIE(YoutubeChannelIE):
2373     IE_DESC = 'YouTube.com user videos (URL or "ytuser" keyword)'
2374     _VALID_URL = r'(?:(?:https?://(?:\w+\.)?youtube\.com/(?:(?P<user>user|c)/)?(?!(?:attribution_link|watch|results)(?:$|[^a-z_A-Z0-9-])))|ytuser:)(?!feed/)(?P<id>[A-Za-z0-9_-]+)'
2375     _TEMPLATE_URL = 'https://www.youtube.com/%s/%s/videos'
2376     IE_NAME = 'youtube:user'
2377
2378     _TESTS = [{
2379         'url': 'https://www.youtube.com/user/TheLinuxFoundation',
2380         'playlist_mincount': 320,
2381         'info_dict': {
2382             'id': 'UUfX55Sx5hEFjoC3cNs6mCUQ',
2383             'title': 'Uploads from The Linux Foundation',
2384         }
2385     }, {
2386         # Only available via https://www.youtube.com/c/12minuteathlete/videos
2387         # but not https://www.youtube.com/user/12minuteathlete/videos
2388         'url': 'https://www.youtube.com/c/12minuteathlete/videos',
2389         'playlist_mincount': 249,
2390         'info_dict': {
2391             'id': 'UUVjM-zV6_opMDx7WYxnjZiQ',
2392             'title': 'Uploads from 12 Minute Athlete',
2393         }
2394     }, {
2395         'url': 'ytuser:phihag',
2396         'only_matching': True,
2397     }, {
2398         'url': 'https://www.youtube.com/c/gametrailers',
2399         'only_matching': True,
2400     }, {
2401         'url': 'https://www.youtube.com/gametrailers',
2402         'only_matching': True,
2403     }, {
2404         # This channel is not available, geo restricted to JP
2405         'url': 'https://www.youtube.com/user/kananishinoSMEJ/videos',
2406         'only_matching': True,
2407     }]
2408
2409     @classmethod
2410     def suitable(cls, url):
2411         # Don't return True if the url can be extracted with other youtube
2412         # extractor, the regex would is too permissive and it would match.
2413         other_yt_ies = iter(klass for (name, klass) in globals().items() if name.startswith('Youtube') and name.endswith('IE') and klass is not cls)
2414         if any(ie.suitable(url) for ie in other_yt_ies):
2415             return False
2416         else:
2417             return super(YoutubeUserIE, cls).suitable(url)
2418
2419     def _build_template_url(self, url, channel_id):
2420         mobj = re.match(self._VALID_URL, url)
2421         return self._TEMPLATE_URL % (mobj.group('user') or 'user', mobj.group('id'))
2422
2423
2424 class YoutubeLiveIE(YoutubeBaseInfoExtractor):
2425     IE_DESC = 'YouTube.com live streams'
2426     _VALID_URL = r'(?P<base_url>https?://(?:\w+\.)?youtube\.com/(?:(?:user|channel|c)/)?(?P<id>[^/]+))/live'
2427     IE_NAME = 'youtube:live'
2428
2429     _TESTS = [{
2430         'url': 'https://www.youtube.com/user/TheYoungTurks/live',
2431         'info_dict': {
2432             'id': 'a48o2S1cPoo',
2433             'ext': 'mp4',
2434             'title': 'The Young Turks - Live Main Show',
2435             'uploader': 'The Young Turks',
2436             'uploader_id': 'TheYoungTurks',
2437             'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/TheYoungTurks',
2438             'upload_date': '20150715',
2439             'license': 'Standard YouTube License',
2440             'description': 'md5:438179573adcdff3c97ebb1ee632b891',
2441             'categories': ['News & Politics'],
2442             'tags': ['Cenk Uygur (TV Program Creator)', 'The Young Turks (Award-Winning Work)', 'Talk Show (TV Genre)'],
2443             'like_count': int,
2444             'dislike_count': int,
2445         },
2446         'params': {
2447             'skip_download': True,
2448         },
2449     }, {
2450         'url': 'https://www.youtube.com/channel/UC1yBKRuGpC1tSM73A0ZjYjQ/live',
2451         'only_matching': True,
2452     }, {
2453         'url': 'https://www.youtube.com/c/CommanderVideoHq/live',
2454         'only_matching': True,
2455     }, {
2456         'url': 'https://www.youtube.com/TheYoungTurks/live',
2457         'only_matching': True,
2458     }]
2459
2460     def _real_extract(self, url):
2461         mobj = re.match(self._VALID_URL, url)
2462         channel_id = mobj.group('id')
2463         base_url = mobj.group('base_url')
2464         webpage = self._download_webpage(url, channel_id, fatal=False)
2465         if webpage:
2466             page_type = self._og_search_property(
2467                 'type', webpage, 'page type', default=None)
2468             video_id = self._html_search_meta(
2469                 'videoId', webpage, 'video id', default=None)
2470             if page_type == 'video' and video_id and re.match(r'^[0-9A-Za-z_-]{11}$', video_id):
2471                 return self.url_result(video_id, YoutubeIE.ie_key())
2472         return self.url_result(base_url)
2473
2474
2475 class YoutubePlaylistsIE(YoutubePlaylistsBaseInfoExtractor):
2476     IE_DESC = 'YouTube.com user/channel playlists'
2477     _VALID_URL = r'https?://(?:\w+\.)?youtube\.com/(?:user|channel)/(?P<id>[^/]+)/playlists'
2478     IE_NAME = 'youtube:playlists'
2479
2480     _TESTS = [{
2481         'url': 'https://www.youtube.com/user/ThirstForScience/playlists',
2482         'playlist_mincount': 4,
2483         'info_dict': {
2484             'id': 'ThirstForScience',
2485             'title': 'Thirst for Science',
2486         },
2487     }, {
2488         # with "Load more" button
2489         'url': 'https://www.youtube.com/user/igorkle1/playlists?view=1&sort=dd',
2490         'playlist_mincount': 70,
2491         'info_dict': {
2492             'id': 'igorkle1',
2493             'title': 'Игорь Клейнер',
2494         },
2495     }, {
2496         'url': 'https://www.youtube.com/channel/UCiU1dHvZObB2iP6xkJ__Icw/playlists',
2497         'playlist_mincount': 17,
2498         'info_dict': {
2499             'id': 'UCiU1dHvZObB2iP6xkJ__Icw',
2500             'title': 'Chem Player',
2501         },
2502     }]
2503
2504
2505 class YoutubeSearchIE(SearchInfoExtractor, YoutubePlaylistIE):
2506     IE_DESC = 'YouTube.com searches'
2507     # there doesn't appear to be a real limit, for example if you search for
2508     # 'python' you get more than 8.000.000 results
2509     _MAX_RESULTS = float('inf')
2510     IE_NAME = 'youtube:search'
2511     _SEARCH_KEY = 'ytsearch'
2512     _EXTRA_QUERY_ARGS = {}
2513     _TESTS = []
2514
2515     def _get_n_results(self, query, n):
2516         """Get a specified number of results for a query"""
2517
2518         videos = []
2519         limit = n
2520
2521         url_query = {
2522             'search_query': query.encode('utf-8'),
2523         }
2524         url_query.update(self._EXTRA_QUERY_ARGS)
2525         result_url = 'https://www.youtube.com/results?' + compat_urllib_parse_urlencode(url_query)
2526
2527         for pagenum in itertools.count(1):
2528             data = self._download_json(
2529                 result_url, video_id='query "%s"' % query,
2530                 note='Downloading page %s' % pagenum,
2531                 errnote='Unable to download API page',
2532                 query={'spf': 'navigate'})
2533             html_content = data[1]['body']['content']
2534
2535             if 'class="search-message' in html_content:
2536                 raise ExtractorError(
2537                     '[youtube] No video results', expected=True)
2538
2539             new_videos = self._ids_to_results(orderedSet(re.findall(
2540                 r'href="/watch\?v=(.{11})', html_content)))
2541             videos += new_videos
2542             if not new_videos or len(videos) > limit:
2543                 break
2544             next_link = self._html_search_regex(
2545                 r'href="(/results\?[^"]*\bsp=[^"]+)"[^>]*>\s*<span[^>]+class="[^"]*\byt-uix-button-content\b[^"]*"[^>]*>Next',
2546                 html_content, 'next link', default=None)
2547             if next_link is None:
2548                 break
2549             result_url = compat_urlparse.urljoin('https://www.youtube.com/', next_link)
2550
2551         if len(videos) > n:
2552             videos = videos[:n]
2553         return self.playlist_result(videos, query)
2554
2555
2556 class YoutubeSearchDateIE(YoutubeSearchIE):
2557     IE_NAME = YoutubeSearchIE.IE_NAME + ':date'
2558     _SEARCH_KEY = 'ytsearchdate'
2559     IE_DESC = 'YouTube.com searches, newest videos first'
2560     _EXTRA_QUERY_ARGS = {'search_sort': 'video_date_uploaded'}
2561
2562
2563 class YoutubeSearchURLIE(YoutubePlaylistBaseInfoExtractor):
2564     IE_DESC = 'YouTube.com search URLs'
2565     IE_NAME = 'youtube:search_url'
2566     _VALID_URL = r'https?://(?:www\.)?youtube\.com/results\?(.*?&)?(?:search_query|q)=(?P<query>[^&]+)(?:[&]|$)'
2567     _VIDEO_RE = r'href="\s*/watch\?v=(?P<id>[0-9A-Za-z_-]{11})(?:[^"]*"[^>]+\btitle="(?P<title>[^"]+))?'
2568     _TESTS = [{
2569         'url': 'https://www.youtube.com/results?baz=bar&search_query=youtube-dl+test+video&filters=video&lclk=video',
2570         'playlist_mincount': 5,
2571         'info_dict': {
2572             'title': 'youtube-dl test video',
2573         }
2574     }, {
2575         'url': 'https://www.youtube.com/results?q=test&sp=EgQIBBgB',
2576         'only_matching': True,
2577     }]
2578
2579     def _real_extract(self, url):
2580         mobj = re.match(self._VALID_URL, url)
2581         query = compat_urllib_parse_unquote_plus(mobj.group('query'))
2582         webpage = self._download_webpage(url, query)
2583         return self.playlist_result(self._process_page(webpage), playlist_title=query)
2584
2585
2586 class YoutubeShowIE(YoutubePlaylistsBaseInfoExtractor):
2587     IE_DESC = 'YouTube.com (multi-season) shows'
2588     _VALID_URL = r'https?://(?:www\.)?youtube\.com/show/(?P<id>[^?#]*)'
2589     IE_NAME = 'youtube:show'
2590     _TESTS = [{
2591         'url': 'https://www.youtube.com/show/airdisasters',
2592         'playlist_mincount': 5,
2593         'info_dict': {
2594             'id': 'airdisasters',
2595             'title': 'Air Disasters',
2596         }
2597     }]
2598
2599     def _real_extract(self, url):
2600         playlist_id = self._match_id(url)
2601         return super(YoutubeShowIE, self)._real_extract(
2602             'https://www.youtube.com/show/%s/playlists' % playlist_id)
2603
2604
2605 class YoutubeFeedsInfoExtractor(YoutubeBaseInfoExtractor):
2606     """
2607     Base class for feed extractors
2608     Subclasses must define the _FEED_NAME and _PLAYLIST_TITLE properties.
2609     """
2610     _LOGIN_REQUIRED = True
2611
2612     @property
2613     def IE_NAME(self):
2614         return 'youtube:%s' % self._FEED_NAME
2615
2616     def _real_initialize(self):
2617         self._login()
2618
2619     def _real_extract(self, url):
2620         page = self._download_webpage(
2621             'https://www.youtube.com/feed/%s' % self._FEED_NAME, self._PLAYLIST_TITLE)
2622
2623         # The extraction process is the same as for playlists, but the regex
2624         # for the video ids doesn't contain an index
2625         ids = []
2626         more_widget_html = content_html = page
2627         for page_num in itertools.count(1):
2628             matches = re.findall(r'href="\s*/watch\?v=([0-9A-Za-z_-]{11})', content_html)
2629
2630             # 'recommended' feed has infinite 'load more' and each new portion spins
2631             # the same videos in (sometimes) slightly different order, so we'll check
2632             # for unicity and break when portion has no new videos
2633             new_ids = filter(lambda video_id: video_id not in ids, orderedSet(matches))
2634             if not new_ids:
2635                 break
2636
2637             ids.extend(new_ids)
2638
2639             mobj = re.search(r'data-uix-load-more-href="/?(?P<more>[^"]+)"', more_widget_html)
2640             if not mobj:
2641                 break
2642
2643             more = self._download_json(
2644                 'https://youtube.com/%s' % mobj.group('more'), self._PLAYLIST_TITLE,
2645                 'Downloading page #%s' % page_num,
2646                 transform_source=uppercase_escape)
2647             content_html = more['content_html']
2648             more_widget_html = more['load_more_widget_html']
2649
2650         return self.playlist_result(
2651             self._ids_to_results(ids), playlist_title=self._PLAYLIST_TITLE)
2652
2653
2654 class YoutubeWatchLaterIE(YoutubePlaylistIE):
2655     IE_NAME = 'youtube:watchlater'
2656     IE_DESC = 'Youtube watch later list, ":ytwatchlater" for short (requires authentication)'
2657     _VALID_URL = r'https?://(?:www\.)?youtube\.com/(?:feed/watch_later|(?:playlist|watch)\?(?:.+&)?list=WL)|:ytwatchlater'
2658
2659     _TESTS = [{
2660         'url': 'https://www.youtube.com/playlist?list=WL',
2661         'only_matching': True,
2662     }, {
2663         'url': 'https://www.youtube.com/watch?v=bCNU9TrbiRk&index=1&list=WL',
2664         'only_matching': True,
2665     }]
2666
2667     def _real_extract(self, url):
2668         _, video = self._check_download_just_video(url, 'WL')
2669         if video:
2670             return video
2671         _, playlist = self._extract_playlist('WL')
2672         return playlist
2673
2674
2675 class YoutubeFavouritesIE(YoutubeBaseInfoExtractor):
2676     IE_NAME = 'youtube:favorites'
2677     IE_DESC = 'YouTube.com favourite videos, ":ytfav" for short (requires authentication)'
2678     _VALID_URL = r'https?://(?:www\.)?youtube\.com/my_favorites|:ytfav(?:ou?rites)?'
2679     _LOGIN_REQUIRED = True
2680
2681     def _real_extract(self, url):
2682         webpage = self._download_webpage('https://www.youtube.com/my_favorites', 'Youtube Favourites videos')
2683         playlist_id = self._search_regex(r'list=(.+?)["&]', webpage, 'favourites playlist id')
2684         return self.url_result(playlist_id, 'YoutubePlaylist')
2685
2686
2687 class YoutubeRecommendedIE(YoutubeFeedsInfoExtractor):
2688     IE_DESC = 'YouTube.com recommended videos, ":ytrec" for short (requires authentication)'
2689     _VALID_URL = r'https?://(?:www\.)?youtube\.com/feed/recommended|:ytrec(?:ommended)?'
2690     _FEED_NAME = 'recommended'
2691     _PLAYLIST_TITLE = 'Youtube Recommended videos'
2692
2693
2694 class YoutubeSubscriptionsIE(YoutubeFeedsInfoExtractor):
2695     IE_DESC = 'YouTube.com subscriptions feed, "ytsubs" keyword (requires authentication)'
2696     _VALID_URL = r'https?://(?:www\.)?youtube\.com/feed/subscriptions|:ytsubs(?:criptions)?'
2697     _FEED_NAME = 'subscriptions'
2698     _PLAYLIST_TITLE = 'Youtube Subscriptions'
2699
2700
2701 class YoutubeHistoryIE(YoutubeFeedsInfoExtractor):
2702     IE_DESC = 'Youtube watch history, ":ythistory" for short (requires authentication)'
2703     _VALID_URL = r'https?://(?:www\.)?youtube\.com/feed/history|:ythistory'
2704     _FEED_NAME = 'history'
2705     _PLAYLIST_TITLE = 'Youtube History'
2706
2707
2708 class YoutubeTruncatedURLIE(InfoExtractor):
2709     IE_NAME = 'youtube:truncated_url'
2710     IE_DESC = False  # Do not list
2711     _VALID_URL = r'''(?x)
2712         (?:https?://)?
2713         (?:\w+\.)?[yY][oO][uU][tT][uU][bB][eE](?:-nocookie)?\.com/
2714         (?:watch\?(?:
2715             feature=[a-z_]+|
2716             annotation_id=annotation_[^&]+|
2717             x-yt-cl=[0-9]+|
2718             hl=[^&]*|
2719             t=[0-9]+
2720         )?
2721         |
2722             attribution_link\?a=[^&]+
2723         )
2724         $
2725     '''
2726
2727     _TESTS = [{
2728         'url': 'https://www.youtube.com/watch?annotation_id=annotation_3951667041',
2729         'only_matching': True,
2730     }, {
2731         'url': 'https://www.youtube.com/watch?',
2732         'only_matching': True,
2733     }, {
2734         'url': 'https://www.youtube.com/watch?x-yt-cl=84503534',
2735         'only_matching': True,
2736     }, {
2737         'url': 'https://www.youtube.com/watch?feature=foo',
2738         'only_matching': True,
2739     }, {
2740         'url': 'https://www.youtube.com/watch?hl=en-GB',
2741         'only_matching': True,
2742     }, {
2743         'url': 'https://www.youtube.com/watch?t=2372',
2744         'only_matching': True,
2745     }]
2746
2747     def _real_extract(self, url):
2748         raise ExtractorError(
2749             'Did you forget to quote the URL? Remember that & is a meta '
2750             'character in most shells, so you want to put the URL in quotes, '
2751             'like  youtube-dl '
2752             '"https://www.youtube.com/watch?feature=foo&v=BaW_jenozKc" '
2753             ' or simply  youtube-dl BaW_jenozKc  .',
2754             expected=True)
2755
2756
2757 class YoutubeTruncatedIDIE(InfoExtractor):
2758     IE_NAME = 'youtube:truncated_id'
2759     IE_DESC = False  # Do not list
2760     _VALID_URL = r'https?://(?:www\.)?youtube\.com/watch\?v=(?P<id>[0-9A-Za-z_-]{1,10})$'
2761
2762     _TESTS = [{
2763         'url': 'https://www.youtube.com/watch?v=N_708QY7Ob',
2764         'only_matching': True,
2765     }]
2766
2767     def _real_extract(self, url):
2768         video_id = self._match_id(url)
2769         raise ExtractorError(
2770             'Incomplete YouTube ID %s. URL %s looks truncated.' % (video_id, url),
2771             expected=True)