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

   1 # coding: utf-8
   2
   3 import json
   4 import netrc
   5 import re
   6 import socket
   7 import itertools
   8 import xml.etree.ElementTree
   9
  10 from .common import InfoExtractor, SearchInfoExtractor
  11 from .subtitles import SubtitlesInfoExtractor
  12 from ..utils import (
  13     compat_http_client,
  14     compat_parse_qs,
  15     compat_urllib_error,
  16     compat_urllib_parse,
  17     compat_urllib_request,
  18     compat_str,
  19
  20     clean_html,
  21     get_element_by_id,
  22     ExtractorError,
  23     unescapeHTML,
  24     unified_strdate,
  25     orderedSet,
  26 )
  27
  28 class YoutubeBaseInfoExtractor(InfoExtractor):
  29     """Provide base functions for Youtube extractors"""
  30     _LOGIN_URL = 'https://accounts.google.com/ServiceLogin'
  31     _LANG_URL = r'https://www.youtube.com/?hl=en&persist_hl=1&gl=US&persist_gl=1&opt_out_ackd=1'
  32     _AGE_URL = 'http://www.youtube.com/verify_age?next_url=/&gl=US&hl=en'
  33     _NETRC_MACHINE = 'youtube'
  34     # If True it will raise an error if no login info is provided
  35     _LOGIN_REQUIRED = False
  36
  37     def report_lang(self):
  38         """Report attempt to set language."""
  39         self.to_screen(u'Setting language')
  40
  41     def _set_language(self):
  42         request = compat_urllib_request.Request(self._LANG_URL)
  43         try:
  44             self.report_lang()
  45             compat_urllib_request.urlopen(request).read()
  46         except (compat_urllib_error.URLError, compat_http_client.HTTPException, socket.error) as err:
  47             self._downloader.report_warning(u'unable to set language: %s' % compat_str(err))
  48             return False
  49         return True
  50
  51     def _login(self):
  52         (username, password) = self._get_login_info()
  53         # No authentication to be performed
  54         if username is None:
  55             if self._LOGIN_REQUIRED:
  56                 raise ExtractorError(u'No login info available, needed for using %s.' % self.IE_NAME, expected=True)
  57             return False
  58
  59         request = compat_urllib_request.Request(self._LOGIN_URL)
  60         try:
  61             login_page = compat_urllib_request.urlopen(request).read().decode('utf-8')
  62         except (compat_urllib_error.URLError, compat_http_client.HTTPException, socket.error) as err:
  63             self._downloader.report_warning(u'unable to fetch login page: %s' % compat_str(err))
  64             return False
  65
  66         galx = None
  67         dsh = None
  68         match = re.search(re.compile(r'<input.+?name="GALX".+?value="(.+?)"', re.DOTALL), login_page)
  69         if match:
  70           galx = match.group(1)
  71         match = re.search(re.compile(r'<input.+?name="dsh".+?value="(.+?)"', re.DOTALL), login_page)
  72         if match:
  73           dsh = match.group(1)
  74
  75         # Log in
  76         login_form_strs = {
  77                 u'continue': u'https://www.youtube.com/signin?action_handle_signin=true&feature=sign_in_button&hl=en_US&nomobiletemp=1',
  78                 u'Email': username,
  79                 u'GALX': galx,
  80                 u'Passwd': password,
  81                 u'PersistentCookie': u'yes',
  82                 u'_utf8': u'霱',
  83                 u'bgresponse': u'js_disabled',
  84                 u'checkConnection': u'',
  85                 u'checkedDomains': u'youtube',
  86                 u'dnConn': u'',
  87                 u'dsh': dsh,
  88                 u'pstMsg': u'0',
  89                 u'rmShown': u'1',
  90                 u'secTok': u'',
  91                 u'signIn': u'Sign in',
  92                 u'timeStmp': u'',
  93                 u'service': u'youtube',
  94                 u'uilel': u'3',
  95                 u'hl': u'en_US',
  96         }
  97         # Convert to UTF-8 *before* urlencode because Python 2.x's urlencode
  98         # chokes on unicode
  99         login_form = dict((k.encode('utf-8'), v.encode('utf-8')) for k,v in login_form_strs.items())
 100         login_data = compat_urllib_parse.urlencode(login_form).encode('ascii')
 101         request = compat_urllib_request.Request(self._LOGIN_URL, login_data)
 102         try:
 103             self.report_login()
 104             login_results = compat_urllib_request.urlopen(request).read().decode('utf-8')
 105             if re.search(r'(?i)<form[^>]* id="gaia_loginform"', login_results) is not None:
 106                 self._downloader.report_warning(u'unable to log in: bad username or password')
 107                 return False
 108         except (compat_urllib_error.URLError, compat_http_client.HTTPException, socket.error) as err:
 109             self._downloader.report_warning(u'unable to log in: %s' % compat_str(err))
 110             return False
 111         return True
 112
 113     def _confirm_age(self):
 114         age_form = {
 115                 'next_url':     '/',
 116                 'action_confirm':   'Confirm',
 117                 }
 118         request = compat_urllib_request.Request(self._AGE_URL, compat_urllib_parse.urlencode(age_form))
 119         try:
 120             self.report_age_confirmation()
 121             compat_urllib_request.urlopen(request).read().decode('utf-8')
 122         except (compat_urllib_error.URLError, compat_http_client.HTTPException, socket.error) as err:
 123             raise ExtractorError(u'Unable to confirm age: %s' % compat_str(err))
 124         return True
 125
 126     def _real_initialize(self):
 127         if self._downloader is None:
 128             return
 129         if not self._set_language():
 130             return
 131         if not self._login():
 132             return
 133         self._confirm_age()
 134
 135
 136 class YoutubeIE(YoutubeBaseInfoExtractor, SubtitlesInfoExtractor):
 137     IE_DESC = u'YouTube.com'
 138     _VALID_URL = r"""^
 139                      (
 140                          (?:https?://)?                                       # http(s):// (optional)
 141                          (?:(?:(?:(?:\w+\.)?youtube(?:-nocookie)?\.com/|
 142                             tube\.majestyc\.net/|
 143                             youtube\.googleapis\.com/)                        # the various hostnames, with wildcard subdomains
 144                          (?:.*?\#/)?                                          # handle anchor (#/) redirect urls
 145                          (?:                                                  # the various things that can precede the ID:
 146                              (?:(?:v|embed|e)/)                               # v/ or embed/ or e/
 147                              |(?:                                             # or the v= param in all its forms
 148                                  (?:(?:watch|movie)(?:_popup)?(?:\.php)?)?    # preceding watch(_popup|.php) or nothing (like /?v=xxxx)
 149                                  (?:\?|\#!?)                                  # the params delimiter ? or # or #!
 150                                  (?:.*?&)?                                    # any other preceding param (like /?s=tuff&v=xxxx)
 151                                  v=
 152                              )
 153                          ))
 154                          |youtu\.be/                                          # just youtu.be/xxxx
 155                          )
 156                      )?                                                       # all until now is optional -> you can pass the naked ID
 157                      ([0-9A-Za-z_-]{11})                                      # here is it! the YouTube video ID
 158                      (?(1).+)?                                                # if we found the ID, everything can follow
 159                      $"""
 160     _NEXT_URL_RE = r'[\?&]next_url=([^&]+)'
 161     # Listed in order of quality
 162     _available_formats = ['38', '37', '46', '22', '45', '35', '44', '34', '18', '43', '6', '5', '36', '17', '13',
 163                           # Apple HTTP Live Streaming
 164                           '96', '95', '94', '93', '92', '132', '151',
 165                           # 3D
 166                           '85', '84', '102', '83', '101', '82', '100',
 167                           # Dash video
 168                           '138', '137', '248', '136', '247', '135', '246',
 169                           '245', '244', '134', '243', '133', '242', '160',
 170                           # Dash audio
 171                           '141', '172', '140', '171', '139',
 172                           ]
 173     _available_formats_prefer_free = ['38', '46', '37', '45', '22', '44', '35', '43', '34', '18', '6', '5', '36', '17', '13',
 174                                       # Apple HTTP Live Streaming
 175                                       '96', '95', '94', '93', '92', '132', '151',
 176                                       # 3D
 177                                       '85', '102', '84', '101', '83', '100', '82',
 178                                       # Dash video
 179                                       '138', '248', '137', '247', '136', '246', '245',
 180                                       '244', '135', '243', '134', '242', '133', '160',
 181                                       # Dash audio
 182                                       '172', '141', '171', '140', '139',
 183                                       ]
 184     _video_formats_map = {
 185         'flv': ['35', '34', '6', '5'],
 186         '3gp': ['36', '17', '13'],
 187         'mp4': ['38', '37', '22', '18'],
 188         'webm': ['46', '45', '44', '43'],
 189     }
 190     _video_extensions = {
 191         '13': '3gp',
 192         '17': '3gp',
 193         '18': 'mp4',
 194         '22': 'mp4',
 195         '36': '3gp',
 196         '37': 'mp4',
 197         '38': 'mp4',
 198         '43': 'webm',
 199         '44': 'webm',
 200         '45': 'webm',
 201         '46': 'webm',
 202
 203         # 3d videos
 204         '82': 'mp4',
 205         '83': 'mp4',
 206         '84': 'mp4',
 207         '85': 'mp4',
 208         '100': 'webm',
 209         '101': 'webm',
 210         '102': 'webm',
 211
 212         # Apple HTTP Live Streaming
 213         '92': 'mp4',
 214         '93': 'mp4',
 215         '94': 'mp4',
 216         '95': 'mp4',
 217         '96': 'mp4',
 218         '132': 'mp4',
 219         '151': 'mp4',
 220
 221         # Dash mp4
 222         '133': 'mp4',
 223         '134': 'mp4',
 224         '135': 'mp4',
 225         '136': 'mp4',
 226         '137': 'mp4',
 227         '138': 'mp4',
 228         '139': 'mp4',
 229         '140': 'mp4',
 230         '141': 'mp4',
 231         '160': 'mp4',
 232
 233         # Dash webm
 234         '171': 'webm',
 235         '172': 'webm',
 236         '242': 'webm',
 237         '243': 'webm',
 238         '244': 'webm',
 239         '245': 'webm',
 240         '246': 'webm',
 241         '247': 'webm',
 242         '248': 'webm',
 243     }
 244     _video_dimensions = {
 245         '5': '240x400',
 246         '6': '???',
 247         '13': '???',
 248         '17': '144x176',
 249         '18': '360x640',
 250         '22': '720x1280',
 251         '34': '360x640',
 252         '35': '480x854',
 253         '36': '240x320',
 254         '37': '1080x1920',
 255         '38': '3072x4096',
 256         '43': '360x640',
 257         '44': '480x854',
 258         '45': '720x1280',
 259         '46': '1080x1920',
 260         '82': '360p',
 261         '83': '480p',
 262         '84': '720p',
 263         '85': '1080p',
 264         '92': '240p',
 265         '93': '360p',
 266         '94': '480p',
 267         '95': '720p',
 268         '96': '1080p',
 269         '100': '360p',
 270         '101': '480p',
 271         '102': '720p',
 272         '132': '240p',
 273         '151': '72p',
 274         '133': '240p',
 275         '134': '360p',
 276         '135': '480p',
 277         '136': '720p',
 278         '137': '1080p',
 279         '138': '>1080p',
 280         '139': '48k',
 281         '140': '128k',
 282         '141': '256k',
 283         '160': '192p',
 284         '171': '128k',
 285         '172': '256k',
 286         '242': '240p',
 287         '243': '360p',
 288         '244': '480p',
 289         '245': '480p',
 290         '246': '480p',
 291         '247': '720p',
 292         '248': '1080p',
 293     }
 294     _special_itags = {
 295         '82': '3D',
 296         '83': '3D',
 297         '84': '3D',
 298         '85': '3D',
 299         '100': '3D',
 300         '101': '3D',
 301         '102': '3D',
 302         '133': 'DASH Video',
 303         '134': 'DASH Video',
 304         '135': 'DASH Video',
 305         '136': 'DASH Video',
 306         '137': 'DASH Video',
 307         '138': 'DASH Video',
 308         '139': 'DASH Audio',
 309         '140': 'DASH Audio',
 310         '141': 'DASH Audio',
 311         '160': 'DASH Video',
 312         '171': 'DASH Audio',
 313         '172': 'DASH Audio',
 314         '242': 'DASH Video',
 315         '243': 'DASH Video',
 316         '244': 'DASH Video',
 317         '245': 'DASH Video',
 318         '246': 'DASH Video',
 319         '247': 'DASH Video',
 320         '248': 'DASH Video',
 321     }
 322
 323     IE_NAME = u'youtube'
 324     _TESTS = [
 325         {
 326             u"url":  u"http://www.youtube.com/watch?v=BaW_jenozKc",
 327             u"file":  u"BaW_jenozKc.mp4",
 328             u"info_dict": {
 329                 u"title": u"youtube-dl test video \"'/\\ä↭𝕐",
 330                 u"uploader": u"Philipp Hagemeister",
 331                 u"uploader_id": u"phihag",
 332                 u"upload_date": u"20121002",
 333                 u"description": u"test chars:  \"'/\\ä↭𝕐\n\nThis is a test video for youtube-dl.\n\nFor more information, contact phihag@phihag.de ."
 334             }
 335         },
 336         {
 337             u"url":  u"http://www.youtube.com/watch?v=1ltcDfZMA3U",
 338             u"file":  u"1ltcDfZMA3U.flv",
 339             u"note": u"Test VEVO video (#897)",
 340             u"info_dict": {
 341                 u"upload_date": u"20070518",
 342                 u"title": u"Maps - It Will Find You",
 343                 u"description": u"Music video by Maps performing It Will Find You.",
 344                 u"uploader": u"MuteUSA",
 345                 u"uploader_id": u"MuteUSA"
 346             }
 347         },
 348         {
 349             u"url":  u"http://www.youtube.com/watch?v=UxxajLWwzqY",
 350             u"file":  u"UxxajLWwzqY.mp4",
 351             u"note": u"Test generic use_cipher_signature video (#897)",
 352             u"info_dict": {
 353                 u"upload_date": u"20120506",
 354                 u"title": u"Icona Pop - I Love It (feat. Charli XCX) [OFFICIAL VIDEO]",
 355                 u"description": u"md5:3e2666e0a55044490499ea45fe9037b7",
 356                 u"uploader": u"Icona Pop",
 357                 u"uploader_id": u"IconaPop"
 358             }
 359         },
 360         {
 361             u"url":  u"https://www.youtube.com/watch?v=07FYdnEawAQ",
 362             u"file":  u"07FYdnEawAQ.mp4",
 363             u"note": u"Test VEVO video with age protection (#956)",
 364             u"info_dict": {
 365                 u"upload_date": u"20130703",
 366                 u"title": u"Justin Timberlake - Tunnel Vision (Explicit)",
 367                 u"description": u"md5:64249768eec3bc4276236606ea996373",
 368                 u"uploader": u"justintimberlakeVEVO",
 369                 u"uploader_id": u"justintimberlakeVEVO"
 370             }
 371         },
 372         {
 373             u'url': u'https://www.youtube.com/watch?v=TGi3HqYrWHE',
 374             u'file': u'TGi3HqYrWHE.mp4',
 375             u'note': u'm3u8 video',
 376             u'info_dict': {
 377                 u'title': u'Triathlon - Men - London 2012 Olympic Games',
 378                 u'description': u'- Men -  TR02 - Triathlon - 07 August 2012 - London 2012 Olympic Games',
 379                 u'uploader': u'olympic',
 380                 u'upload_date': u'20120807',
 381                 u'uploader_id': u'olympic',
 382             },
 383             u'params': {
 384                 u'skip_download': True,
 385             },
 386         },
 387     ]
 388
 389
 390     @classmethod
 391     def suitable(cls, url):
 392         """Receives a URL and returns True if suitable for this IE."""
 393         if YoutubePlaylistIE.suitable(url): return False
 394         return re.match(cls._VALID_URL, url, re.VERBOSE) is not None
 395
 396     def report_video_webpage_download(self, video_id):
 397         """Report attempt to download video webpage."""
 398         self.to_screen(u'%s: Downloading video webpage' % video_id)
 399
 400     def report_video_info_webpage_download(self, video_id):
 401         """Report attempt to download video info webpage."""
 402         self.to_screen(u'%s: Downloading video info webpage' % video_id)
 403
 404     def report_information_extraction(self, video_id):
 405         """Report attempt to extract video information."""
 406         self.to_screen(u'%s: Extracting video information' % video_id)
 407
 408     def report_unavailable_format(self, video_id, format):
 409         """Report extracted video URL."""
 410         self.to_screen(u'%s: Format %s not available' % (video_id, format))
 411
 412     def report_rtmp_download(self):
 413         """Indicate the download will use the RTMP protocol."""
 414         self.to_screen(u'RTMP download detected')
 415
 416     def _decrypt_signature(self, s):
 417         """Turn the encrypted s field into a working signature"""
 418
 419         if len(s) == 93:
 420             return s[86:29:-1] + s[88] + s[28:5:-1]
 421         elif len(s) == 92:
 422             return s[25] + s[3:25] + s[0] + s[26:42] + s[79] + s[43:79] + s[91] + s[80:83]
 423         elif len(s) == 90:
 424             return s[25] + s[3:25] + s[2] + s[26:40] + s[77] + s[41:77] + s[89] + s[78:81]
 425         elif len(s) == 89:
 426             return s[84:78:-1] + s[87] + s[77:60:-1] + s[0] + s[59:3:-1]
 427         elif len(s) == 88:
 428             return s[7:28] + s[87] + s[29:45] + s[55] + s[46:55] + s[2] + s[56:87] + s[28]
 429         elif len(s) == 87:
 430             return s[6:27] + s[4] + s[28:39] + s[27] + s[40:59] + s[2] + s[60:]
 431         elif len(s) == 86:
 432             return s[5:34] + s[0] + s[35:38] + s[3] + s[39:45] + s[38] + s[46:53] + s[73] + s[54:73] + s[85] + s[74:85] + s[53]
 433         elif len(s) == 85:
 434             return s[3:11] + s[0] + s[12:55] + s[84] + s[56:84]
 435         elif len(s) == 84:
 436             return s[81:36:-1] + s[0] + s[35:2:-1]
 437         elif len(s) == 83:
 438             return s[81:64:-1] + s[82] + s[63:52:-1] + s[45] + s[51:45:-1] + s[1] + s[44:1:-1] + s[0]
 439         elif len(s) == 82:
 440             return s[80:73:-1] + s[81] + s[72:54:-1] + s[2] + s[53:43:-1] + s[0] + s[42:2:-1] + s[43] + s[1] + s[54]
 441         elif len(s) == 81:
 442             return s[56] + s[79:56:-1] + s[41] + s[55:41:-1] + s[80] + s[40:34:-1] + s[0] + s[33:29:-1] + s[34] + s[28:9:-1] + s[29] + s[8:0:-1] + s[9]
 443         elif len(s) == 80:
 444             return s[1:19] + s[0] + s[20:68] + s[19] + s[69:80]
 445         elif len(s) == 79:
 446             return s[54] + s[77:54:-1] + s[39] + s[53:39:-1] + s[78] + s[38:34:-1] + s[0] + s[33:29:-1] + s[34] + s[28:9:-1] + s[29] + s[8:0:-1] + s[9]
 447
 448         else:
 449             raise ExtractorError(u'Unable to decrypt signature, key length %d not supported; retrying might work' % (len(s)))
 450
 451     def _decrypt_signature_age_gate(self, s):
 452         # The videos with age protection use another player, so the algorithms
 453         # can be different.
 454         if len(s) == 86:
 455             return s[2:63] + s[82] + s[64:82] + s[63]
 456         else:
 457             # Fallback to the other algortihms
 458             return self._decrypt_signature(s)
 459
 460     def _get_available_subtitles(self, video_id):
 461         try:
 462             sub_list = self._download_webpage(
 463                 'http://video.google.com/timedtext?hl=en&type=list&v=%s' % video_id,
 464                 video_id, note=False)
 465         except ExtractorError as err:
 466             self._downloader.report_warning(u'unable to download video subtitles: %s' % compat_str(err))
 467             return {}
 468         lang_list = re.findall(r'name="([^"]*)"[^>]+lang_code="([\w\-]+)"', sub_list)
 469
 470         sub_lang_list = {}
 471         for l in lang_list:
 472             lang = l[1]
 473             params = compat_urllib_parse.urlencode({
 474                 'lang': lang,
 475                 'v': video_id,
 476                 'fmt': self._downloader.params.get('subtitlesformat'),
 477             })
 478             url = u'http://www.youtube.com/api/timedtext?' + params
 479             sub_lang_list[lang] = url
 480         if not sub_lang_list:
 481             self._downloader.report_warning(u'video doesn\'t have subtitles')
 482             return {}
 483         return sub_lang_list
 484
 485     def _get_available_automatic_caption(self, video_id, webpage):
 486         """We need the webpage for getting the captions url, pass it as an
 487            argument to speed up the process."""
 488         sub_format = self._downloader.params.get('subtitlesformat')
 489         self.to_screen(u'%s: Looking for automatic captions' % video_id)
 490         mobj = re.search(r';ytplayer.config = ({.*?});', webpage)
 491         err_msg = u'Couldn\'t find automatic captions for %s' % video_id
 492         if mobj is None:
 493             self._downloader.report_warning(err_msg)
 494             return {}
 495         player_config = json.loads(mobj.group(1))
 496         try:
 497             args = player_config[u'args']
 498             caption_url = args[u'ttsurl']
 499             timestamp = args[u'timestamp']
 500             # We get the available subtitles
 501             list_params = compat_urllib_parse.urlencode({
 502                 'type': 'list',
 503                 'tlangs': 1,
 504                 'asrs': 1,
 505             })
 506             list_url = caption_url + '&' + list_params
 507             list_page = self._download_webpage(list_url, video_id)
 508             caption_list = xml.etree.ElementTree.fromstring(list_page.encode('utf-8'))
 509             original_lang_node = caption_list.find('track')
 510             if original_lang_node.attrib.get('kind') != 'asr' :
 511                 self._downloader.report_warning(u'Video doesn\'t have automatic captions')
 512                 return {}
 513             original_lang = original_lang_node.attrib['lang_code']
 514
 515             sub_lang_list = {}
 516             for lang_node in caption_list.findall('target'):
 517                 sub_lang = lang_node.attrib['lang_code']
 518                 params = compat_urllib_parse.urlencode({
 519                     'lang': original_lang,
 520                     'tlang': sub_lang,
 521                     'fmt': sub_format,
 522                     'ts': timestamp,
 523                     'kind': 'asr',
 524                 })
 525                 sub_lang_list[sub_lang] = caption_url + '&' + params
 526             return sub_lang_list
 527         # An extractor error can be raise by the download process if there are
 528         # no automatic captions but there are subtitles
 529         except (KeyError, ExtractorError):
 530             self._downloader.report_warning(err_msg)
 531             return {}
 532
 533     def _print_formats(self, formats):
 534         print('Available formats:')
 535         for x in formats:
 536             print('%s\t:\t%s\t[%s]%s' %(x, self._video_extensions.get(x, 'flv'),
 537                                         self._video_dimensions.get(x, '???'),
 538                                         ' ('+self._special_itags[x]+')' if x in self._special_itags else ''))
 539
 540     def _extract_id(self, url):
 541         mobj = re.match(self._VALID_URL, url, re.VERBOSE)
 542         if mobj is None:
 543             raise ExtractorError(u'Invalid URL: %s' % url)
 544         video_id = mobj.group(2)
 545         return video_id
 546
 547     def _get_video_url_list(self, url_map):
 548         """
 549         Transform a dictionary in the format {itag:url} to a list of (itag, url)
 550         with the requested formats.
 551         """
 552         req_format = self._downloader.params.get('format', None)
 553         format_limit = self._downloader.params.get('format_limit', None)
 554         available_formats = self._available_formats_prefer_free if self._downloader.params.get('prefer_free_formats', False) else self._available_formats
 555         if format_limit is not None and format_limit in available_formats:
 556             format_list = available_formats[available_formats.index(format_limit):]
 557         else:
 558             format_list = available_formats
 559         existing_formats = [x for x in format_list if x in url_map]
 560         if len(existing_formats) == 0:
 561             raise ExtractorError(u'no known formats available for video')
 562         if self._downloader.params.get('listformats', None):
 563             self._print_formats(existing_formats)
 564             return
 565         if req_format is None or req_format == 'best':
 566             video_url_list = [(existing_formats[0], url_map[existing_formats[0]])] # Best quality
 567         elif req_format == 'worst':
 568             video_url_list = [(existing_formats[-1], url_map[existing_formats[-1]])] # worst quality
 569         elif req_format in ('-1', 'all'):
 570             video_url_list = [(f, url_map[f]) for f in existing_formats] # All formats
 571         else:
 572             # Specific formats. We pick the first in a slash-delimeted sequence.
 573             # Format can be specified as itag or 'mp4' or 'flv' etc. We pick the highest quality
 574             # available in the specified format. For example,
 575             # if '1/2/3/4' is requested and '2' and '4' are available, we pick '2'.
 576             # if '1/mp4/3/4' is requested and '1' and '5' (is a mp4) are available, we pick '1'.
 577             # if '1/mp4/3/4' is requested and '4' and '5' (is a mp4) are available, we pick '5'.
 578             req_formats = req_format.split('/')
 579             video_url_list = None
 580             for rf in req_formats:
 581                 if rf in url_map:
 582                     video_url_list = [(rf, url_map[rf])]
 583                     break
 584                 if rf in self._video_formats_map:
 585                     for srf in self._video_formats_map[rf]:
 586                         if srf in url_map:
 587                             video_url_list = [(srf, url_map[srf])]
 588                             break
 589                     else:
 590                         continue
 591                     break
 592             if video_url_list is None:
 593                 raise ExtractorError(u'requested format not available')
 594         return video_url_list
 595
 596     def _extract_from_m3u8(self, manifest_url, video_id):
 597         url_map = {}
 598         def _get_urls(_manifest):
 599             lines = _manifest.split('\n')
 600             urls = filter(lambda l: l and not l.startswith('#'),
 601                             lines)
 602             return urls
 603         manifest = self._download_webpage(manifest_url, video_id, u'Downloading formats manifest')
 604         formats_urls = _get_urls(manifest)
 605         for format_url in formats_urls:
 606             itag = self._search_regex(r'itag/(\d+?)/', format_url, 'itag')
 607             url_map[itag] = format_url
 608         return url_map
 609
 610     def _real_extract(self, url):
 611         if re.match(r'(?:https?://)?[^/]+/watch\?feature=[a-z_]+$', url):
 612             self._downloader.report_warning(u'Did you forget to quote the URL? Remember that & is a meta-character in most shells, so you want to put the URL in quotes, like  youtube-dl \'http://www.youtube.com/watch?feature=foo&v=BaW_jenozKc\' (or simply  youtube-dl BaW_jenozKc  ).')
 613
 614         # Extract original video URL from URL with redirection, like age verification, using next_url parameter
 615         mobj = re.search(self._NEXT_URL_RE, url)
 616         if mobj:
 617             url = 'https://www.youtube.com/' + compat_urllib_parse.unquote(mobj.group(1)).lstrip('/')
 618         video_id = self._extract_id(url)
 619
 620         # Get video webpage
 621         self.report_video_webpage_download(video_id)
 622         url = 'https://www.youtube.com/watch?v=%s&gl=US&hl=en&has_verified=1' % video_id
 623         request = compat_urllib_request.Request(url)
 624         try:
 625             video_webpage_bytes = compat_urllib_request.urlopen(request).read()
 626         except (compat_urllib_error.URLError, compat_http_client.HTTPException, socket.error) as err:
 627             raise ExtractorError(u'Unable to download video webpage: %s' % compat_str(err))
 628
 629         video_webpage = video_webpage_bytes.decode('utf-8', 'ignore')
 630
 631         # Attempt to extract SWF player URL
 632         mobj = re.search(r'swfConfig.*?"(http:\\/\\/.*?watch.*?-.*?\.swf)"', video_webpage)
 633         if mobj is not None:
 634             player_url = re.sub(r'\\(.)', r'\1', mobj.group(1))
 635         else:
 636             player_url = None
 637
 638         # Get video info
 639         self.report_video_info_webpage_download(video_id)
 640         if re.search(r'player-age-gate-content">', video_webpage) is not None:
 641             self.report_age_confirmation()
 642             age_gate = True
 643             # We simulate the access to the video from www.youtube.com/v/{video_id}
 644             # this can be viewed without login into Youtube
 645             data = compat_urllib_parse.urlencode({'video_id': video_id,
 646                                                   'el': 'embedded',
 647                                                   'gl': 'US',
 648                                                   'hl': 'en',
 649                                                   'eurl': 'https://youtube.googleapis.com/v/' + video_id,
 650                                                   'asv': 3,
 651                                                   'sts':'1588',
 652                                                   })
 653             video_info_url = 'https://www.youtube.com/get_video_info?' + data
 654             video_info_webpage = self._download_webpage(video_info_url, video_id,
 655                                     note=False,
 656                                     errnote='unable to download video info webpage')
 657             video_info = compat_parse_qs(video_info_webpage)
 658         else:
 659             age_gate = False
 660             for el_type in ['&el=embedded', '&el=detailpage', '&el=vevo', '']:
 661                 video_info_url = ('https://www.youtube.com/get_video_info?&video_id=%s%s&ps=default&eurl=&gl=US&hl=en'
 662                         % (video_id, el_type))
 663                 video_info_webpage = self._download_webpage(video_info_url, video_id,
 664                                         note=False,
 665                                         errnote='unable to download video info webpage')
 666                 video_info = compat_parse_qs(video_info_webpage)
 667                 if 'token' in video_info:
 668                     break
 669         if 'token' not in video_info:
 670             if 'reason' in video_info:
 671                 raise ExtractorError(u'YouTube said: %s' % video_info['reason'][0], expected=True)
 672             else:
 673                 raise ExtractorError(u'"token" parameter not in video info for unknown reason')
 674
 675         # Check for "rental" videos
 676         if 'ypc_video_rental_bar_text' in video_info and 'author' not in video_info:
 677             raise ExtractorError(u'"rental" videos not supported')
 678
 679         # Start extracting information
 680         self.report_information_extraction(video_id)
 681
 682         # uploader
 683         if 'author' not in video_info:
 684             raise ExtractorError(u'Unable to extract uploader name')
 685         video_uploader = compat_urllib_parse.unquote_plus(video_info['author'][0])
 686
 687         # uploader_id
 688         video_uploader_id = None
 689         mobj = re.search(r'<link itemprop="url" href="http://www.youtube.com/(?:user|channel)/([^"]+)">', video_webpage)
 690         if mobj is not None:
 691             video_uploader_id = mobj.group(1)
 692         else:
 693             self._downloader.report_warning(u'unable to extract uploader nickname')
 694
 695         # title
 696         if 'title' not in video_info:
 697             raise ExtractorError(u'Unable to extract video title')
 698         video_title = compat_urllib_parse.unquote_plus(video_info['title'][0])
 699
 700         # thumbnail image
 701         # We try first to get a high quality image:
 702         m_thumb = re.search(r'<span itemprop="thumbnail".*?href="(.*?)">',
 703                             video_webpage, re.DOTALL)
 704         if m_thumb is not None:
 705             video_thumbnail = m_thumb.group(1)
 706         elif 'thumbnail_url' not in video_info:
 707             self._downloader.report_warning(u'unable to extract video thumbnail')
 708             video_thumbnail = ''
 709         else:   # don't panic if we can't find it
 710             video_thumbnail = compat_urllib_parse.unquote_plus(video_info['thumbnail_url'][0])
 711
 712         # upload date
 713         upload_date = None
 714         mobj = re.search(r'id="eow-date.*?>(.*?)</span>', video_webpage, re.DOTALL)
 715         if mobj is not None:
 716             upload_date = ' '.join(re.sub(r'[/,-]', r' ', mobj.group(1)).split())
 717             upload_date = unified_strdate(upload_date)
 718
 719         # description
 720         video_description = get_element_by_id("eow-description", video_webpage)
 721         if video_description:
 722             video_description = clean_html(video_description)
 723         else:
 724             fd_mobj = re.search(r'<meta name="description" content="([^"]+)"', video_webpage)
 725             if fd_mobj:
 726                 video_description = unescapeHTML(fd_mobj.group(1))
 727             else:
 728                 video_description = u''
 729
 730         # subtitles
 731         video_subtitles = self.extract_subtitles(video_id, video_webpage)
 732
 733         if self._downloader.params.get('listsubtitles', False):
 734             self._list_available_subtitles(video_id, video_webpage)
 735             return
 736
 737         if 'length_seconds' not in video_info:
 738             self._downloader.report_warning(u'unable to extract video duration')
 739             video_duration = ''
 740         else:
 741             video_duration = compat_urllib_parse.unquote_plus(video_info['length_seconds'][0])
 742
 743         # Decide which formats to download
 744
 745         try:
 746             mobj = re.search(r';ytplayer.config = ({.*?});', video_webpage)
 747             if not mobj:
 748                 raise ValueError('Could not find vevo ID')
 749             info = json.loads(mobj.group(1))
 750             args = info['args']
 751             # Easy way to know if the 's' value is in url_encoded_fmt_stream_map
 752             # this signatures are encrypted
 753             m_s = re.search(r'[&,]s=', args['url_encoded_fmt_stream_map'])
 754             if m_s is not None:
 755                 self.to_screen(u'%s: Encrypted signatures detected.' % video_id)
 756                 video_info['url_encoded_fmt_stream_map'] = [args['url_encoded_fmt_stream_map']]
 757             m_s = re.search(r'[&,]s=', args.get('adaptive_fmts', u''))
 758             if m_s is not None:
 759                 if 'url_encoded_fmt_stream_map' in video_info:
 760                     video_info['url_encoded_fmt_stream_map'][0] += ',' + args['adaptive_fmts']
 761                 else:
 762                     video_info['url_encoded_fmt_stream_map'] = [args['adaptive_fmts']]
 763             elif 'adaptive_fmts' in video_info:
 764                 if 'url_encoded_fmt_stream_map' in video_info:
 765                     video_info['url_encoded_fmt_stream_map'][0] += ',' + video_info['adaptive_fmts'][0]
 766                 else:
 767                     video_info['url_encoded_fmt_stream_map'] = video_info['adaptive_fmts']
 768         except ValueError:
 769             pass
 770
 771         if 'conn' in video_info and video_info['conn'][0].startswith('rtmp'):
 772             self.report_rtmp_download()
 773             video_url_list = [(None, video_info['conn'][0])]
 774         elif 'url_encoded_fmt_stream_map' in video_info and len(video_info['url_encoded_fmt_stream_map']) >= 1:
 775             if 'rtmpe%3Dyes' in video_info['url_encoded_fmt_stream_map'][0]:
 776                 raise ExtractorError('rtmpe downloads are not supported, see https://github.com/rg3/youtube-dl/issues/343 for more information.', expected=True)
 777             url_map = {}
 778             for url_data_str in video_info['url_encoded_fmt_stream_map'][0].split(','):
 779                 url_data = compat_parse_qs(url_data_str)
 780                 if 'itag' in url_data and 'url' in url_data:
 781                     url = url_data['url'][0]
 782                     if 'sig' in url_data:
 783                         url += '&signature=' + url_data['sig'][0]
 784                     elif 's' in url_data:
 785                         if self._downloader.params.get('verbose'):
 786                             s = url_data['s'][0]
 787                             if age_gate:
 788                                 player = 'flash player'
 789                             else:
 790                                 player = u'html5 player %s' % self._search_regex(r'html5player-(.+?)\.js', video_webpage,
 791                                     'html5 player', fatal=False)
 792                             parts_sizes = u'.'.join(compat_str(len(part)) for part in s.split('.'))
 793                             self.to_screen(u'encrypted signature length %d (%s), itag %s, %s' %
 794                                 (len(s), parts_sizes, url_data['itag'][0], player))
 795                         encrypted_sig = url_data['s'][0]
 796                         if age_gate:
 797                             signature = self._decrypt_signature_age_gate(encrypted_sig)
 798                         else:
 799                             signature = self._decrypt_signature(encrypted_sig)
 800                         url += '&signature=' + signature
 801                     if 'ratebypass' not in url:
 802                         url += '&ratebypass=yes'
 803                     url_map[url_data['itag'][0]] = url
 804             video_url_list = self._get_video_url_list(url_map)
 805             if not video_url_list:
 806                 return
 807         elif video_info.get('hlsvp'):
 808             manifest_url = video_info['hlsvp'][0]
 809             url_map = self._extract_from_m3u8(manifest_url, video_id)
 810             video_url_list = self._get_video_url_list(url_map)
 811             if not video_url_list:
 812                 return
 813
 814         else:
 815             raise ExtractorError(u'no conn or url_encoded_fmt_stream_map information found in video info')
 816
 817         results = []
 818         for format_param, video_real_url in video_url_list:
 819             # Extension
 820             video_extension = self._video_extensions.get(format_param, 'flv')
 821
 822             video_format = '{0} - {1}{2}'.format(format_param if format_param else video_extension,
 823                                               self._video_dimensions.get(format_param, '???'),
 824                                               ' ('+self._special_itags[format_param]+')' if format_param in self._special_itags else '')
 825
 826             results.append({
 827                 'id':       video_id,
 828                 'url':      video_real_url,
 829                 'uploader': video_uploader,
 830                 'uploader_id': video_uploader_id,
 831                 'upload_date':  upload_date,
 832                 'title':    video_title,
 833                 'ext':      video_extension,
 834                 'format':   video_format,
 835                 'thumbnail':    video_thumbnail,
 836                 'description':  video_description,
 837                 'player_url':   player_url,
 838                 'subtitles':    video_subtitles,
 839                 'duration':     video_duration
 840             })
 841         return results
 842
 843 class YoutubePlaylistIE(InfoExtractor):
 844     IE_DESC = u'YouTube.com playlists'
 845     _VALID_URL = r"""(?:
 846                         (?:https?://)?
 847                         (?:\w+\.)?
 848                         youtube\.com/
 849                         (?:
 850                            (?:course|view_play_list|my_playlists|artist|playlist|watch)
 851                            \? (?:.*?&)*? (?:p|a|list)=
 852                         |  p/
 853                         )
 854                         ((?:PL|EC|UU|FL)?[0-9A-Za-z-_]{10,})
 855                         .*
 856                      |
 857                         ((?:PL|EC|UU|FL)[0-9A-Za-z-_]{10,})
 858                      )"""
 859     _TEMPLATE_URL = 'https://gdata.youtube.com/feeds/api/playlists/%s?max-results=%i&start-index=%i&v=2&alt=json&safeSearch=none'
 860     _MAX_RESULTS = 50
 861     IE_NAME = u'youtube:playlist'
 862
 863     @classmethod
 864     def suitable(cls, url):
 865         """Receives a URL and returns True if suitable for this IE."""
 866         return re.match(cls._VALID_URL, url, re.VERBOSE) is not None
 867
 868     def _real_extract(self, url):
 869         # Extract playlist id
 870         mobj = re.match(self._VALID_URL, url, re.VERBOSE)
 871         if mobj is None:
 872             raise ExtractorError(u'Invalid URL: %s' % url)
 873
 874         # Download playlist videos from API
 875         playlist_id = mobj.group(1) or mobj.group(2)
 876         videos = []
 877
 878         for page_num in itertools.count(1):
 879             start_index = self._MAX_RESULTS * (page_num - 1) + 1
 880             if start_index >= 1000:
 881                 self._downloader.report_warning(u'Max number of results reached')
 882                 break
 883             url = self._TEMPLATE_URL % (playlist_id, self._MAX_RESULTS, start_index)
 884             page = self._download_webpage(url, playlist_id, u'Downloading page #%s' % page_num)
 885
 886             try:
 887                 response = json.loads(page)
 888             except ValueError as err:
 889                 raise ExtractorError(u'Invalid JSON in API response: ' + compat_str(err))
 890
 891             if 'feed' not in response:
 892                 raise ExtractorError(u'Got a malformed response from YouTube API')
 893             playlist_title = response['feed']['title']['$t']
 894             if 'entry' not in response['feed']:
 895                 # Number of videos is a multiple of self._MAX_RESULTS
 896                 break
 897
 898             for entry in response['feed']['entry']:
 899                 index = entry['yt$position']['$t']
 900                 if 'media$group' in entry and 'yt$videoid' in entry['media$group']:
 901                     videos.append((
 902                         index,
 903                         'https://www.youtube.com/watch?v=' + entry['media$group']['yt$videoid']['$t']
 904                     ))
 905
 906         videos = [v[1] for v in sorted(videos)]
 907
 908         url_results = [self.url_result(vurl, 'Youtube') for vurl in videos]
 909         return [self.playlist_result(url_results, playlist_id, playlist_title)]
 910
 911
 912 class YoutubeChannelIE(InfoExtractor):
 913     IE_DESC = u'YouTube.com channels'
 914     _VALID_URL = r"^(?:https?://)?(?:youtu\.be|(?:\w+\.)?youtube(?:-nocookie)?\.com)/channel/([0-9A-Za-z_-]+)"
 915     _TEMPLATE_URL = 'http://www.youtube.com/channel/%s/videos?sort=da&flow=list&view=0&page=%s&gl=US&hl=en'
 916     _MORE_PAGES_INDICATOR = 'yt-uix-load-more'
 917     _MORE_PAGES_URL = 'http://www.youtube.com/c4_browse_ajax?action_load_more_videos=1&flow=list&paging=%s&view=0&sort=da&channel_id=%s'
 918     IE_NAME = u'youtube:channel'
 919
 920     def extract_videos_from_page(self, page):
 921         ids_in_page = []
 922         for mobj in re.finditer(r'href="/watch\?v=([0-9A-Za-z_-]+)&?', page):
 923             if mobj.group(1) not in ids_in_page:
 924                 ids_in_page.append(mobj.group(1))
 925         return ids_in_page
 926
 927     def _real_extract(self, url):
 928         # Extract channel id
 929         mobj = re.match(self._VALID_URL, url)
 930         if mobj is None:
 931             raise ExtractorError(u'Invalid URL: %s' % url)
 932
 933         # Download channel page
 934         channel_id = mobj.group(1)
 935         video_ids = []
 936         pagenum = 1
 937
 938         url = self._TEMPLATE_URL % (channel_id, pagenum)
 939         page = self._download_webpage(url, channel_id,
 940                                       u'Downloading page #%s' % pagenum)
 941
 942         # Extract video identifiers
 943         ids_in_page = self.extract_videos_from_page(page)
 944         video_ids.extend(ids_in_page)
 945
 946         # Download any subsequent channel pages using the json-based channel_ajax query
 947         if self._MORE_PAGES_INDICATOR in page:
 948             for pagenum in itertools.count(1):
 949                 url = self._MORE_PAGES_URL % (pagenum, channel_id)
 950                 page = self._download_webpage(url, channel_id,
 951                                               u'Downloading page #%s' % pagenum)
 952
 953                 page = json.loads(page)
 954
 955                 ids_in_page = self.extract_videos_from_page(page['content_html'])
 956                 video_ids.extend(ids_in_page)
 957
 958                 if self._MORE_PAGES_INDICATOR  not in page['load_more_widget_html']:
 959                     break
 960
 961         self._downloader.to_screen(u'[youtube] Channel %s: Found %i videos' % (channel_id, len(video_ids)))
 962
 963         urls = ['http://www.youtube.com/watch?v=%s' % id for id in video_ids]
 964         url_entries = [self.url_result(eurl, 'Youtube') for eurl in urls]
 965         return [self.playlist_result(url_entries, channel_id)]
 966
 967
 968 class YoutubeUserIE(InfoExtractor):
 969     IE_DESC = u'YouTube.com user videos (URL or "ytuser" keyword)'
 970     _VALID_URL = r'(?:(?:(?:https?://)?(?:\w+\.)?youtube\.com/(?:user/)?)|ytuser:)(?!feed/)([A-Za-z0-9_-]+)'
 971     _TEMPLATE_URL = 'http://gdata.youtube.com/feeds/api/users/%s'
 972     _GDATA_PAGE_SIZE = 50
 973     _GDATA_URL = 'http://gdata.youtube.com/feeds/api/users/%s/uploads?max-results=%d&start-index=%d&alt=json'
 974     IE_NAME = u'youtube:user'
 975
 976     @classmethod
 977     def suitable(cls, url):
 978         # Don't return True if the url can be extracted with other youtube
 979         # extractor, the regex would is too permissive and it would match.
 980         other_ies = iter(klass for (name, klass) in globals().items() if name.endswith('IE') and klass is not cls)
 981         if any(ie.suitable(url) for ie in other_ies): return False
 982         else: return super(YoutubeUserIE, cls).suitable(url)
 983
 984     def _real_extract(self, url):
 985         # Extract username
 986         mobj = re.match(self._VALID_URL, url)
 987         if mobj is None:
 988             raise ExtractorError(u'Invalid URL: %s' % url)
 989
 990         username = mobj.group(1)
 991
 992         # Download video ids using YouTube Data API. Result size per
 993         # query is limited (currently to 50 videos) so we need to query
 994         # page by page until there are no video ids - it means we got
 995         # all of them.
 996
 997         video_ids = []
 998
 999         for pagenum in itertools.count(0):
