_ 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             # The following content has been identified by the YouTube community
1008             # as inappropriate or offensive to some audiences.
1009             'url': 'https://www.youtube.com/watch?v=6SJNVb0GnPI',
1010             'info_dict': {
1011                 'id': '6SJNVb0GnPI',
1012                 'ext': 'mp4',
1013                 'title': 'Race Differences in Intelligence',
1014                 'description': 'md5:5d161533167390427a1f8ee89a1fc6f1',
1015                 'duration': 965,
1016                 'upload_date': '20140124',
1017                 'uploader': 'New Century Foundation',
1018                 'uploader_id': 'UCEJYpZGqgUob0zVVEaLhvVg',
1019                 'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UCEJYpZGqgUob0zVVEaLhvVg',
1020                 'license': 'Standard YouTube License',
1021                 'view_count': int,
1022             },
1023             'params': {
1024                 'skip_download': True,
1025             },
1026         },
1027         {
1028             # itag 212
1029             'url': '1t24XAntNCY',
1030             'only_matching': True,
1031         },
1032         {
1033             # geo restricted to JP
1034             'url': 'sJL6WA-aGkQ',
1035             'only_matching': True,
1036         },
1037         {
1038             'url': 'https://www.youtube.com/watch?v=MuAGGZNfUkU&list=RDMM',
1039             'only_matching': True,
1040         },
1041     ]
1042
1043     def __init__(self, *args, **kwargs):
1044         super(YoutubeIE, self).__init__(*args, **kwargs)
1045         self._player_cache = {}
1046
1047     def report_video_info_webpage_download(self, video_id):
1048         """Report attempt to download video info webpage."""
1049         self.to_screen('%s: Downloading video info webpage' % video_id)
1050
1051     def report_information_extraction(self, video_id):
1052         """Report attempt to extract video information."""
1053         self.to_screen('%s: Extracting video information' % video_id)
1054
1055     def report_unavailable_format(self, video_id, format):
1056         """Report extracted video URL."""
1057         self.to_screen('%s: Format %s not available' % (video_id, format))
1058
1059     def report_rtmp_download(self):
1060         """Indicate the download will use the RTMP protocol."""
1061         self.to_screen('RTMP download detected')
1062
1063     def _signature_cache_id(self, example_sig):
1064         """ Return a string representation of a signature """
1065         return '.'.join(compat_str(len(part)) for part in example_sig.split('.'))
1066
1067     def _extract_signature_function(self, video_id, player_url, example_sig):
1068         id_m = re.match(
1069             r'.*?-(?P<id>[a-zA-Z0-9_-]+)(?:/watch_as3|/html5player(?:-new)?|(?:/[a-z]{2}_[A-Z]{2})?/base)?\.(?P<ext>[a-z]+)$',
1070             player_url)
1071         if not id_m:
1072             raise ExtractorError('Cannot identify player %r' % player_url)
1073         player_type = id_m.group('ext')
1074         player_id = id_m.group('id')
1075
1076         # Read from filesystem cache
1077         func_id = '%s_%s_%s' % (
1078             player_type, player_id, self._signature_cache_id(example_sig))
1079         assert os.path.basename(func_id) == func_id
1080
1081         cache_spec = self._downloader.cache.load('youtube-sigfuncs', func_id)
1082         if cache_spec is not None:
1083             return lambda s: ''.join(s[i] for i in cache_spec)
1084
1085         download_note = (
1086             'Downloading player %s' % player_url
1087             if self._downloader.params.get('verbose') else
1088             'Downloading %s player %s' % (player_type, player_id)
1089         )
1090         if player_type == 'js':
1091             code = self._download_webpage(
1092                 player_url, video_id,
1093                 note=download_note,
1094                 errnote='Download of %s failed' % player_url)
1095             res = self._parse_sig_js(code)
1096         elif player_type == 'swf':
1097             urlh = self._request_webpage(
1098                 player_url, video_id,
1099                 note=download_note,
1100                 errnote='Download of %s failed' % player_url)
1101             code = urlh.read()
1102             res = self._parse_sig_swf(code)
1103         else:
1104             assert False, 'Invalid player type %r' % player_type
1105
1106         test_string = ''.join(map(compat_chr, range(len(example_sig))))
1107         cache_res = res(test_string)
1108         cache_spec = [ord(c) for c in cache_res]
1109
1110         self._downloader.cache.store('youtube-sigfuncs', func_id, cache_spec)
1111         return res
1112
1113     def _print_sig_code(self, func, example_sig):
1114         def gen_sig_code(idxs):
1115             def _genslice(start, end, step):
1116                 starts = '' if start == 0 else str(start)
1117                 ends = (':%d' % (end + step)) if end + step >= 0 else ':'
1118                 steps = '' if step == 1 else (':%d' % step)
1119                 return 's[%s%s%s]' % (starts, ends, steps)
1120
1121             step = None
1122             # Quelch pyflakes warnings - start will be set when step is set
1123             start = '(Never used)'
1124             for i, prev in zip(idxs[1:], idxs[:-1]):
1125                 if step is not None:
1126                     if i - prev == step:
1127                         continue
1128                     yield _genslice(start, prev, step)
1129                     step = None
1130                     continue
1131                 if i - prev in [-1, 1]:
1132                     step = i - prev
1133                     start = prev
1134                     continue
1135                 else:
1136                     yield 's[%d]' % prev
1137             if step is None:
1138                 yield 's[%d]' % i
1139             else:
1140                 yield _genslice(start, i, step)
1141
1142         test_string = ''.join(map(compat_chr, range(len(example_sig))))
1143         cache_res = func(test_string)
1144         cache_spec = [ord(c) for c in cache_res]
1145         expr_code = ' + '.join(gen_sig_code(cache_spec))
1146         signature_id_tuple = '(%s)' % (
1147             ', '.join(compat_str(len(p)) for p in example_sig.split('.')))
1148         code = ('if tuple(len(p) for p in s.split(\'.\')) == %s:\n'
1149                 '    return %s\n') % (signature_id_tuple, expr_code)
1150         self.to_screen('Extracted signature function:\n' + code)
1151
1152     def _parse_sig_js(self, jscode):
1153         funcname = self._search_regex(
1154             (r'(["\'])signature\1\s*,\s*(?P<sig>[a-zA-Z0-9$]+)\(',
1155              r'\.sig\|\|(?P<sig>[a-zA-Z0-9$]+)\('),
1156             jscode, 'Initial JS player signature function name', group='sig')
1157
1158         jsi = JSInterpreter(jscode)
1159         initial_function = jsi.extract_function(funcname)
1160         return lambda s: initial_function([s])
1161
1162     def _parse_sig_swf(self, file_contents):
1163         swfi = SWFInterpreter(file_contents)
1164         TARGET_CLASSNAME = 'SignatureDecipher'
1165         searched_class = swfi.extract_class(TARGET_CLASSNAME)
1166         initial_function = swfi.extract_function(searched_class, 'decipher')
1167         return lambda s: initial_function([s])
1168
1169     def _decrypt_signature(self, s, video_id, player_url, age_gate=False):
1170         """Turn the encrypted s field into a working signature"""
1171
1172         if player_url is None:
1173             raise ExtractorError('Cannot decrypt signature without player_url')
1174
1175         if player_url.startswith('//'):
1176             player_url = 'https:' + player_url
1177         elif not re.match(r'https?://', player_url):
1178             player_url = compat_urlparse.urljoin(
1179                 'https://www.youtube.com', player_url)
1180         try:
1181             player_id = (player_url, self._signature_cache_id(s))
1182             if player_id not in self._player_cache:
1183                 func = self._extract_signature_function(
1184                     video_id, player_url, s
1185                 )
1186                 self._player_cache[player_id] = func
1187             func = self._player_cache[player_id]
1188             if self._downloader.params.get('youtube_print_sig_code'):
1189                 self._print_sig_code(func, s)
1190             return func(s)
1191         except Exception as e:
1192             tb = traceback.format_exc()
1193             raise ExtractorError(
1194                 'Signature extraction failed: ' + tb, cause=e)
1195
1196     def _get_subtitles(self, video_id, webpage):
1197         try:
1198             subs_doc = self._download_xml(
1199                 'https://video.google.com/timedtext?hl=en&type=list&v=%s' % video_id,
1200                 video_id, note=False)
1201         except ExtractorError as err:
1202             self._downloader.report_warning('unable to download video subtitles: %s' % error_to_compat_str(err))
1203             return {}
1204
1205         sub_lang_list = {}
1206         for track in subs_doc.findall('track'):
1207             lang = track.attrib['lang_code']
1208             if lang in sub_lang_list:
1209                 continue
1210             sub_formats = []
1211             for ext in self._SUBTITLE_FORMATS:
1212                 params = compat_urllib_parse_urlencode({
1213                     'lang': lang,
1214                     'v': video_id,
1215                     'fmt': ext,
1216                     'name': track.attrib['name'].encode('utf-8'),
1217                 })
1218                 sub_formats.append({
1219                     'url': 'https://www.youtube.com/api/timedtext?' + params,
1220                     'ext': ext,
1221                 })
1222             sub_lang_list[lang] = sub_formats
1223         if not sub_lang_list:
1224             self._downloader.report_warning('video doesn\'t have subtitles')
1225             return {}
1226         return sub_lang_list
1227
1228     def _get_ytplayer_config(self, video_id, webpage):
1229         patterns = (
1230             # User data may contain arbitrary character sequences that may affect
1231             # JSON extraction with regex, e.g. when '};' is contained the second
1232             # regex won't capture the whole JSON. Yet working around by trying more
1233             # concrete regex first keeping in mind proper quoted string handling
1234             # to be implemented in future that will replace this workaround (see
1235             # https://github.com/rg3/youtube-dl/issues/7468,
1236             # https://github.com/rg3/youtube-dl/pull/7599)
1237             r';ytplayer\.config\s*=\s*({.+?});ytplayer',
1238             r';ytplayer\.config\s*=\s*({.+?});',
1239         )
1240         config = self._search_regex(
1241             patterns, webpage, 'ytplayer.config', default=None)
1242         if config:
1243             return self._parse_json(
1244                 uppercase_escape(config), video_id, fatal=False)
1245
1246     def _get_automatic_captions(self, video_id, webpage):
1247         """We need the webpage for getting the captions url, pass it as an
1248            argument to speed up the process."""
1249         self.to_screen('%s: Looking for automatic captions' % video_id)
1250         player_config = self._get_ytplayer_config(video_id, webpage)
1251         err_msg = 'Couldn\'t find automatic captions for %s' % video_id
1252         if not player_config:
1253             self._downloader.report_warning(err_msg)
1254             return {}
1255         try:
1256             args = player_config['args']
1257             caption_url = args.get('ttsurl')
1258             if caption_url:
1259                 timestamp = args['timestamp']
1260                 # We get the available subtitles
1261                 list_params = compat_urllib_parse_urlencode({
1262                     'type': 'list',
1263                     'tlangs': 1,
1264                     'asrs': 1,
1265                 })
1266                 list_url = caption_url + '&' + list_params
1267                 caption_list = self._download_xml(list_url, video_id)
1268                 original_lang_node = caption_list.find('track')
1269                 if original_lang_node is None:
1270                     self._downloader.report_warning('Video doesn\'t have automatic captions')
1271                     return {}
1272                 original_lang = original_lang_node.attrib['lang_code']
1273                 caption_kind = original_lang_node.attrib.get('kind', '')
1274
1275                 sub_lang_list = {}
1276                 for lang_node in caption_list.findall('target'):
1277                     sub_lang = lang_node.attrib['lang_code']
1278                     sub_formats = []
1279                     for ext in self._SUBTITLE_FORMATS:
1280                         params = compat_urllib_parse_urlencode({
1281                             'lang': original_lang,
1282                             'tlang': sub_lang,
1283                             'fmt': ext,
1284                             'ts': timestamp,
1285                             'kind': caption_kind,
1286                         })
1287                         sub_formats.append({
1288                             'url': caption_url + '&' + params,
1289                             'ext': ext,
1290                         })
1291                     sub_lang_list[sub_lang] = sub_formats
1292                 return sub_lang_list
1293
1294             def make_captions(sub_url, sub_langs):
1295                 parsed_sub_url = compat_urllib_parse_urlparse(sub_url)
1296                 caption_qs = compat_parse_qs(parsed_sub_url.query)
1297                 captions = {}
1298                 for sub_lang in sub_langs:
1299                     sub_formats = []
1300                     for ext in self._SUBTITLE_FORMATS:
1301                         caption_qs.update({
1302                             'tlang': [sub_lang],
1303                             'fmt': [ext],
1304                         })
1305                         sub_url = compat_urlparse.urlunparse(parsed_sub_url._replace(
1306                             query=compat_urllib_parse_urlencode(caption_qs, True)))
1307                         sub_formats.append({
1308                             'url': sub_url,
1309                             'ext': ext,
1310                         })
1311                     captions[sub_lang] = sub_formats
1312                 return captions
1313
1314             # New captions format as of 22.06.2017
1315             player_response = args.get('player_response')
1316             if player_response and isinstance(player_response, compat_str):
1317                 player_response = self._parse_json(
1318                     player_response, video_id, fatal=False)
1319                 if player_response:
1320                     renderer = player_response['captions']['playerCaptionsTracklistRenderer']
1321                     base_url = renderer['captionTracks'][0]['baseUrl']
1322                     sub_lang_list = []
1323                     for lang in renderer['translationLanguages']:
1324                         lang_code = lang.get('languageCode')
1325                         if lang_code:
1326                             sub_lang_list.append(lang_code)
1327                     return make_captions(base_url, sub_lang_list)
1328
1329             # Some videos don't provide ttsurl but rather caption_tracks and
1330             # caption_translation_languages (e.g. 20LmZk1hakA)
1331             # Does not used anymore as of 22.06.2017
1332             caption_tracks = args['caption_tracks']
1333             caption_translation_languages = args['caption_translation_languages']
1334             caption_url = compat_parse_qs(caption_tracks.split(',')[0])['u'][0]
1335             sub_lang_list = []
1336             for lang in caption_translation_languages.split(','):
1337                 lang_qs = compat_parse_qs(compat_urllib_parse_unquote_plus(lang))
1338                 sub_lang = lang_qs.get('lc', [None])[0]
1339                 if sub_lang:
1340                     sub_lang_list.append(sub_lang)
1341             return make_captions(caption_url, sub_lang_list)
1342         # An extractor error can be raise by the download process if there are
1343         # no automatic captions but there are subtitles
1344         except (KeyError, IndexError, ExtractorError):
1345             self._downloader.report_warning(err_msg)
1346             return {}
1347
1348     def _mark_watched(self, video_id, video_info):
1349         playback_url = video_info.get('videostats_playback_base_url', [None])[0]
1350         if not playback_url:
1351             return
1352         parsed_playback_url = compat_urlparse.urlparse(playback_url)
1353         qs = compat_urlparse.parse_qs(parsed_playback_url.query)
1354
1355         # cpn generation algorithm is reverse engineered from base.js.
1356         # In fact it works even with dummy cpn.
1357         CPN_ALPHABET = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_'
1358         cpn = ''.join((CPN_ALPHABET[random.randint(0, 256) & 63] for _ in range(0, 16)))
1359
1360         qs.update({
1361             'ver': ['2'],
1362             'cpn': [cpn],
1363         })
1364         playback_url = compat_urlparse.urlunparse(
1365             parsed_playback_url._replace(query=compat_urllib_parse_urlencode(qs, True)))
1366
1367         self._download_webpage(
1368             playback_url, video_id, 'Marking watched',
1369             'Unable to mark watched', fatal=False)
1370
1371     @classmethod
1372     def extract_id(cls, url):
1373         mobj = re.match(cls._VALID_URL, url, re.VERBOSE)
1374         if mobj is None:
1375             raise ExtractorError('Invalid URL: %s' % url)
1376         video_id = mobj.group(2)
1377         return video_id
1378
1379     def _extract_annotations(self, video_id):
1380         url = 'https://www.youtube.com/annotations_invideo?features=1&legacy=1&video_id=%s' % video_id
1381         return self._download_webpage(url, video_id, note='Searching for annotations.', errnote='Unable to download video annotations.')
1382
1383     @staticmethod
1384     def _extract_chapters(description, duration):
1385         if not description:
1386             return None
1387         chapter_lines = re.findall(
1388             r'(?:^|<br\s*/>)([^<]*<a[^>]+onclick=["\']yt\.www\.watch\.player\.seekTo[^>]+>(\d{1,2}:\d{1,2}(?::\d{1,2})?)</a>[^>]*)(?=$|<br\s*/>)',
1389             description)
1390         if not chapter_lines:
1391             return None
1392         chapters = []
1393         for next_num, (chapter_line, time_point) in enumerate(
1394                 chapter_lines, start=1):
1395             start_time = parse_duration(time_point)
1396             if start_time is None:
1397                 continue
1398             if start_time > duration:
1399                 break
1400             end_time = (duration if next_num == len(chapter_lines)
1401                         else parse_duration(chapter_lines[next_num][1]))
1402             if end_time is None:
1403                 continue
1404             if end_time > duration:
1405                 end_time = duration
1406             if start_time > end_time:
1407                 break
1408             chapter_title = re.sub(
1409                 r'<a[^>]+>[^<]+</a>', '', chapter_line).strip(' \t-')
1410             chapter_title = re.sub(r'\s+', ' ', chapter_title)
1411             chapters.append({
1412                 'start_time': start_time,
1413                 'end_time': end_time,
1414                 'title': chapter_title,
1415             })
1416         return chapters
1417
1418     def _real_extract(self, url):
1419         url, smuggled_data = unsmuggle_url(url, {})
1420
1421         proto = (
1422             'http' if self._downloader.params.get('prefer_insecure', False)
1423             else 'https')
1424
1425         start_time = None
1426         end_time = None
1427         parsed_url = compat_urllib_parse_urlparse(url)
1428         for component in [parsed_url.fragment, parsed_url.query]:
1429             query = compat_parse_qs(component)
1430             if start_time is None and 't' in query:
1431                 start_time = parse_duration(query['t'][0])
1432             if start_time is None and 'start' in query:
1433                 start_time = parse_duration(query['start'][0])
1434             if end_time is None and 'end' in query:
1435                 end_time = parse_duration(query['end'][0])
1436
1437         # Extract original video URL from URL with redirection, like age verification, using next_url parameter
1438         mobj = re.search(self._NEXT_URL_RE, url)
1439         if mobj:
1440             url = proto + '://www.youtube.com/' + compat_urllib_parse_unquote(mobj.group(1)).lstrip('/')
1441         video_id = self.extract_id(url)
1442
1443         # Get video webpage
1444         url = proto + '://www.youtube.com/watch?v=%s&gl=US&hl=en&has_verified=1&bpctr=9999999999' % video_id
1445         video_webpage = self._download_webpage(url, video_id)
1446
1447         # Attempt to extract SWF player URL
1448         mobj = re.search(r'swfConfig.*?"(https?:\\/\\/.*?watch.*?-.*?\.swf)"', video_webpage)
1449         if mobj is not None:
1450             player_url = re.sub(r'\\(.)', r'\1', mobj.group(1))
1451         else:
1452             player_url = None
1453
1454         dash_mpds = []
1455
1456         def add_dash_mpd(video_info):
1457             dash_mpd = video_info.get('dashmpd')
1458             if dash_mpd and dash_mpd[0] not in dash_mpds:
1459                 dash_mpds.append(dash_mpd[0])
1460
1461         is_live = None
1462         view_count = None
1463
1464         def extract_view_count(v_info):
1465             return int_or_none(try_get(v_info, lambda x: x['view_count'][0]))
1466
1467         # Get video info
1468         embed_webpage = None
1469         if re.search(r'player-age-gate-content">', video_webpage) is not None:
1470             age_gate = True
1471             # We simulate the access to the video from www.youtube.com/v/{video_id}
1472             # this can be viewed without login into Youtube
1473             url = proto + '://www.youtube.com/embed/%s' % video_id
1474             embed_webpage = self._download_webpage(url, video_id, 'Downloading embed webpage')
1475             data = compat_urllib_parse_urlencode({
1476                 'video_id': video_id,
1477                 'eurl': 'https://youtube.googleapis.com/v/' + video_id,
1478                 'sts': self._search_regex(
1479                     r'"sts"\s*:\s*(\d+)', embed_webpage, 'sts', default=''),
1480             })
1481             video_info_url = proto + '://www.youtube.com/get_video_info?' + data
1482             video_info_webpage = self._download_webpage(
1483                 video_info_url, video_id,
1484                 note='Refetching age-gated info webpage',
1485                 errnote='unable to download video info webpage')
1486             video_info = compat_parse_qs(video_info_webpage)
1487             add_dash_mpd(video_info)
1488         else:
1489             age_gate = False
1490             video_info = None
1491             sts = None
1492             # Try looking directly into the video webpage
1493             ytplayer_config = self._get_ytplayer_config(video_id, video_webpage)
1494             if ytplayer_config:
1495                 args = ytplayer_config['args']
1496                 if args.get('url_encoded_fmt_stream_map'):
1497                     # Convert to the same format returned by compat_parse_qs
1498                     video_info = dict((k, [v]) for k, v in args.items())
1499                     add_dash_mpd(video_info)
1500                 # Rental video is not rented but preview is available (e.g.
1501                 # https://www.youtube.com/watch?v=yYr8q0y5Jfg,
1502                 # https://github.com/rg3/youtube-dl/issues/10532)
1503                 if not video_info and args.get('ypc_vid'):
1504                     return self.url_result(
1505                         args['ypc_vid'], YoutubeIE.ie_key(), video_id=args['ypc_vid'])
1506                 if args.get('livestream') == '1' or args.get('live_playback') == 1:
1507                     is_live = True
1508                 sts = ytplayer_config.get('sts')
1509             if not video_info or self._downloader.params.get('youtube_include_dash_manifest', True):
1510                 # We also try looking in get_video_info since it may contain different dashmpd
1511                 # URL that points to a DASH manifest with possibly different itag set (some itags
1512                 # are missing from DASH manifest pointed by webpage's dashmpd, some - from DASH
1513                 # manifest pointed by get_video_info's dashmpd).
1514                 # The general idea is to take a union of itags of both DASH manifests (for example
1515                 # video with such 'manifest behavior' see https://github.com/rg3/youtube-dl/issues/6093)
1516                 self.report_video_info_webpage_download(video_id)
1517                 for el in ('info', 'embedded', 'detailpage', 'vevo', ''):
1518                     query = {
1519                         'video_id': video_id,
1520                         'ps': 'default',
1521                         'eurl': '',
1522                         'gl': 'US',
1523                         'hl': 'en',
1524                     }
1525                     if el:
1526                         query['el'] = el
1527                     if sts:
1528                         query['sts'] = sts
1529                     video_info_webpage = self._download_webpage(
1530                         '%s://www.youtube.com/get_video_info' % proto,
1531                         video_id, note=False,
1532                         errnote='unable to download video info webpage',
1533                         fatal=False, query=query)
1534                     if not video_info_webpage:
1535                         continue
1536                     get_video_info = compat_parse_qs(video_info_webpage)
1537                     add_dash_mpd(get_video_info)
1538                     if view_count is None:
1539                         view_count = extract_view_count(get_video_info)
1540                     if not video_info:
1541                         video_info = get_video_info
1542                     if 'token' in get_video_info:
1543                         # Different get_video_info requests may report different results, e.g.
1544                         # some may report video unavailability, but some may serve it without
1545                         # any complaint (see https://github.com/rg3/youtube-dl/issues/7362,
1546                         # the original webpage as well as el=info and el=embedded get_video_info
1547                         # requests report video unavailability due to geo restriction while
1548                         # el=detailpage succeeds and returns valid data). This is probably
1549                         # due to YouTube measures against IP ranges of hosting providers.
1550                         # Working around by preferring the first succeeded video_info containing
1551                         # the token if no such video_info yet was found.
1552                         if 'token' not in video_info:
1553                             video_info = get_video_info
1554                         break
1555         if 'token' not in video_info:
1556             if 'reason' in video_info:
1557                 if 'The uploader has not made this video available in your country.' in video_info['reason']:
1558                     regions_allowed = self._html_search_meta(
1559                         'regionsAllowed', video_webpage, default=None)
1560                     countries = regions_allowed.split(',') if regions_allowed else None
1561                     self.raise_geo_restricted(
1562                         msg=video_info['reason'][0], countries=countries)
1563                 raise ExtractorError(
1564                     'YouTube said: %s' % video_info['reason'][0],
1565                     expected=True, video_id=video_id)
1566             else:
1567                 raise ExtractorError(
1568                     '"token" parameter not in video info for unknown reason',
1569                     video_id=video_id)
1570
1571         # title
1572         if 'title' in video_info:
1573             video_title = video_info['title'][0]
1574         else:
1575             self._downloader.report_warning('Unable to extract video title')
1576             video_title = '_'
1577
1578         # description
1579         description_original = video_description = get_element_by_id("eow-description", video_webpage)
1580         if video_description:
1581             description_original = video_description = re.sub(r'''(?x)
1582                 <a\s+
1583                     (?:[a-zA-Z-]+="[^"]*"\s+)*?
1584                     (?:title|href)="([^"]+)"\s+
1585                     (?:[a-zA-Z-]+="[^"]*"\s+)*?
1586                     class="[^"]*"[^>]*>
1587                 [^<]+\.{3}\s*
1588                 </a>
1589             ''', r'\1', video_description)
1590             video_description = clean_html(video_description)
1591         else:
1592             fd_mobj = re.search(r'<meta name="description" content="([^"]+)"', video_webpage)
1593             if fd_mobj:
1594                 video_description = unescapeHTML(fd_mobj.group(1))
1595             else:
1596                 video_description = ''
1597
1598         if 'multifeed_metadata_list' in video_info and not smuggled_data.get('force_singlefeed', False):
1599             if not self._downloader.params.get('noplaylist'):
1600                 entries = []
1601                 feed_ids = []
1602                 multifeed_metadata_list = video_info['multifeed_metadata_list'][0]
1603                 for feed in multifeed_metadata_list.split(','):
1604                     # Unquote should take place before split on comma (,) since textual
1605                     # fields may contain comma as well (see
1606                     # https://github.com/rg3/youtube-dl/issues/8536)
1607                     feed_data = compat_parse_qs(compat_urllib_parse_unquote_plus(feed))
1608                     entries.append({
1609                         '_type': 'url_transparent',
1610                         'ie_key': 'Youtube',
1611                         'url': smuggle_url(
1612                             '%s://www.youtube.com/watch?v=%s' % (proto, feed_data['id'][0]),
1613                             {'force_singlefeed': True}),
1614                         'title': '%s (%s)' % (video_title, feed_data['title'][0]),
1615                     })
1616                     feed_ids.append(feed_data['id'][0])
1617                 self.to_screen(
1618                     'Downloading multifeed video (%s) - add --no-playlist to just download video %s'
1619                     % (', '.join(feed_ids), video_id))
1620                 return self.playlist_result(entries, video_id, video_title, video_description)
1621             self.to_screen('Downloading just video %s because of --no-playlist' % video_id)
1622
1623         if view_count is None:
1624             view_count = extract_view_count(video_info)
1625
1626         # Check for "rental" videos
1627         if 'ypc_video_rental_bar_text' in video_info and 'author' not in video_info:
1628             raise ExtractorError('"rental" videos not supported. See https://github.com/rg3/youtube-dl/issues/359 for more information.', expected=True)
1629
1630         # Start extracting information
1631         self.report_information_extraction(video_id)
1632
1633         # uploader
1634         if 'author' not in video_info:
1635             raise ExtractorError('Unable to extract uploader name')
1636         video_uploader = compat_urllib_parse_unquote_plus(video_info['author'][0])
1637
1638         # uploader_id
1639         video_uploader_id = None
1640         video_uploader_url = None
1641         mobj = re.search(
1642             r'<link itemprop="url" href="(?P<uploader_url>https?://www.youtube.com/(?:user|channel)/(?P<uploader_id>[^"]+))">',
1643             video_webpage)
1644         if mobj is not None:
1645             video_uploader_id = mobj.group('uploader_id')
1646             video_uploader_url = mobj.group('uploader_url')
1647         else:
1648             self._downloader.report_warning('unable to extract uploader nickname')
1649
1650         # thumbnail image
1651         # We try first to get a high quality image:
1652         m_thumb = re.search(r'<span itemprop="thumbnail".*?href="(.*?)">',
1653                             video_webpage, re.DOTALL)
1654         if m_thumb is not None:
1655             video_thumbnail = m_thumb.group(1)
1656         elif 'thumbnail_url' not in video_info:
1657             self._downloader.report_warning('unable to extract video thumbnail')
1658             video_thumbnail = None
1659         else:   # don't panic if we can't find it
1660             video_thumbnail = compat_urllib_parse_unquote_plus(video_info['thumbnail_url'][0])
1661
1662         # upload date
1663         upload_date = self._html_search_meta(
1664             'datePublished', video_webpage, 'upload date', default=None)
1665         if not upload_date:
1666             upload_date = self._search_regex(
1667                 [r'(?s)id="eow-date.*?>(.*?)</span>',
1668                  r'(?:id="watch-uploader-info".*?>.*?|["\']simpleText["\']\s*:\s*["\'])(?:Published|Uploaded|Streamed live|Started) on (.+?)[<"\']'],
1669                 video_webpage, 'upload date', default=None)
1670         upload_date = unified_strdate(upload_date)
1671
1672         video_license = self._html_search_regex(
1673             r'<h4[^>]+class="title"[^>]*>\s*License\s*</h4>\s*<ul[^>]*>\s*<li>(.+?)</li',
1674             video_webpage, 'license', default=None)
1675
1676         m_music = re.search(
1677             r'''(?x)
1678                 <h4[^>]+class="title"[^>]*>\s*Music\s*</h4>\s*
1679                 <ul[^>]*>\s*
1680                 <li>(?P<title>.+?)
1681                 by (?P<creator>.+?)
1682                 (?:
1683                     \(.+?\)|
1684                     <a[^>]*
1685                         (?:
1686                             \bhref=["\']/red[^>]*>|             # drop possible
1687                             >\s*Listen ad-free with YouTube Red # YouTube Red ad
1688                         )
1689                     .*?
1690                 )?</li
1691             ''',
1692             video_webpage)
1693         if m_music:
1694             video_alt_title = remove_quotes(unescapeHTML(m_music.group('title')))
1695             video_creator = clean_html(m_music.group('creator'))
1696         else:
1697             video_alt_title = video_creator = None
1698
1699         m_episode = re.search(
1700             r'<div[^>]+id="watch7-headline"[^>]*>\s*<span[^>]*>.*?>(?P<series>[^<]+)</a></b>\s*S(?P<season>\d+)\s*•\s*E(?P<episode>\d+)</span>',
1701             video_webpage)
1702         if m_episode:
1703             series = m_episode.group('series')
1704             season_number = int(m_episode.group('season'))
1705             episode_number = int(m_episode.group('episode'))
1706         else:
1707             series = season_number = episode_number = None
1708
1709         m_cat_container = self._search_regex(
1710             r'(?s)<h4[^>]*>\s*Category\s*</h4>\s*<ul[^>]*>(.*?)</ul>',
1711             video_webpage, 'categories', default=None)
1712         if m_cat_container:
1713             category = self._html_search_regex(
1714                 r'(?s)<a[^<]+>(.*?)</a>', m_cat_container, 'category',
1715                 default=None)
1716             video_categories = None if category is None else [category]
1717         else:
1718             video_categories = None
1719
1720         video_tags = [
1721             unescapeHTML(m.group('content'))
1722             for m in re.finditer(self._meta_regex('og:video:tag'), video_webpage)]
1723
1724         def _extract_count(count_name):
1725             return str_to_int(self._search_regex(
1726                 r'-%s-button[^>]+><span[^>]+class="yt-uix-button-content"[^>]*>([\d,]+)</span>'
1727                 % re.escape(count_name),
1728                 video_webpage, count_name, default=None))
1729
1730         like_count = _extract_count('like')
1731         dislike_count = _extract_count('dislike')
1732
1733         # subtitles
1734         video_subtitles = self.extract_subtitles(video_id, video_webpage)
1735         automatic_captions = self.extract_automatic_captions(video_id, video_webpage)
1736
1737         video_duration = try_get(
1738             video_info, lambda x: int_or_none(x['length_seconds'][0]))
1739         if not video_duration:
1740             video_duration = parse_duration(self._html_search_meta(
1741                 'duration', video_webpage, 'video duration'))
1742
1743         # annotations
1744         video_annotations = None
1745         if self._downloader.params.get('writeannotations', False):
1746             video_annotations = self._extract_annotations(video_id)
1747
1748         chapters = self._extract_chapters(description_original, video_duration)
1749
1750         if 'conn' in video_info and video_info['conn'][0].startswith('rtmp'):
1751             self.report_rtmp_download()
1752             formats = [{
1753                 'format_id': '_rtmp',
1754                 'protocol': 'rtmp',
1755                 'url': video_info['conn'][0],
1756                 'player_url': player_url,
1757             }]
1758         elif len(video_info.get('url_encoded_fmt_stream_map', [''])[0]) >= 1 or len(video_info.get('adaptive_fmts', [''])[0]) >= 1:
1759             encoded_url_map = video_info.get('url_encoded_fmt_stream_map', [''])[0] + ',' + video_info.get('adaptive_fmts', [''])[0]
1760             if 'rtmpe%3Dyes' in encoded_url_map:
1761                 raise ExtractorError('rtmpe downloads are not supported, see https://github.com/rg3/youtube-dl/issues/343 for more information.', expected=True)
1762             formats_spec = {}
1763             fmt_list = video_info.get('fmt_list', [''])[0]
1764             if fmt_list:
1765                 for fmt in fmt_list.split(','):
1766                     spec = fmt.split('/')
1767                     if len(spec) > 1:
1768                         width_height = spec[1].split('x')
1769                         if len(width_height) == 2:
1770                             formats_spec[spec[0]] = {
1771                                 'resolution': spec[1],
1772                                 'width': int_or_none(width_height[0]),
1773                                 'height': int_or_none(width_height[1]),
1774                             }
1775             formats = []
1776             for url_data_str in encoded_url_map.split(','):
1777                 url_data = compat_parse_qs(url_data_str)
1778                 if 'itag' not in url_data or 'url' not in url_data:
1779                     continue
1780                 format_id = url_data['itag'][0]
1781                 url = url_data['url'][0]
1782
1783                 if 's' in url_data or self._downloader.params.get('youtube_include_dash_manifest', True):
1784                     ASSETS_RE = r'"assets":.+?"js":\s*("[^"]+")'
1785                     jsplayer_url_json = self._search_regex(
1786                         ASSETS_RE,
1787                         embed_webpage if age_gate else video_webpage,
1788                         'JS player URL (1)', default=None)
1789                     if not jsplayer_url_json and not age_gate:
1790                         # We need the embed website after all
1791                         if embed_webpage is None:
1792                             embed_url = proto + '://www.youtube.com/embed/%s' % video_id
1793                             embed_webpage = self._download_webpage(
1794                                 embed_url, video_id, 'Downloading embed webpage')
1795                         jsplayer_url_json = self._search_regex(
1796                             ASSETS_RE, embed_webpage, 'JS player URL')
1797
1798                     player_url = json.loads(jsplayer_url_json)
1799                     if player_url is None:
1800                         player_url_json = self._search_regex(
1801                             r'ytplayer\.config.*?"url"\s*:\s*("[^"]+")',
1802                             video_webpage, 'age gate player URL')
1803                         player_url = json.loads(player_url_json)
1804
1805                 if 'sig' in url_data:
1806                     url += '&signature=' + url_data['sig'][0]
1807                 elif 's' in url_data:
1808                     encrypted_sig = url_data['s'][0]
1809
1810                     if self._downloader.params.get('verbose'):
1811                         if player_url is None:
1812                             player_version = 'unknown'
1813                             player_desc = 'unknown'
1814                         else:
1815                             if player_url.endswith('swf'):
1816                                 player_version = self._search_regex(
1817                                     r'-(.+?)(?:/watch_as3)?\.swf$', player_url,
1818                                     'flash player', fatal=False)
1819                                 player_desc = 'flash player %s' % player_version
1820                             else:
1821                                 player_version = self._search_regex(
1822                                     [r'html5player-([^/]+?)(?:/html5player(?:-new)?)?\.js',
1823                                      r'(?:www|player)-([^/]+)(?:/[a-z]{2}_[A-Z]{2})?/base\.js'],
1824                                     player_url,
1825                                     'html5 player', fatal=False)
1826                                 player_desc = 'html5 player %s' % player_version
1827
1828                         parts_sizes = self._signature_cache_id(encrypted_sig)
1829                         self.to_screen('{%s} signature length %s, %s' %
1830                                        (format_id, parts_sizes, player_desc))
1831
1832                     signature = self._decrypt_signature(
1833                         encrypted_sig, video_id, player_url, age_gate)
1834                     url += '&signature=' + signature
1835                 if 'ratebypass' not in url:
1836                     url += '&ratebypass=yes'
1837
1838                 dct = {
1839                     'format_id': format_id,
1840                     'url': url,
1841                     'player_url': player_url,
1842                 }
1843                 if format_id in self._formats:
1844                     dct.update(self._formats[format_id])
1845                 if format_id in formats_spec:
1846                     dct.update(formats_spec[format_id])
1847
1848                 # Some itags are not included in DASH manifest thus corresponding formats will
1849                 # lack metadata (see https://github.com/rg3/youtube-dl/pull/5993).
1850                 # Trying to extract metadata from url_encoded_fmt_stream_map entry.
1851                 mobj = re.search(r'^(?P<width>\d+)[xX](?P<height>\d+)$', url_data.get('size', [''])[0])
1852                 width, height = (int(mobj.group('width')), int(mobj.group('height'))) if mobj else (None, None)
1853
1854                 more_fields = {
1855                     'filesize': int_or_none(url_data.get('clen', [None])[0]),
1856                     'tbr': float_or_none(url_data.get('bitrate', [None])[0], 1000),
1857                     'width': width,
1858                     'height': height,
1859                     'fps': int_or_none(url_data.get('fps', [None])[0]),
1860                     'format_note': url_data.get('quality_label', [None])[0] or url_data.get('quality', [None])[0],
1861                 }
1862                 for key, value in more_fields.items():
1863                     if value:
1864                         dct[key] = value
1865                 type_ = url_data.get('type', [None])[0]
1866                 if type_:
1867                     type_split = type_.split(';')
1868                     kind_ext = type_split[0].split('/')
1869                     if len(kind_ext) == 2:
1870                         kind, _ = kind_ext
1871                         dct['ext'] = mimetype2ext(type_split[0])
1872                         if kind in ('audio', 'video'):
1873                             codecs = None
1874                             for mobj in re.finditer(
1875                                     r'(?P<key>[a-zA-Z_-]+)=(?P<quote>["\']?)(?P<val>.+?)(?P=quote)(?:;|$)', type_):
1876                                 if mobj.group('key') == 'codecs':
1877                                     codecs = mobj.group('val')
1878                                     break
1879                             if codecs:
1880                                 dct.update(parse_codecs(codecs))
1881                 formats.append(dct)
1882         elif video_info.get('hlsvp'):
1883             manifest_url = video_info['hlsvp'][0]
1884             formats = []
1885             m3u8_formats = self._extract_m3u8_formats(
1886                 manifest_url, video_id, 'mp4', fatal=False)
1887             for a_format in m3u8_formats:
1888                 itag = self._search_regex(
1889                     r'/itag/(\d+)/', a_format['url'], 'itag', default=None)
1890                 if itag:
1891                     a_format['format_id'] = itag
1892                     if itag in self._formats:
1893                         dct = self._formats[itag].copy()
1894                         dct.update(a_format)
1895                         a_format = dct
1896                 a_format['player_url'] = player_url
1897                 # Accept-Encoding header causes failures in live streams on Youtube and Youtube Gaming
1898                 a_format.setdefault('http_headers', {})['Youtubedl-no-compression'] = 'True'
1899                 formats.append(a_format)
1900         else:
1901             unavailable_message = self._html_search_regex(
1902                 r'(?s)<h1[^>]+id="unavailable-message"[^>]*>(.+?)</h1>',
1903                 video_webpage, 'unavailable message', default=None)
1904             if unavailable_message:
1905                 raise ExtractorError(unavailable_message, expected=True)
1906             raise ExtractorError('no conn, hlsvp or url_encoded_fmt_stream_map information found in video info')
1907
1908         # Look for the DASH manifest
1909         if self._downloader.params.get('youtube_include_dash_manifest', True):
1910             dash_mpd_fatal = True
1911             for mpd_url in dash_mpds:
1912                 dash_formats = {}
1913                 try:
1914                     def decrypt_sig(mobj):
1915                         s = mobj.group(1)
1916                         dec_s = self._decrypt_signature(s, video_id, player_url, age_gate)
1917                         return '/signature/%s' % dec_s
1918
1919                     mpd_url = re.sub(r'/s/([a-fA-F0-9\.]+)', decrypt_sig, mpd_url)
1920
1921                     for df in self._extract_mpd_formats(
1922                             mpd_url, video_id, fatal=dash_mpd_fatal,
1923                             formats_dict=self._formats):
1924                         # Do not overwrite DASH format found in some previous DASH manifest
1925                         if df['format_id'] not in dash_formats:
1926                             dash_formats[df['format_id']] = df
1927                         # Additional DASH manifests may end up in HTTP Error 403 therefore
1928                         # allow them to fail without bug report message if we already have
1929                         # some DASH manifest succeeded. This is temporary workaround to reduce
1930                         # burst of bug reports until we figure out the reason and whether it
1931                         # can be fixed at all.
1932                         dash_mpd_fatal = False
1933                 except (ExtractorError, KeyError) as e:
1934                     self.report_warning(
1935                         'Skipping DASH manifest: %r' % e, video_id)
1936                 if dash_formats:
1937                     # Remove the formats we found through non-DASH, they
1938                     # contain less info and it can be wrong, because we use
1939                     # fixed values (for example the resolution). See
1940                     # https://github.com/rg3/youtube-dl/issues/5774 for an
1941                     # example.
1942                     formats = [f for f in formats if f['format_id'] not in dash_formats.keys()]
1943                     formats.extend(dash_formats.values())
1944
1945         # Check for malformed aspect ratio
1946         stretched_m = re.search(
1947             r'<meta\s+property="og:video:tag".*?content="yt:stretch=(?P<w>[0-9]+):(?P<h>[0-9]+)">',
1948             video_webpage)
1949         if stretched_m:
1950             w = float(stretched_m.group('w'))
1951             h = float(stretched_m.group('h'))
1952             # yt:stretch may hold invalid ratio data (e.g. for Q39EVAstoRM ratio is 17:0).
1953             # We will only process correct ratios.
1954             if w > 0 and h > 0:
1955                 ratio = w / h
1956                 for f in formats:
1957                     if f.get('vcodec') != 'none':
1958                         f['stretched_ratio'] = ratio
1959
1960         self._sort_formats(formats)
1961
1962         self.mark_watched(video_id, video_info)
1963
1964         return {
1965             'id': video_id,
1966             'uploader': video_uploader,
1967             'uploader_id': video_uploader_id,
1968             'uploader_url': video_uploader_url,
1969             'upload_date': upload_date,
1970             'license': video_license,
1971             'creator': video_creator,
1972             'title': video_title,
1973             'alt_title': video_alt_title,
1974             'thumbnail': video_thumbnail,
1975             'description': video_description,
1976             'categories': video_categories,
1977             'tags': video_tags,
1978             'subtitles': video_subtitles,
1979             'automatic_captions': automatic_captions,
1980             'duration': video_duration,
1981             'age_limit': 18 if age_gate else 0,
1982             'annotations': video_annotations,
1983             'chapters': chapters,
1984             'webpage_url': proto + '://www.youtube.com/watch?v=%s' % video_id,
1985             'view_count': view_count,
1986             'like_count': like_count,
1987             'dislike_count': dislike_count,
1988             'average_rating': float_or_none(video_info.get('avg_rating', [None])[0]),
1989             'formats': formats,
1990             'is_live': is_live,
1991             'start_time': start_time,
1992             'end_time': end_time,
1993             'series': series,
1994             'season_number': season_number,
1995             'episode_number': episode_number,
1996         }
1997
1998
1999 class YoutubeSharedVideoIE(InfoExtractor):
2000     _VALID_URL = r'(?:https?:)?//(?:www\.)?youtube\.com/shared\?.*\bci=(?P<id>[0-9A-Za-z_-]{11})'
2001     IE_NAME = 'youtube:shared'
2002
2003     _TEST = {
2004         'url': 'https://www.youtube.com/shared?ci=1nEzmT-M4fU',
2005         'info_dict': {
2006             'id': 'uPDB5I9wfp8',
2007             'ext': 'webm',
2008             'title': 'Pocoyo: 90 minutos de episódios completos Português para crianças - PARTE 3',
2009             'description': 'md5:d9e4d9346a2dfff4c7dc4c8cec0f546d',
2010             'upload_date': '20160219',
2011             'uploader': 'Pocoyo - Português (BR)',
2012             'uploader_id': 'PocoyoBrazil',
2013         },
2014         'add_ie': ['Youtube'],
2015         'params': {
2016             # There are already too many Youtube downloads
2017             'skip_download': True,
2018         },
2019     }
2020
2021     def _real_extract(self, url):
2022         video_id = self._match_id(url)
2023
2024         webpage = self._download_webpage(url, video_id)
2025
2026         real_video_id = self._html_search_meta(
2027             'videoId', webpage, 'YouTube video id', fatal=True)
2028
2029         return self.url_result(real_video_id, YoutubeIE.ie_key())
2030
2031
2032 class YoutubePlaylistIE(YoutubePlaylistBaseInfoExtractor):
2033     IE_DESC = 'YouTube.com playlists'
2034     _VALID_URL = r"""(?x)(?:
2035                         (?:https?://)?
2036                         (?:\w+\.)?
2037                         (?:
2038                             youtube\.com/
2039                             (?:
2040                                (?:course|view_play_list|my_playlists|artist|playlist|watch|embed/(?:videoseries|[0-9A-Za-z_-]{11}))
2041                                \? (?:.*?[&;])*? (?:p|a|list)=
2042                             |  p/
2043                             )|
2044                             youtu\.be/[0-9A-Za-z_-]{11}\?.*?\blist=
2045                         )
2046                         (
2047                             (?:PL|LL|EC|UU|FL|RD|UL|TL)?[0-9A-Za-z-_]{10,}
2048                             # Top tracks, they can also include dots
2049                             |(?:MC)[\w\.]*
2050                         )
2051                         .*
2052                      |
2053                         (%(playlist_id)s)
2054                      )""" % {'playlist_id': YoutubeBaseInfoExtractor._PLAYLIST_ID_RE}
2055     _TEMPLATE_URL = 'https://www.youtube.com/playlist?list=%s&disable_polymer=true'
2056     _VIDEO_RE = r'href="\s*/watch\?v=(?P<id>[0-9A-Za-z_-]{11})&amp;[^"]*?index=(?P<index>\d+)(?:[^>]+>(?P<title>[^<]+))?'
2057     IE_NAME = 'youtube:playlist'
2058     _TESTS = [{
2059         'url': 'https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re',
2060         'info_dict': {
2061             'title': 'ytdl test PL',
2062             'id': 'PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re',
2063         },
2064         'playlist_count': 3,
2065     }, {
2066         'url': 'https://www.youtube.com/playlist?list=PLtPgu7CB4gbZDA7i_euNxn75ISqxwZPYx',
2067         'info_dict': {
2068             'id': 'PLtPgu7CB4gbZDA7i_euNxn75ISqxwZPYx',
2069             'title': 'YDL_Empty_List',
2070         },
2071         'playlist_count': 0,
2072         'skip': 'This playlist is private',
2073     }, {
2074         'note': 'Playlist with deleted videos (#651). As a bonus, the video #51 is also twice in this list.',
2075         'url': 'https://www.youtube.com/playlist?list=PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
2076         'info_dict': {
2077             'title': '29C3: Not my department',
2078             'id': 'PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
2079         },
2080         'playlist_count': 95,
2081     }, {
2082         'note': 'issue #673',
2083         'url': 'PLBB231211A4F62143',
2084         'info_dict': {
2085             'title': '[OLD]Team Fortress 2 (Class-based LP)',
2086             'id': 'PLBB231211A4F62143',
2087         },
2088         'playlist_mincount': 26,
2089     }, {
2090         'note': 'Large playlist',
2091         'url': 'https://www.youtube.com/playlist?list=UUBABnxM4Ar9ten8Mdjj1j0Q',
2092         'info_dict': {
2093             'title': 'Uploads from Cauchemar',
2094             'id': 'UUBABnxM4Ar9ten8Mdjj1j0Q',
2095         },
2096         'playlist_mincount': 799,
2097     }, {
2098         'url': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
2099         'info_dict': {
2100             'title': 'YDL_safe_search',
2101             'id': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
2102         },
2103         'playlist_count': 2,
2104         'skip': 'This playlist is private',
2105     }, {
2106         'note': 'embedded',
2107         'url': 'https://www.youtube.com/embed/videoseries?list=PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
2108         'playlist_count': 4,
2109         'info_dict': {
2110             'title': 'JODA15',
2111             'id': 'PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
2112         }
2113     }, {
2114         'url': 'http://www.youtube.com/embed/_xDOZElKyNU?list=PLsyOSbh5bs16vubvKePAQ1x3PhKavfBIl',
2115         'playlist_mincount': 485,
2116         'info_dict': {
2117             'title': '2017 華語最新單曲 (2/24更新)',
2118             'id': 'PLsyOSbh5bs16vubvKePAQ1x3PhKavfBIl',
2119         }
2120     }, {
2121         'note': 'Embedded SWF player',
2122         'url': 'https://www.youtube.com/p/YN5VISEtHet5D4NEvfTd0zcgFk84NqFZ?hl=en_US&fs=1&rel=0',
2123         'playlist_count': 4,
2124         'info_dict': {
2125             'title': 'JODA7',
2126             'id': 'YN5VISEtHet5D4NEvfTd0zcgFk84NqFZ',
2127         }
2128     }, {
2129         'note': 'Buggy playlist: the webpage has a "Load more" button but it doesn\'t have more videos',
2130         'url': 'https://www.youtube.com/playlist?list=UUXw-G3eDE9trcvY2sBMM_aA',
2131         'info_dict': {
2132             'title': 'Uploads from Interstellar Movie',
2133             'id': 'UUXw-G3eDE9trcvY2sBMM_aA',
2134         },
2135         'playlist_mincount': 21,
2136     }, {
2137         # Playlist URL that does not actually serve a playlist
2138         'url': 'https://www.youtube.com/watch?v=FqZTN594JQw&list=PLMYEtVRpaqY00V9W81Cwmzp6N6vZqfUKD4',
2139         'info_dict': {
2140             'id': 'FqZTN594JQw',
2141             'ext': 'webm',
2142             'title': "Smiley's People 01 detective, Adventure Series, Action",
2143             'uploader': 'STREEM',
2144             'uploader_id': 'UCyPhqAZgwYWZfxElWVbVJng',
2145             'uploader_url': r're:https?://(?:www\.)?youtube\.com/channel/UCyPhqAZgwYWZfxElWVbVJng',
2146             'upload_date': '20150526',
2147             'license': 'Standard YouTube License',
2148             'description': 'md5:507cdcb5a49ac0da37a920ece610be80',
2149             'categories': ['People & Blogs'],
2150             'tags': list,
2151             'like_count': int,
2152             'dislike_count': int,
2153         },
2154         'params': {
2155             'skip_download': True,
2156         },
2157         'add_ie': [YoutubeIE.ie_key()],
2158     }, {
2159         'url': 'https://youtu.be/yeWKywCrFtk?list=PL2qgrgXsNUG5ig9cat4ohreBjYLAPC0J5',
2160         'info_dict': {
2161             'id': 'yeWKywCrFtk',
2162             'ext': 'mp4',
2163             'title': 'Small Scale Baler and Braiding Rugs',
2164             'uploader': 'Backus-Page House Museum',
2165             'uploader_id': 'backuspagemuseum',
2166             'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/backuspagemuseum',
2167             'upload_date': '20161008',
2168             'license': 'Standard YouTube License',
2169             'description': 'md5:800c0c78d5eb128500bffd4f0b4f2e8a',
2170             'categories': ['Nonprofits & Activism'],
2171             'tags': list,
2172             'like_count': int,
2173             'dislike_count': int,
2174         },
2175         'params': {
2176             'noplaylist': True,
2177             'skip_download': True,
2178         },
2179     }, {
2180         'url': 'https://youtu.be/uWyaPkt-VOI?list=PL9D9FC436B881BA21',
2181         'only_matching': True,
2182     }, {
2183         'url': 'TLGGrESM50VT6acwMjAyMjAxNw',
2184         'only_matching': True,
2185     }]
2186
2187     def _real_initialize(self):
2188         self._login()
2189
2190     def _extract_mix(self, playlist_id):
2191         # The mixes are generated from a single video
2192         # the id of the playlist is just 'RD' + video_id
2193         ids = []
2194         last_id = playlist_id[-11:]
2195         for n in itertools.count(1):
2196             url = 'https://youtube.com/watch?v=%s&list=%s' % (last_id, playlist_id)
2197             webpage = self._download_webpage(
2198                 url, playlist_id, 'Downloading page {0} of Youtube mix'.format(n))
2199             new_ids = orderedSet(re.findall(
2200                 r'''(?xs)data-video-username=".*?".*?
2201                            href="/watch\?v=([0-9A-Za-z_-]{11})&amp;[^"]*?list=%s''' % re.escape(playlist_id),
2202                 webpage))
2203             # Fetch new pages until all the videos are repeated, it seems that
2204             # there are always 51 unique videos.
2205             new_ids = [_id for _id in new_ids if _id not in ids]
2206             if not new_ids:
2207                 break
2208             ids.extend(new_ids)
2209             last_id = ids[-1]
2210
2211         url_results = self._ids_to_results(ids)
2212
2213         search_title = lambda class_name: get_element_by_attribute('class', class_name, webpage)
2214         title_span = (
2215             search_title('playlist-title') or
2216             search_title('title long-title') or
2217             search_title('title'))
2218         title = clean_html(title_span)
2219
2220         return self.playlist_result(url_results, playlist_id, title)
2221
2222     def _extract_playlist(self, playlist_id):
2223         url = self._TEMPLATE_URL % playlist_id
2224         page = self._download_webpage(url, playlist_id)
2225
2226         # the yt-alert-message now has tabindex attribute (see https://github.com/rg3/youtube-dl/issues/11604)
2227         for match in re.findall(r'<div class="yt-alert-message"[^>]*>([^<]+)</div>', page):
2228             match = match.strip()
2229             # Check if the playlist exists or is private
2230             mobj = re.match(r'[^<]*(?:The|This) playlist (?P<reason>does not exist|is private)[^<]*', match)
2231             if mobj:
2232                 reason = mobj.group('reason')
2233                 message = 'This playlist %s' % reason
2234                 if 'private' in reason:
2235                     message += ', use --username or --netrc to access it'
2236                 message += '.'
2237                 raise ExtractorError(message, expected=True)
2238             elif re.match(r'[^<]*Invalid parameters[^<]*', match):
2239                 raise ExtractorError(
2240                     'Invalid parameters. Maybe URL is incorrect.',
2241                     expected=True)
2242             elif re.match(r'[^<]*Choose your language[^<]*', match):
2243                 continue
2244             else:
2245                 self.report_warning('Youtube gives an alert message: ' + match)
2246
2247         playlist_title = self._html_search_regex(
2248             r'(?s)<h1 class="pl-header-title[^"]*"[^>]*>\s*(.*?)\s*</h1>',
2249             page, 'title', default=None)
2250
2251         has_videos = True
2252
2253         if not playlist_title:
2254             try:
2255                 # Some playlist URLs don't actually serve a playlist (e.g.
2256                 # https://www.youtube.com/watch?v=FqZTN594JQw&list=PLMYEtVRpaqY00V9W81Cwmzp6N6vZqfUKD4)
2257                 next(self._entries(page, playlist_id))
2258             except StopIteration:
2259                 has_videos = False
2260
2261         return has_videos, self.playlist_result(
2262             self._entries(page, playlist_id), playlist_id, playlist_title)
2263
2264     def _check_download_just_video(self, url, playlist_id):
2265         # Check if it's a video-specific URL
2266         query_dict = compat_urlparse.parse_qs(compat_urlparse.urlparse(url).query)
2267         video_id = query_dict.get('v', [None])[0] or self._search_regex(
2268             r'(?:(?:^|//)youtu\.be/|youtube\.com/embed/(?!videoseries))([0-9A-Za-z_-]{11})', url,
2269             'video id', default=None)
2270         if video_id:
2271             if self._downloader.params.get('noplaylist'):
2272                 self.to_screen('Downloading just video %s because of --no-playlist' % video_id)
2273                 return video_id, self.url_result(video_id, 'Youtube', video_id=video_id)
2274             else:
2275                 self.to_screen('Downloading playlist %s - add --no-playlist to just download video %s' % (playlist_id, video_id))
2276                 return video_id, None
2277         return None, None
2278
2279     def _real_extract(self, url):
2280         # Extract playlist id
2281         mobj = re.match(self._VALID_URL, url)
2282         if mobj is None:
2283             raise ExtractorError('Invalid URL: %s' % url)
2284         playlist_id = mobj.group(1) or mobj.group(2)
2285
2286         video_id, video = self._check_download_just_video(url, playlist_id)
2287         if video:
2288             return video
2289
2290         if playlist_id.startswith(('RD', 'UL', 'PU')):
2291             # Mixes require a custom extraction process
2292             return self._extract_mix(playlist_id)
2293
2294         has_videos, playlist = self._extract_playlist(playlist_id)
2295         if has_videos or not video_id:
2296             return playlist
2297
2298         # Some playlist URLs don't actually serve a playlist (see
2299         # https://github.com/rg3/youtube-dl/issues/10537).
2300         # Fallback to plain video extraction if there is a video id
2301         # along with playlist id.
2302         return self.url_result(video_id, 'Youtube', video_id=video_id)
2303
2304
2305 class YoutubeChannelIE(YoutubePlaylistBaseInfoExtractor):
2306     IE_DESC = 'YouTube.com channels'
2307     _VALID_URL = r'https?://(?:youtu\.be|(?:\w+\.)?youtube(?:-nocookie)?\.com)/channel/(?P<id>[0-9A-Za-z_-]+)'
2308     _TEMPLATE_URL = 'https://www.youtube.com/channel/%s/videos'
2309     _VIDEO_RE = r'(?:title="(?P<title>[^"]+)"[^>]+)?href="/watch\?v=(?P<id>[0-9A-Za-z_-]+)&?'
2310     IE_NAME = 'youtube:channel'
2311     _TESTS = [{
2312         'note': 'paginated channel',
2313         'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w',
2314         'playlist_mincount': 91,
2315         'info_dict': {
2316             'id': 'UUKfVa3S1e4PHvxWcwyMMg8w',
2317             'title': 'Uploads from lex will',
2318         }
2319     }, {
2320         'note': 'Age restricted channel',
2321         # from https://www.youtube.com/user/DeusExOfficial
2322         'url': 'https://www.youtube.com/channel/UCs0ifCMCm1icqRbqhUINa0w',
2323         'playlist_mincount': 64,
2324         'info_dict': {
2325             'id': 'UUs0ifCMCm1icqRbqhUINa0w',
2326             'title': 'Uploads from Deus Ex',
2327         },
2328     }]
2329
2330     @classmethod
2331     def suitable(cls, url):
2332         return (False if YoutubePlaylistsIE.suitable(url) or YoutubeLiveIE.suitable(url)
2333                 else super(YoutubeChannelIE, cls).suitable(url))
2334
2335     def _build_template_url(self, url, channel_id):
2336         return self._TEMPLATE_URL % channel_id
2337
2338     def _real_extract(self, url):
2339         channel_id = self._match_id(url)
2340
2341         url = self._build_template_url(url, channel_id)
2342
2343         # Channel by page listing is restricted to 35 pages of 30 items, i.e. 1050 videos total (see #5778)
2344         # Workaround by extracting as a playlist if managed to obtain channel playlist URL
2345         # otherwise fallback on channel by page extraction
2346         channel_page = self._download_webpage(
2347             url + '?view=57', channel_id,
2348             'Downloading channel page', fatal=False)
2349         if channel_page is False:
2350             channel_playlist_id = False
2351         else:
2352             channel_playlist_id = self._html_search_meta(
2353                 'channelId', channel_page, 'channel id', default=None)
2354             if not channel_playlist_id:
2355                 channel_url = self._html_search_meta(
2356                     ('al:ios:url', 'twitter:app:url:iphone', 'twitter:app:url:ipad'),
2357                     channel_page, 'channel url', default=None)
2358                 if channel_url:
2359                     channel_playlist_id = self._search_regex(
2360                         r'vnd\.youtube://user/([0-9A-Za-z_-]+)',
2361                         channel_url, 'channel id', default=None)
2362         if channel_playlist_id and channel_playlist_id.startswith('UC'):
2363             playlist_id = 'UU' + channel_playlist_id[2:]
2364             return self.url_result(
2365                 compat_urlparse.urljoin(url, '/playlist?list=%s' % playlist_id), 'YoutubePlaylist')
2366
2367         channel_page = self._download_webpage(url, channel_id, 'Downloading page #1')
2368         autogenerated = re.search(r'''(?x)
2369                 class="[^"]*?(?:
2370                     channel-header-autogenerated-label|
2371                     yt-channel-title-autogenerated
2372                 )[^"]*"''', channel_page) is not None
2373
2374         if autogenerated:
2375             # The videos are contained in a single page
2376             # the ajax pages can't be used, they are empty
2377             entries = [
2378                 self.url_result(
2379                     video_id, 'Youtube', video_id=video_id,
2380                     video_title=video_title)
2381                 for video_id, video_title in self.extract_videos_from_page(channel_page)]
2382             return self.playlist_result(entries, channel_id)
2383
2384         try:
2385             next(self._entries(channel_page, channel_id))
2386         except StopIteration:
2387             alert_message = self._html_search_regex(
2388                 r'(?s)<div[^>]+class=(["\']).*?\byt-alert-message\b.*?\1[^>]*>(?P<alert>[^<]+)</div>',
2389                 channel_page, 'alert', default=None, group='alert')
2390             if alert_message:
2391                 raise ExtractorError('Youtube said: %s' % alert_message, expected=True)
2392
2393         return self.playlist_result(self._entries(channel_page, channel_id), channel_id)
2394
2395
2396 class YoutubeUserIE(YoutubeChannelIE):
2397     IE_DESC = 'YouTube.com user videos (URL or "ytuser" keyword)'
2398     _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_-]+)'
2399     _TEMPLATE_URL = 'https://www.youtube.com/%s/%s/videos'
2400     IE_NAME = 'youtube:user'
2401
2402     _TESTS = [{
2403         'url': 'https://www.youtube.com/user/TheLinuxFoundation',
2404         'playlist_mincount': 320,
2405         'info_dict': {
2406             'id': 'UUfX55Sx5hEFjoC3cNs6mCUQ',
2407             'title': 'Uploads from The Linux Foundation',
2408         }
2409     }, {
2410         # Only available via https://www.youtube.com/c/12minuteathlete/videos
2411         # but not https://www.youtube.com/user/12minuteathlete/videos
2412         'url': 'https://www.youtube.com/c/12minuteathlete/videos',
2413         'playlist_mincount': 249,
2414         'info_dict': {
2415             'id': 'UUVjM-zV6_opMDx7WYxnjZiQ',
2416             'title': 'Uploads from 12 Minute Athlete',
2417         }
2418     }, {
2419         'url': 'ytuser:phihag',
2420         'only_matching': True,
2421     }, {
2422         'url': 'https://www.youtube.com/c/gametrailers',
2423         'only_matching': True,
2424     }, {
2425         'url': 'https://www.youtube.com/gametrailers',
2426         'only_matching': True,
2427     }, {
2428         # This channel is not available, geo restricted to JP
2429         'url': 'https://www.youtube.com/user/kananishinoSMEJ/videos',
2430         'only_matching': True,
2431     }]
2432
2433     @classmethod
2434     def suitable(cls, url):
2435         # Don't return True if the url can be extracted with other youtube
2436         # extractor, the regex would is too permissive and it would match.
2437         other_yt_ies = iter(klass for (name, klass) in globals().items() if name.startswith('Youtube') and name.endswith('IE') and klass is not cls)
2438         if any(ie.suitable(url) for ie in other_yt_ies):
2439             return False
2440         else:
2441             return super(YoutubeUserIE, cls).suitable(url)
2442
2443     def _build_template_url(self, url, channel_id):
2444         mobj = re.match(self._VALID_URL, url)
2445         return self._TEMPLATE_URL % (mobj.group('user') or 'user', mobj.group('id'))
2446
2447
2448 class YoutubeLiveIE(YoutubeBaseInfoExtractor):
2449     IE_DESC = 'YouTube.com live streams'
2450     _VALID_URL = r'(?P<base_url>https?://(?:\w+\.)?youtube\.com/(?:(?:user|channel|c)/)?(?P<id>[^/]+))/live'
2451     IE_NAME = 'youtube:live'
2452
2453     _TESTS = [{
2454         'url': 'https://www.youtube.com/user/TheYoungTurks/live',
2455         'info_dict': {
2456             'id': 'a48o2S1cPoo',
2457             'ext': 'mp4',
2458             'title': 'The Young Turks - Live Main Show',
2459             'uploader': 'The Young Turks',
2460             'uploader_id': 'TheYoungTurks',
2461             'uploader_url': r're:https?://(?:www\.)?youtube\.com/user/TheYoungTurks',
2462             'upload_date': '20150715',
2463             'license': 'Standard YouTube License',
2464             'description': 'md5:438179573adcdff3c97ebb1ee632b891',
2465             'categories': ['News & Politics'],
2466             'tags': ['Cenk Uygur (TV Program Creator)', 'The Young Turks (Award-Winning Work)', 'Talk Show (TV Genre)'],
2467             'like_count': int,
2468             'dislike_count': int,
2469         },
2470         'params': {
2471             'skip_download': True,
2472         },
2473     }, {
2474         'url': 'https://www.youtube.com/channel/UC1yBKRuGpC1tSM73A0ZjYjQ/live',
2475         'only_matching': True,
2476     }, {
2477         'url': 'https://www.youtube.com/c/CommanderVideoHq/live',
2478         'only_matching': True,
2479     }, {
2480         'url': 'https://www.youtube.com/TheYoungTurks/live',
2481         'only_matching': True,
2482     }]
2483
2484     def _real_extract(self, url):
2485         mobj = re.match(self._VALID_URL, url)
2486         channel_id = mobj.group('id')
2487         base_url = mobj.group('base_url')
2488         webpage = self._download_webpage(url, channel_id, fatal=False)
2489         if webpage:
2490             page_type = self._og_search_property(
2491                 'type', webpage, 'page type', default=None)
2492             video_id = self._html_search_meta(
2493                 'videoId', webpage, 'video id', default=None)
2494             if page_type == 'video' and video_id and re.match(r'^[0-9A-Za-z_-]{11}$', video_id):
2495                 return self.url_result(video_id, YoutubeIE.ie_key())
2496         return self.url_result(base_url)
2497
2498
2499 class YoutubePlaylistsIE(YoutubePlaylistsBaseInfoExtractor):
2500     IE_DESC = 'YouTube.com user/channel playlists'
2501     _VALID_URL = r'https?://(?:\w+\.)?youtube\.com/(?:user|channel)/(?P<id>[^/]+)/playlists'
2502     IE_NAME = 'youtube:playlists'
2503
2504     _TESTS = [{
2505         'url': 'https://www.youtube.com/user/ThirstForScience/playlists',
2506         'playlist_mincount': 4,
2507         'info_dict': {
2508             'id': 'ThirstForScience',
2509             'title': 'Thirst for Science',
2510         },
2511     }, {
2512         # with "Load more" button
2513         'url': 'https://www.youtube.com/user/igorkle1/playlists?view=1&sort=dd',
2514         'playlist_mincount': 70,
2515         'info_dict': {
2516             'id': 'igorkle1',
2517             'title': 'Игорь Клейнер',
2518         },
2519     }, {
2520         'url': 'https://www.youtube.com/channel/UCiU1dHvZObB2iP6xkJ__Icw/playlists',
2521         'playlist_mincount': 17,
2522         'info_dict': {
2523             'id': 'UCiU1dHvZObB2iP6xkJ__Icw',
2524             'title': 'Chem Player',
2525         },
2526     }]
2527
2528
2529 class YoutubeSearchIE(SearchInfoExtractor, YoutubePlaylistIE):
2530     IE_DESC = 'YouTube.com searches'
2531     # there doesn't appear to be a real limit, for example if you search for
2532     # 'python' you get more than 8.000.000 results
2533     _MAX_RESULTS = float('inf')
2534     IE_NAME = 'youtube:search'
2535     _SEARCH_KEY = 'ytsearch'
2536     _EXTRA_QUERY_ARGS = {}
2537     _TESTS = []
2538
2539     def _get_n_results(self, query, n):
2540         """Get a specified number of results for a query"""
2541
2542         videos = []
2543         limit = n
2544
2545         url_query = {
2546             'search_query': query.encode('utf-8'),
2547         }
2548         url_query.update(self._EXTRA_QUERY_ARGS)
2549         result_url = 'https://www.youtube.com/results?' + compat_urllib_parse_urlencode(url_query)
2550
2551         for pagenum in itertools.count(1):
2552             data = self._download_json(
2553                 result_url, video_id='query "%s"' % query,
2554                 note='Downloading page %s' % pagenum,
2555                 errnote='Unable to download API page',
2556                 query={'spf': 'navigate'})
2557             html_content = data[1]['body']['content']
2558
2559             if 'class="search-message' in html_content:
2560                 raise ExtractorError(
2561                     '[youtube] No video results', expected=True)
2562
2563             new_videos = self._ids_to_results(orderedSet(re.findall(
2564                 r'href="/watch\?v=(.{11})', html_content)))
2565             videos += new_videos
2566             if not new_videos or len(videos) > limit:
2567                 break
2568             next_link = self._html_search_regex(
2569                 r'href="(/results\?[^"]*\bsp=[^"]+)"[^>]*>\s*<span[^>]+class="[^"]*\byt-uix-button-content\b[^"]*"[^>]*>Next',
2570                 html_content, 'next link', default=None)
2571             if next_link is None:
2572                 break
2573             result_url = compat_urlparse.urljoin('https://www.youtube.com/', next_link)
2574
2575         if len(videos) > n:
2576             videos = videos[:n]
2577         return self.playlist_result(videos, query)
2578
2579
2580 class YoutubeSearchDateIE(YoutubeSearchIE):
2581     IE_NAME = YoutubeSearchIE.IE_NAME + ':date'
2582     _SEARCH_KEY = 'ytsearchdate'
2583     IE_DESC = 'YouTube.com searches, newest videos first'
2584     _EXTRA_QUERY_ARGS = {'search_sort': 'video_date_uploaded'}
2585
2586
2587 class YoutubeSearchURLIE(YoutubePlaylistBaseInfoExtractor):
2588     IE_DESC = 'YouTube.com search URLs'
2589     IE_NAME = 'youtube:search_url'
2590     _VALID_URL = r'https?://(?:www\.)?youtube\.com/results\?(.*?&)?(?:search_query|q)=(?P<query>[^&]+)(?:[&]|$)'
2591     _VIDEO_RE = r'href="\s*/watch\?v=(?P<id>[0-9A-Za-z_-]{11})(?:[^"]*"[^>]+\btitle="(?P<title>[^"]+))?'
2592     _TESTS = [{
2593         'url': 'https://www.youtube.com/results?baz=bar&search_query=youtube-dl+test+video&filters=video&lclk=video',
2594         'playlist_mincount': 5,
2595         'info_dict': {
2596             'title': 'youtube-dl test video',
2597         }
2598     }, {
2599         'url': 'https://www.youtube.com/results?q=test&sp=EgQIBBgB',
2600         'only_matching': True,
2601     }]
2602
2603     def _real_extract(self, url):
2604         mobj = re.match(self._VALID_URL, url)
2605         query = compat_urllib_parse_unquote_plus(mobj.group('query'))
2606         webpage = self._download_webpage(url, query)
2607         return self.playlist_result(self._process_page(webpage), playlist_title=query)
2608
2609
2610 class YoutubeShowIE(YoutubePlaylistsBaseInfoExtractor):
2611     IE_DESC = 'YouTube.com (multi-season) shows'
2612     _VALID_URL = r'https?://(?:www\.)?youtube\.com/show/(?P<id>[^?#]*)'
2613     IE_NAME = 'youtube:show'
2614     _TESTS = [{
2615         'url': 'https://www.youtube.com/show/airdisasters',
2616         'playlist_mincount': 5,
2617         'info_dict': {
2618             'id': 'airdisasters',
2619             'title': 'Air Disasters',
2620         }
2621     }]
2622
2623     def _real_extract(self, url):
2624         playlist_id = self._match_id(url)
2625         return super(YoutubeShowIE, self)._real_extract(
2626             'https://www.youtube.com/show/%s/playlists' % playlist_id)
2627
2628
2629 class YoutubeFeedsInfoExtractor(YoutubeBaseInfoExtractor):
2630     """
2631     Base class for feed extractors
2632     Subclasses must define the _FEED_NAME and _PLAYLIST_TITLE properties.
2633     """
2634     _LOGIN_REQUIRED = True
2635
2636     @property
2637     def IE_NAME(self):
2638         return 'youtube:%s' % self._FEED_NAME
2639
2640     def _real_initialize(self):
2641         self._login()
2642
2643     def _real_extract(self, url):
2644         page = self._download_webpage(
2645             'https://www.youtube.com/feed/%s' % self._FEED_NAME, self._PLAYLIST_TITLE)
2646
2647         # The extraction process is the same as for playlists, but the regex
2648         # for the video ids doesn't contain an index
2649         ids = []
2650         more_widget_html = content_html = page
2651         for page_num in itertools.count(1):
2652             matches = re.findall(r'href="\s*/watch\?v=([0-9A-Za-z_-]{11})', content_html)
2653
2654             # 'recommended' feed has infinite 'load more' and each new portion spins
2655             # the same videos in (sometimes) slightly different order, so we'll check
2656             # for unicity and break when portion has no new videos
2657             new_ids = filter(lambda video_id: video_id not in ids, orderedSet(matches))
2658             if not new_ids:
2659                 break
2660
2661             ids.extend(new_ids)
2662
2663             mobj = re.search(r'data-uix-load-more-href="/?(?P<more>[^"]+)"', more_widget_html)
2664             if not mobj:
2665                 break
2666
2667             more = self._download_json(
2668                 'https://youtube.com/%s' % mobj.group('more'), self._PLAYLIST_TITLE,
2669                 'Downloading page #%s' % page_num,
2670                 transform_source=uppercase_escape)
2671             content_html = more['content_html']
2672             more_widget_html = more['load_more_widget_html']
2673
2674         return self.playlist_result(
2675             self._ids_to_results(ids), playlist_title=self._PLAYLIST_TITLE)
2676
2677
2678 class YoutubeWatchLaterIE(YoutubePlaylistIE):
2679     IE_NAME = 'youtube:watchlater'
2680     IE_DESC = 'Youtube watch later list, ":ytwatchlater" for short (requires authentication)'
2681     _VALID_URL = r'https?://(?:www\.)?youtube\.com/(?:feed/watch_later|(?:playlist|watch)\?(?:.+&)?list=WL)|:ytwatchlater'
2682
2683     _TESTS = [{
2684         'url': 'https://www.youtube.com/playlist?list=WL',
2685         'only_matching': True,
2686     }, {
2687         'url': 'https://www.youtube.com/watch?v=bCNU9TrbiRk&index=1&list=WL',
2688         'only_matching': True,
2689     }]
2690
2691     def _real_extract(self, url):
2692         _, video = self._check_download_just_video(url, 'WL')
2693         if video:
2694             return video
2695         _, playlist = self._extract_playlist('WL')
2696         return playlist
2697
2698
2699 class YoutubeFavouritesIE(YoutubeBaseInfoExtractor):
2700     IE_NAME = 'youtube:favorites'
2701     IE_DESC = 'YouTube.com favourite videos, ":ytfav" for short (requires authentication)'
2702     _VALID_URL = r'https?://(?:www\.)?youtube\.com/my_favorites|:ytfav(?:ou?rites)?'
2703     _LOGIN_REQUIRED = True
2704
2705     def _real_extract(self, url):
2706         webpage = self._download_webpage('https://www.youtube.com/my_favorites', 'Youtube Favourites videos')
2707         playlist_id = self._search_regex(r'list=(.+?)["&]', webpage, 'favourites playlist id')
2708         return self.url_result(playlist_id, 'YoutubePlaylist')
2709
2710
2711 class YoutubeRecommendedIE(YoutubeFeedsInfoExtractor):
2712     IE_DESC = 'YouTube.com recommended videos, ":ytrec" for short (requires authentication)'
2713     _VALID_URL = r'https?://(?:www\.)?youtube\.com/feed/recommended|:ytrec(?:ommended)?'
2714     _FEED_NAME = 'recommended'
2715     _PLAYLIST_TITLE = 'Youtube Recommended videos'
2716
2717
2718 class YoutubeSubscriptionsIE(YoutubeFeedsInfoExtractor):
2719     IE_DESC = 'YouTube.com subscriptions feed, "ytsubs" keyword (requires authentication)'
2720     _VALID_URL = r'https?://(?:www\.)?youtube\.com/feed/subscriptions|:ytsubs(?:criptions)?'
2721     _FEED_NAME = 'subscriptions'
2722     _PLAYLIST_TITLE = 'Youtube Subscriptions'
2723
2724
2725 class YoutubeHistoryIE(YoutubeFeedsInfoExtractor):
2726     IE_DESC = 'Youtube watch history, ":ythistory" for short (requires authentication)'
2727     _VALID_URL = r'https?://(?:www\.)?youtube\.com/feed/history|:ythistory'
2728     _FEED_NAME = 'history'
2729     _PLAYLIST_TITLE = 'Youtube History'
2730
2731
2732 class YoutubeTruncatedURLIE(InfoExtractor):
2733     IE_NAME = 'youtube:truncated_url'
2734     IE_DESC = False  # Do not list
2735     _VALID_URL = r'''(?x)
2736         (?:https?://)?
2737         (?:\w+\.)?[yY][oO][uU][tT][uU][bB][eE](?:-nocookie)?\.com/
2738         (?:watch\?(?:
2739             feature=[a-z_]+|
2740             annotation_id=annotation_[^&]+|
2741             x-yt-cl=[0-9]+|
2742             hl=[^&]*|
2743             t=[0-9]+
2744         )?
2745         |
2746             attribution_link\?a=[^&]+
2747         )
2748         $
2749     '''
2750
2751     _TESTS = [{
2752         'url': 'https://www.youtube.com/watch?annotation_id=annotation_3951667041',
2753         'only_matching': True,
2754     }, {
2755         'url': 'https://www.youtube.com/watch?',
2756         'only_matching': True,
2757     }, {
2758         'url': 'https://www.youtube.com/watch?x-yt-cl=84503534',
2759         'only_matching': True,
2760     }, {
2761         'url': 'https://www.youtube.com/watch?feature=foo',
2762         'only_matching': True,
2763     }, {
2764         'url': 'https://www.youtube.com/watch?hl=en-GB',
2765         'only_matching': True,
2766     }, {
2767         'url': 'https://www.youtube.com/watch?t=2372',
2768         'only_matching': True,
2769     }]
2770
2771     def _real_extract(self, url):
2772         raise ExtractorError(
2773             'Did you forget to quote the URL? Remember that & is a meta '
2774             'character in most shells, so you want to put the URL in quotes, '
2775             'like  youtube-dl '
2776             '"https://www.youtube.com/watch?feature=foo&v=BaW_jenozKc" '
2777             ' or simply  youtube-dl BaW_jenozKc  .',
2778             expected=True)
2779
2780
2781 class YoutubeTruncatedIDIE(InfoExtractor):
2782     IE_NAME = 'youtube:truncated_id'
2783     IE_DESC = False  # Do not list
2784     _VALID_URL = r'https?://(?:www\.)?youtube\.com/watch\?v=(?P<id>[0-9A-Za-z_-]{1,10})$'
2785
2786     _TESTS = [{
2787         'url': 'https://www.youtube.com/watch?v=N_708QY7Ob',
2788         'only_matching': True,
2789     }]
2790
2791     def _real_extract(self, url):
2792         video_id = self._match_id(url)
2793         raise ExtractorError(
2794             'Incomplete YouTube ID %s. URL %s looks truncated.' % (video_id, url),
2795             expected=True)