1000             start_index = pagenum * self._GDATA_PAGE_SIZE + 1
1001
1002             gdata_url = self._GDATA_URL % (username, self._GDATA_PAGE_SIZE, start_index)
1003             page = self._download_webpage(gdata_url, username,
1004                                           u'Downloading video ids from %d to %d' % (start_index, start_index + self._GDATA_PAGE_SIZE))
1005
1006             try:
1007                 response = json.loads(page)
1008             except ValueError as err:
1009                 raise ExtractorError(u'Invalid JSON in API response: ' + compat_str(err))
1010             if 'entry' not in response['feed']:
1011                 # Number of videos is a multiple of self._MAX_RESULTS
1012                 break
1013
1014             # Extract video identifiers
1015             ids_in_page = []
1016             for entry in response['feed']['entry']:
1017                 ids_in_page.append(entry['id']['$t'].split('/')[-1])
1018             video_ids.extend(ids_in_page)
1019
1020             # A little optimization - if current page is not
1021             # "full", ie. does not contain PAGE_SIZE video ids then
1022             # we can assume that this page is the last one - there
1023             # are no more ids on further pages - no need to query
1024             # again.
1025
1026             if len(ids_in_page) < self._GDATA_PAGE_SIZE:
1027                 break
1028
1029         urls = ['http://www.youtube.com/watch?v=%s' % video_id for video_id in video_ids]
1030         url_results = [self.url_result(rurl, 'Youtube') for rurl in urls]
1031         return [self.playlist_result(url_results, playlist_title = username)]
1032
1033 class YoutubeSearchIE(SearchInfoExtractor):
1034     IE_DESC = u'YouTube.com searches'
1035     _API_URL = 'https://gdata.youtube.com/feeds/api/videos?q=%s&start-index=%i&max-results=50&v=2&alt=jsonc'
1036     _MAX_RESULTS = 1000
1037     IE_NAME = u'youtube:search'
1038     _SEARCH_KEY = 'ytsearch'
1039
1040     def report_download_page(self, query, pagenum):
1041         """Report attempt to download search page with given number."""
1042         self._downloader.to_screen(u'[youtube] query "%s": Downloading page %s' % (query, pagenum))
1043
1044     def _get_n_results(self, query, n):
1045         """Get a specified number of results for a query"""
1046
1047         video_ids = []
1048         pagenum = 0
1049         limit = n
1050
1051         while (50 * pagenum) < limit:
1052             self.report_download_page(query, pagenum+1)
1053             result_url = self._API_URL % (compat_urllib_parse.quote_plus(query), (50*pagenum)+1)
1054             request = compat_urllib_request.Request(result_url)
1055             try:
1056                 data = compat_urllib_request.urlopen(request).read().decode('utf-8')
1057             except (compat_urllib_error.URLError, compat_http_client.HTTPException, socket.error) as err:
1058                 raise ExtractorError(u'Unable to download API page: %s' % compat_str(err))
1059             api_response = json.loads(data)['data']
1060
1061             if not 'items' in api_response:
1062                 raise ExtractorError(u'[youtube] No video results')
1063
1064             new_ids = list(video['id'] for video in api_response['items'])
1065             video_ids += new_ids
1066
1067             limit = min(n, api_response['totalItems'])
1068             pagenum += 1
1069
1070         if len(video_ids) > n:
1071             video_ids = video_ids[:n]
1072         videos = [self.url_result('http://www.youtube.com/watch?v=%s' % id, 'Youtube') for id in video_ids]
1073         return self.playlist_result(videos, query)
1074
1075
1076 class YoutubeShowIE(InfoExtractor):
1077     IE_DESC = u'YouTube.com (multi-season) shows'
1078     _VALID_URL = r'https?://www\.youtube\.com/show/(.*)'
1079     IE_NAME = u'youtube:show'
1080
1081     def _real_extract(self, url):
1082         mobj = re.match(self._VALID_URL, url)
1083         show_name = mobj.group(1)
1084         webpage = self._download_webpage(url, show_name, u'Downloading show webpage')
1085         # There's one playlist for each season of the show
1086         m_seasons = list(re.finditer(r'href="(/playlist\?list=.*?)"', webpage))
1087         self.to_screen(u'%s: Found %s seasons' % (show_name, len(m_seasons)))
1088         return [self.url_result('https://www.youtube.com' + season.group(1), 'YoutubePlaylist') for season in m_seasons]
1089
1090
1091 class YoutubeFeedsInfoExtractor(YoutubeBaseInfoExtractor):
1092     """
1093     Base class for extractors that fetch info from
1094     http://www.youtube.com/feed_ajax
1095     Subclasses must define the _FEED_NAME and _PLAYLIST_TITLE properties.
1096     """
1097     _LOGIN_REQUIRED = True
1098     _PAGING_STEP = 30
1099     # use action_load_personal_feed instead of action_load_system_feed
1100     _PERSONAL_FEED = False
1101
1102     @property
1103     def _FEED_TEMPLATE(self):
1104         action = 'action_load_system_feed'
1105         if self._PERSONAL_FEED:
1106             action = 'action_load_personal_feed'
1107         return 'http://www.youtube.com/feed_ajax?%s=1&feed_name=%s&paging=%%s' % (action, self._FEED_NAME)
1108
1109     @property
1110     def IE_NAME(self):
1111         return u'youtube:%s' % self._FEED_NAME
1112
1113     def _real_initialize(self):
1114         self._login()
1115
1116     def _real_extract(self, url):
1117         feed_entries = []
1118         # The step argument is available only in 2.7 or higher
1119         for i in itertools.count(0):
1120             paging = i*self._PAGING_STEP
1121             info = self._download_webpage(self._FEED_TEMPLATE % paging,
1122                                           u'%s feed' % self._FEED_NAME,
1123                                           u'Downloading page %s' % i)
1124             info = json.loads(info)
1125             feed_html = info['feed_html']
1126             m_ids = re.finditer(r'"/watch\?v=(.*?)["&]', feed_html)
1127             ids = orderedSet(m.group(1) for m in m_ids)
1128             feed_entries.extend(self.url_result(id, 'Youtube') for id in ids)
1129             if info['paging'] is None:
1130                 break
1131         return self.playlist_result(feed_entries, playlist_title=self._PLAYLIST_TITLE)
1132
1133 class YoutubeSubscriptionsIE(YoutubeFeedsInfoExtractor):
1134     IE_DESC = u'YouTube.com subscriptions feed, "ytsubs" keyword(requires authentication)'
1135     _VALID_URL = r'https?://www\.youtube\.com/feed/subscriptions|:ytsubs(?:criptions)?'
1136     _FEED_NAME = 'subscriptions'
1137     _PLAYLIST_TITLE = u'Youtube Subscriptions'
1138
1139 class YoutubeRecommendedIE(YoutubeFeedsInfoExtractor):
1140     IE_DESC = u'YouTube.com recommended videos, "ytrec" keyword (requires authentication)'
1141     _VALID_URL = r'https?://www\.youtube\.com/feed/recommended|:ytrec(?:ommended)?'
1142     _FEED_NAME = 'recommended'
1143     _PLAYLIST_TITLE = u'Youtube Recommended videos'
1144
1145 class YoutubeWatchLaterIE(YoutubeFeedsInfoExtractor):
1146     IE_DESC = u'Youtube watch later list, "ytwatchlater" keyword (requires authentication)'
1147     _VALID_URL = r'https?://www\.youtube\.com/feed/watch_later|:ytwatchlater'
1148     _FEED_NAME = 'watch_later'
1149     _PLAYLIST_TITLE = u'Youtube Watch Later'
1150     _PAGING_STEP = 100
1151     _PERSONAL_FEED = True
1152
1153 class YoutubeFavouritesIE(YoutubeBaseInfoExtractor):
1154     IE_NAME = u'youtube:favorites'
1155     IE_DESC = u'YouTube.com favourite videos, "ytfav" keyword (requires authentication)'
1156     _VALID_URL = r'https?://www\.youtube\.com/my_favorites|:ytfav(?:ou?rites)?'
1157     _LOGIN_REQUIRED = True
1158
1159     def _real_extract(self, url):
1160         webpage = self._download_webpage('https://www.youtube.com/my_favorites', 'Youtube Favourites videos')
1161         playlist_id = self._search_regex(r'list=(.+?)["&]', webpage, u'favourites playlist id')
1162         return self.url_result(playlist_id, 'YoutubePlaylist')