_ 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 re
  10 import time
  11 import traceback
  12
  13 from .common import InfoExtractor, SearchInfoExtractor
  14 from .subtitles import SubtitlesInfoExtractor
  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,
  21     compat_urllib_request,
  22     compat_urlparse,
  23     compat_str,
  24 )
  25 from ..utils import (
  26     clean_html,
  27     ExtractorError,
  28     get_element_by_attribute,
  29     get_element_by_id,
  30     int_or_none,
  31     OnDemandPagedList,
  32     orderedSet,
  33     unescapeHTML,
  34     unified_strdate,
  35     uppercase_escape,
  36 )
  37
  38
  39 class YoutubeBaseInfoExtractor(InfoExtractor):
  40     """Provide base functions for Youtube extractors"""
  41     _LOGIN_URL = 'https://accounts.google.com/ServiceLogin'
  42     _TWOFACTOR_URL = 'https://accounts.google.com/SecondFactor'
  43     _NETRC_MACHINE = 'youtube'
  44     # If True it will raise an error if no login info is provided
  45     _LOGIN_REQUIRED = False
  46
  47     def _set_language(self):
  48         self._set_cookie(
  49             '.youtube.com', 'PREF', 'f1=50000000&hl=en',
  50             # YouTube sets the expire time to about two months
  51             expire_time=time.time() + 2 * 30 * 24 * 3600)
  52
  53     def _login(self):
  54         """
  55         Attempt to log in to YouTube.
  56         True is returned if successful or skipped.
  57         False is returned if login failed.
  58
  59         If _LOGIN_REQUIRED is set and no authentication was provided, an error is raised.
  60         """
  61         (username, password) = self._get_login_info()
  62         # No authentication to be performed
  63         if username is None:
  64             if self._LOGIN_REQUIRED:
  65                 raise ExtractorError('No login info available, needed for using %s.' % self.IE_NAME, expected=True)
  66             return True
  67
  68         login_page = self._download_webpage(
  69             self._LOGIN_URL, None,
  70             note='Downloading login page',
  71             errnote='unable to fetch login page', fatal=False)
  72         if login_page is False:
  73             return
  74
  75         galx = self._search_regex(r'(?s)<input.+?name="GALX".+?value="(.+?)"',
  76                                   login_page, 'Login GALX parameter')
  77
  78         # Log in
  79         login_form_strs = {
  80             'continue': 'https://www.youtube.com/signin?action_handle_signin=true&feature=sign_in_button&hl=en_US&nomobiletemp=1',
  81             'Email': username,
  82             'GALX': galx,
  83             'Passwd': password,
  84
  85             'PersistentCookie': 'yes',
  86             '_utf8': '霱',
  87             'bgresponse': 'js_disabled',
  88             'checkConnection': '',
  89             'checkedDomains': 'youtube',
  90             'dnConn': '',
  91             'pstMsg': '0',
  92             'rmShown': '1',
  93             'secTok': '',
  94             'signIn': 'Sign in',
  95             'timeStmp': '',
  96             'service': 'youtube',
  97             'uilel': '3',
  98             'hl': 'en_US',
  99         }
 100
 101         # Convert to UTF-8 *before* urlencode because Python 2.x's urlencode
 102         # chokes on unicode
 103         login_form = dict((k.encode('utf-8'), v.encode('utf-8')) for k, v in login_form_strs.items())
 104         login_data = compat_urllib_parse.urlencode(login_form).encode('ascii')
 105
 106         req = compat_urllib_request.Request(self._LOGIN_URL, login_data)
 107         login_results = self._download_webpage(
 108             req, None,
 109             note='Logging in', errnote='unable to log in', fatal=False)
 110         if login_results is False:
 111             return False
 112
 113         if re.search(r'id="errormsg_0_Passwd"', login_results) is not None:
 114             raise ExtractorError('Please use your account password and a two-factor code instead of an application-specific password.', expected=True)
 115
 116         # Two-Factor
 117         # TODO add SMS and phone call support - these require making a request and then prompting the user
 118
 119         if re.search(r'(?i)<form[^>]* id="gaia_secondfactorform"', login_results) is not None:
 120             tfa_code = self._get_tfa_info()
 121
 122             if tfa_code is None:
 123                 self._downloader.report_warning('Two-factor authentication required. Provide it with --twofactor <code>')
 124                 self._downloader.report_warning('(Note that only TOTP (Google Authenticator App) codes work at this time.)')
 125                 return False
 126
 127             # Unlike the first login form, secTok and timeStmp are both required for the TFA form
 128
 129             match = re.search(r'id="secTok"\n\s+value=\'(.+)\'/>', login_results, re.M | re.U)
 130             if match is None:
 131                 self._downloader.report_warning('Failed to get secTok - did the page structure change?')
 132             secTok = match.group(1)
 133             match = re.search(r'id="timeStmp"\n\s+value=\'(.+)\'/>', login_results, re.M | re.U)
 134             if match is None:
 135                 self._downloader.report_warning('Failed to get timeStmp - did the page structure change?')
 136             timeStmp = match.group(1)
 137
 138             tfa_form_strs = {
 139                 'continue': 'https://www.youtube.com/signin?action_handle_signin=true&feature=sign_in_button&hl=en_US&nomobiletemp=1',
 140                 'smsToken': '',
 141                 'smsUserPin': tfa_code,
 142                 'smsVerifyPin': 'Verify',
 143
 144                 'PersistentCookie': 'yes',
 145                 'checkConnection': '',
 146                 'checkedDomains': 'youtube',
 147                 'pstMsg': '1',
 148                 'secTok': secTok,
 149                 'timeStmp': timeStmp,
 150                 'service': 'youtube',
 151                 'hl': 'en_US',
 152             }
 153             tfa_form = dict((k.encode('utf-8'), v.encode('utf-8')) for k, v in tfa_form_strs.items())
 154             tfa_data = compat_urllib_parse.urlencode(tfa_form).encode('ascii')
 155
 156             tfa_req = compat_urllib_request.Request(self._TWOFACTOR_URL, tfa_data)
 157             tfa_results = self._download_webpage(
 158                 tfa_req, None,
 159                 note='Submitting TFA code', errnote='unable to submit tfa', fatal=False)
 160
 161             if tfa_results is False:
 162                 return False
 163
 164             if re.search(r'(?i)<form[^>]* id="gaia_secondfactorform"', tfa_results) is not None:
 165                 self._downloader.report_warning('Two-factor code expired. Please try again, or use a one-use backup code instead.')
 166                 return False
 167             if re.search(r'(?i)<form[^>]* id="gaia_loginform"', tfa_results) is not None:
 168                 self._downloader.report_warning('unable to log in - did the page structure change?')
 169                 return False
 170             if re.search(r'smsauth-interstitial-reviewsettings', tfa_results) is not None:
 171                 self._downloader.report_warning('Your Google account has a security notice. Please log in on your web browser, resolve the notice, and try again.')
 172                 return False
 173
 174         if re.search(r'(?i)<form[^>]* id="gaia_loginform"', login_results) is not None:
 175             self._downloader.report_warning('unable to log in: bad username or password')
 176             return False
 177         return True
 178
 179     def _real_initialize(self):
 180         if self._downloader is None:
 181             return
 182         self._set_language()
 183         if not self._login():
 184             return
 185
 186
 187 class YoutubeIE(YoutubeBaseInfoExtractor, SubtitlesInfoExtractor):
 188     IE_DESC = 'YouTube.com'
 189     _VALID_URL = r"""(?x)^
 190                      (
 191                          (?:https?://|//)                                    # http(s):// or protocol-independent URL
 192                          (?:(?:(?:(?:\w+\.)?[yY][oO][uU][tT][uU][bB][eE](?:-nocookie)?\.com/|
 193                             (?:www\.)?deturl\.com/www\.youtube\.com/|
 194                             (?:www\.)?pwnyoutube\.com/|
 195                             (?:www\.)?yourepeat\.com/|
 196                             tube\.majestyc\.net/|
 197                             youtube\.googleapis\.com/)                        # the various hostnames, with wildcard subdomains
 198                          (?:.*?\#/)?                                          # handle anchor (#/) redirect urls
 199                          (?:                                                  # the various things that can precede the ID:
 200                              (?:(?:v|embed|e)/(?!videoseries))                # v/ or embed/ or e/
 201                              |(?:                                             # or the v= param in all its forms
 202                                  (?:(?:watch|movie)(?:_popup)?(?:\.php)?/?)?  # preceding watch(_popup|.php) or nothing (like /?v=xxxx)
 203                                  (?:\?|\#!?)                                  # the params delimiter ? or # or #!
 204                                  (?:.*?&)?                                    # any other preceding param (like /?s=tuff&v=xxxx)
 205                                  v=
 206                              )
 207                          ))
 208                          |youtu\.be/                                          # just youtu.be/xxxx
 209                          |(?:www\.)?cleanvideosearch\.com/media/action/yt/watch\?videoId=
 210                          )
 211                      )?                                                       # all until now is optional -> you can pass the naked ID
 212                      ([0-9A-Za-z_-]{11})                                      # here is it! the YouTube video ID
 213                      (?!.*?&list=)                                            # combined list/video URLs are handled by the playlist IE
 214                      (?(1).+)?                                                # if we found the ID, everything can follow
 215                      $"""
 216     _NEXT_URL_RE = r'[\?&]next_url=([^&]+)'
 217     _formats = {
 218         '5': {'ext': 'flv', 'width': 400, 'height': 240},
 219         '6': {'ext': 'flv', 'width': 450, 'height': 270},
 220         '13': {'ext': '3gp'},
 221         '17': {'ext': '3gp', 'width': 176, 'height': 144},
 222         '18': {'ext': 'mp4', 'width': 640, 'height': 360},
 223         '22': {'ext': 'mp4', 'width': 1280, 'height': 720},
 224         '34': {'ext': 'flv', 'width': 640, 'height': 360},
 225         '35': {'ext': 'flv', 'width': 854, 'height': 480},
 226         '36': {'ext': '3gp', 'width': 320, 'height': 240},
 227         '37': {'ext': 'mp4', 'width': 1920, 'height': 1080},
 228         '38': {'ext': 'mp4', 'width': 4096, 'height': 3072},
 229         '43': {'ext': 'webm', 'width': 640, 'height': 360},
 230         '44': {'ext': 'webm', 'width': 854, 'height': 480},
 231         '45': {'ext': 'webm', 'width': 1280, 'height': 720},
 232         '46': {'ext': 'webm', 'width': 1920, 'height': 1080},
 233
 234
 235         # 3d videos
 236         '82': {'ext': 'mp4', 'height': 360, 'format_note': '3D', 'preference': -20},
 237         '83': {'ext': 'mp4', 'height': 480, 'format_note': '3D', 'preference': -20},
 238         '84': {'ext': 'mp4', 'height': 720, 'format_note': '3D', 'preference': -20},
 239         '85': {'ext': 'mp4', 'height': 1080, 'format_note': '3D', 'preference': -20},
 240         '100': {'ext': 'webm', 'height': 360, 'format_note': '3D', 'preference': -20},
 241         '101': {'ext': 'webm', 'height': 480, 'format_note': '3D', 'preference': -20},
 242         '102': {'ext': 'webm', 'height': 720, 'format_note': '3D', 'preference': -20},
 243
 244         # Apple HTTP Live Streaming
 245         '92': {'ext': 'mp4', 'height': 240, 'format_note': 'HLS', 'preference': -10},
 246         '93': {'ext': 'mp4', 'height': 360, 'format_note': 'HLS', 'preference': -10},
 247         '94': {'ext': 'mp4', 'height': 480, 'format_note': 'HLS', 'preference': -10},
 248         '95': {'ext': 'mp4', 'height': 720, 'format_note': 'HLS', 'preference': -10},
 249         '96': {'ext': 'mp4', 'height': 1080, 'format_note': 'HLS', 'preference': -10},
 250         '132': {'ext': 'mp4', 'height': 240, 'format_note': 'HLS', 'preference': -10},
 251         '151': {'ext': 'mp4', 'height': 72, 'format_note': 'HLS', 'preference': -10},
 252
 253         # DASH mp4 video
 254         '133': {'ext': 'mp4', 'height': 240, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 255         '134': {'ext': 'mp4', 'height': 360, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 256         '135': {'ext': 'mp4', 'height': 480, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 257         '136': {'ext': 'mp4', 'height': 720, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 258         '137': {'ext': 'mp4', 'height': 1080, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 259         '138': {'ext': 'mp4', 'height': 2160, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 260         '160': {'ext': 'mp4', 'height': 144, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 261         '264': {'ext': 'mp4', 'height': 1440, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 262         '298': {'ext': 'mp4', 'height': 720, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40, 'fps': 60, 'vcodec': 'h264'},
 263         '299': {'ext': 'mp4', 'height': 1080, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40, 'fps': 60, 'vcodec': 'h264'},
 264         '266': {'ext': 'mp4', 'height': 2160, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40, 'vcodec': 'h264'},
 265
 266         # Dash mp4 audio
 267         '139': {'ext': 'm4a', 'format_note': 'DASH audio', 'vcodec': 'none', 'abr': 48, 'preference': -50},
 268         '140': {'ext': 'm4a', 'format_note': 'DASH audio', 'vcodec': 'none', 'abr': 128, 'preference': -50},
 269         '141': {'ext': 'm4a', 'format_note': 'DASH audio', 'vcodec': 'none', 'abr': 256, 'preference': -50},
 270
 271         # Dash webm
 272         '167': {'ext': 'webm', 'height': 360, 'width': 640, 'format_note': 'DASH video', 'acodec': 'none', 'container': 'webm', 'vcodec': 'VP8', 'preference': -40},
 273         '168': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'acodec': 'none', 'container': 'webm', 'vcodec': 'VP8', 'preference': -40},
 274         '169': {'ext': 'webm', 'height': 720, 'width': 1280, 'format_note': 'DASH video', 'acodec': 'none', 'container': 'webm', 'vcodec': 'VP8', 'preference': -40},
 275         '170': {'ext': 'webm', 'height': 1080, 'width': 1920, 'format_note': 'DASH video', 'acodec': 'none', 'container': 'webm', 'vcodec': 'VP8', 'preference': -40},
 276         '218': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'acodec': 'none', 'container': 'webm', 'vcodec': 'VP8', 'preference': -40},
 277         '219': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'acodec': 'none', 'container': 'webm', 'vcodec': 'VP8', 'preference': -40},
 278         '278': {'ext': 'webm', 'height': 144, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40, 'container': 'webm', 'vcodec': 'VP9'},
 279         '242': {'ext': 'webm', 'height': 240, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 280         '243': {'ext': 'webm', 'height': 360, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 281         '244': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 282         '245': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 283         '246': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 284         '247': {'ext': 'webm', 'height': 720, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 285         '248': {'ext': 'webm', 'height': 1080, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 286         '271': {'ext': 'webm', 'height': 1440, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 287         '272': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40},
 288         '302': {'ext': 'webm', 'height': 720, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40, 'fps': 60, 'vcodec': 'VP9'},
 289         '303': {'ext': 'webm', 'height': 1080, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40, 'fps': 60, 'vcodec': 'VP9'},
 290         '313': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'acodec': 'none', 'preference': -40, 'vcodec': 'VP9'},
 291
 292         # Dash webm audio
 293         '171': {'ext': 'webm', 'vcodec': 'none', 'format_note': 'DASH audio', 'abr': 128, 'preference': -50},
 294         '172': {'ext': 'webm', 'vcodec': 'none', 'format_note': 'DASH audio', 'abr': 256, 'preference': -50},
 295
 296         # Dash webm audio with opus inside
 297         '249': {'ext': 'webm', 'vcodec': 'none', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 50, 'preference': -50},
 298         '250': {'ext': 'webm', 'vcodec': 'none', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 70, 'preference': -50},
 299         '251': {'ext': 'webm', 'vcodec': 'none', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 160, 'preference': -50},
 300
 301         # RTMP (unnamed)
 302         '_rtmp': {'protocol': 'rtmp'},
 303     }
 304
 305     IE_NAME = 'youtube'
 306     _TESTS = [
 307         {
 308             'url': 'http://www.youtube.com/watch?v=BaW_jenozKc',
 309             'info_dict': {
 310                 'id': 'BaW_jenozKc',
 311                 'ext': 'mp4',
 312                 'title': 'youtube-dl test video "\'/\\ä↭𝕐',
 313                 'uploader': 'Philipp Hagemeister',
 314                 'uploader_id': 'phihag',
 315                 'upload_date': '20121002',
 316                 '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 .',
 317                 'categories': ['Science & Technology'],
 318                 'like_count': int,
 319                 'dislike_count': int,
 320             }
 321         },
 322         {
 323             'url': 'http://www.youtube.com/watch?v=UxxajLWwzqY',
 324             'note': 'Test generic use_cipher_signature video (#897)',
 325             'info_dict': {
 326                 'id': 'UxxajLWwzqY',
 327                 'ext': 'mp4',
 328                 'upload_date': '20120506',
 329                 'title': 'Icona Pop - I Love It (feat. Charli XCX) [OFFICIAL VIDEO]',
 330                 'description': 'md5:fea86fda2d5a5784273df5c7cc994d9f',
 331                 'uploader': 'Icona Pop',
 332                 'uploader_id': 'IconaPop',
 333             }
 334         },
 335         {
 336             'url': 'https://www.youtube.com/watch?v=07FYdnEawAQ',
 337             'note': 'Test VEVO video with age protection (#956)',
 338             'info_dict': {
 339                 'id': '07FYdnEawAQ',
 340                 'ext': 'mp4',
 341                 'upload_date': '20130703',
 342                 'title': 'Justin Timberlake - Tunnel Vision (Explicit)',
 343                 'description': 'md5:64249768eec3bc4276236606ea996373',
 344                 'uploader': 'justintimberlakeVEVO',
 345                 'uploader_id': 'justintimberlakeVEVO',
 346             }
 347         },
 348         {
 349             'url': '//www.YouTube.com/watch?v=yZIXLfi8CZQ',
 350             'note': 'Embed-only video (#1746)',
 351             'info_dict': {
 352                 'id': 'yZIXLfi8CZQ',
 353                 'ext': 'mp4',
 354                 'upload_date': '20120608',
 355                 'title': 'Principal Sexually Assaults A Teacher - Episode 117 - 8th June 2012',
 356                 'description': 'md5:09b78bd971f1e3e289601dfba15ca4f7',
 357                 'uploader': 'SET India',
 358                 'uploader_id': 'setindia'
 359             }
 360         },
 361         {
 362             'url': 'http://www.youtube.com/watch?v=a9LDPn-MO4I',
 363             'note': '256k DASH audio (format 141) via DASH manifest',
 364             'info_dict': {
 365                 'id': 'a9LDPn-MO4I',
 366                 'ext': 'm4a',
 367                 'upload_date': '20121002',
 368                 'uploader_id': '8KVIDEO',
 369                 'description': '',
 370                 'uploader': '8KVIDEO',
 371                 'title': 'UHDTV TEST 8K VIDEO.mp4'
 372             },
 373             'params': {
 374                 'youtube_include_dash_manifest': True,
 375                 'format': '141',
 376             },
 377         },
 378         # DASH manifest with encrypted signature
 379         {
 380             'url': 'https://www.youtube.com/watch?v=IB3lcPjvWLA',
 381             'info_dict': {
 382                 'id': 'IB3lcPjvWLA',
 383                 'ext': 'm4a',
 384                 'title': 'Afrojack, Spree Wilson - The Spark ft. Spree Wilson',
 385                 'description': 'md5:12e7067fa6735a77bdcbb58cb1187d2d',
 386                 'uploader': 'AfrojackVEVO',
 387                 'uploader_id': 'AfrojackVEVO',
 388                 'upload_date': '20131011',
 389             },
 390             'params': {
 391                 'youtube_include_dash_manifest': True,
 392                 'format': '141',
 393             },
 394         },
 395         # Controversy video
 396         {
 397             'url': 'https://www.youtube.com/watch?v=T4XJQO3qol8',
 398             'info_dict': {
 399                 'id': 'T4XJQO3qol8',
 400                 'ext': 'mp4',
 401                 'upload_date': '20100909',
 402                 'uploader': 'The Amazing Atheist',
 403                 'uploader_id': 'TheAmazingAtheist',
 404                 'title': 'Burning Everyone\'s Koran',
 405                 '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',
 406             }
 407         },
 408         # Normal age-gate video (No vevo, embed allowed)
 409         {
 410             'url': 'http://youtube.com/watch?v=HtVdAasjOgU',
 411             'info_dict': {
 412                 'id': 'HtVdAasjOgU',
 413                 'ext': 'mp4',
 414                 'title': 'The Witcher 3: Wild Hunt - The Sword Of Destiny Trailer',
 415                 'description': 'md5:eca57043abae25130f58f655ad9a7771',
 416                 'uploader': 'The Witcher',
 417                 'uploader_id': 'WitcherGame',
 418                 'upload_date': '20140605',
 419             },
 420         },
 421         # video_info is None (https://github.com/rg3/youtube-dl/issues/4421)
 422         {
 423             'url': '__2ABJjxzNo',
 424             'info_dict': {
 425                 'id': '__2ABJjxzNo',
 426                 'ext': 'mp4',
 427                 'upload_date': '20100430',
 428                 'uploader_id': 'deadmau5',
 429                 'description': 'md5:12c56784b8032162bb936a5f76d55360',
 430                 'uploader': 'deadmau5',
 431                 'title': 'Deadmau5 - Some Chords (HD)',
 432             },
 433             'expected_warnings': [
 434                 'DASH manifest missing',
 435             ]
 436         },
 437         # Olympics (https://github.com/rg3/youtube-dl/issues/4431)
 438         {
 439             'url': 'lqQg6PlCWgI',
 440             'info_dict': {
 441                 'id': 'lqQg6PlCWgI',
 442                 'ext': 'mp4',
 443
 444             }
 445         }
 446     ]
 447
 448     def __init__(self, *args, **kwargs):
 449         super(YoutubeIE, self).__init__(*args, **kwargs)
 450         self._player_cache = {}
 451
 452     def report_video_info_webpage_download(self, video_id):
 453         """Report attempt to download video info webpage."""
 454         self.to_screen('%s: Downloading video info webpage' % video_id)
 455
 456     def report_information_extraction(self, video_id):
 457         """Report attempt to extract video information."""
 458         self.to_screen('%s: Extracting video information' % video_id)
 459
 460     def report_unavailable_format(self, video_id, format):
 461         """Report extracted video URL."""
 462         self.to_screen('%s: Format %s not available' % (video_id, format))
 463
 464     def report_rtmp_download(self):
 465         """Indicate the download will use the RTMP protocol."""
 466         self.to_screen('RTMP download detected')
 467
 468     def _signature_cache_id(self, example_sig):
 469         """ Return a string representation of a signature """
 470         return '.'.join(compat_str(len(part)) for part in example_sig.split('.'))
 471
 472     def _extract_signature_function(self, video_id, player_url, example_sig):
 473         id_m = re.match(
 474             r'.*-(?P<id>[a-zA-Z0-9_-]+)(?:/watch_as3|/html5player)?\.(?P<ext>[a-z]+)$',
 475             player_url)
 476         if not id_m:
 477             raise ExtractorError('Cannot identify player %r' % player_url)
 478         player_type = id_m.group('ext')
 479         player_id = id_m.group('id')
 480
 481         # Read from filesystem cache
 482         func_id = '%s_%s_%s' % (
 483             player_type, player_id, self._signature_cache_id(example_sig))
 484         assert os.path.basename(func_id) == func_id
 485
 486         cache_spec = self._downloader.cache.load('youtube-sigfuncs', func_id)
 487         if cache_spec is not None:
 488             return lambda s: ''.join(s[i] for i in cache_spec)
 489
 490         if player_type == 'js':
 491             code = self._download_webpage(
 492                 player_url, video_id,
 493                 note='Downloading %s player %s' % (player_type, player_id),
 494                 errnote='Download of %s failed' % player_url)
 495             res = self._parse_sig_js(code)
 496         elif player_type == 'swf':
 497             urlh = self._request_webpage(
 498                 player_url, video_id,
 499                 note='Downloading %s player %s' % (player_type, player_id),
 500                 errnote='Download of %s failed' % player_url)
 501             code = urlh.read()
 502             res = self._parse_sig_swf(code)
 503         else:
 504             assert False, 'Invalid player type %r' % player_type
 505
 506         if cache_spec is None:
 507             test_string = ''.join(map(compat_chr, range(len(example_sig))))
 508             cache_res = res(test_string)
 509             cache_spec = [ord(c) for c in cache_res]
 510
 511         self._downloader.cache.store('youtube-sigfuncs', func_id, cache_spec)
 512         return res
 513
 514     def _print_sig_code(self, func, example_sig):
 515         def gen_sig_code(idxs):
 516             def _genslice(start, end, step):
 517                 starts = '' if start == 0 else str(start)
 518                 ends = (':%d' % (end + step)) if end + step >= 0 else ':'
 519                 steps = '' if step == 1 else (':%d' % step)
 520                 return 's[%s%s%s]' % (starts, ends, steps)
 521
 522             step = None
 523             start = '(Never used)'  # Quelch pyflakes warnings - start will be
 524                                     # set as soon as step is set
 525             for i, prev in zip(idxs[1:], idxs[:-1]):
 526                 if step is not None:
 527                     if i - prev == step:
 528                         continue
 529                     yield _genslice(start, prev, step)
 530                     step = None
 531                     continue
 532                 if i - prev in [-1, 1]:
 533                     step = i - prev
 534                     start = prev
 535                     continue
 536                 else:
 537                     yield 's[%d]' % prev
 538             if step is None:
 539                 yield 's[%d]' % i
 540             else:
 541                 yield _genslice(start, i, step)
 542
 543         test_string = ''.join(map(compat_chr, range(len(example_sig))))
 544         cache_res = func(test_string)
 545         cache_spec = [ord(c) for c in cache_res]
 546         expr_code = ' + '.join(gen_sig_code(cache_spec))
 547         signature_id_tuple = '(%s)' % (
 548             ', '.join(compat_str(len(p)) for p in example_sig.split('.')))
 549         code = ('if tuple(len(p) for p in s.split(\'.\')) == %s:\n'
 550                 '    return %s\n') % (signature_id_tuple, expr_code)
 551         self.to_screen('Extracted signature function:\n' + code)
 552
 553     def _parse_sig_js(self, jscode):
 554         funcname = self._search_regex(
 555             r'\.sig\|\|([a-zA-Z0-9]+)\(', jscode,
 556             'Initial JS player signature function name')
 557
 558         jsi = JSInterpreter(jscode)
 559         initial_function = jsi.extract_function(funcname)
 560         return lambda s: initial_function([s])
 561
 562     def _parse_sig_swf(self, file_contents):
 563         swfi = SWFInterpreter(file_contents)
 564         TARGET_CLASSNAME = 'SignatureDecipher'
 565         searched_class = swfi.extract_class(TARGET_CLASSNAME)
 566         initial_function = swfi.extract_function(searched_class, 'decipher')
 567         return lambda s: initial_function([s])
 568
 569     def _decrypt_signature(self, s, video_id, player_url, age_gate=False):
 570         """Turn the encrypted s field into a working signature"""
 571
 572         if player_url is None:
 573             raise ExtractorError('Cannot decrypt signature without player_url')
 574
 575         if player_url.startswith('//'):
 576             player_url = 'https:' + player_url
 577         try:
 578             player_id = (player_url, self._signature_cache_id(s))
 579             if player_id not in self._player_cache:
 580                 func = self._extract_signature_function(
 581                     video_id, player_url, s
 582                 )
 583                 self._player_cache[player_id] = func
 584             func = self._player_cache[player_id]
 585             if self._downloader.params.get('youtube_print_sig_code'):
 586                 self._print_sig_code(func, s)
 587             return func(s)
 588         except Exception as e:
 589             tb = traceback.format_exc()
 590             raise ExtractorError(
 591                 'Signature extraction failed: ' + tb, cause=e)
 592
 593     def _get_available_subtitles(self, video_id, webpage):
 594         try:
 595             sub_list = self._download_webpage(
 596                 'https://video.google.com/timedtext?hl=en&type=list&v=%s' % video_id,
 597                 video_id, note=False)
 598         except ExtractorError as err:
 599             self._downloader.report_warning('unable to download video subtitles: %s' % compat_str(err))
 600             return {}
 601         lang_list = re.findall(r'name="([^"]*)"[^>]+lang_code="([\w\-]+)"', sub_list)
 602
 603         sub_lang_list = {}
 604         for l in lang_list:
 605             lang = l[1]
 606             if lang in sub_lang_list:
 607                 continue
 608             params = compat_urllib_parse.urlencode({
 609                 'lang': lang,
 610                 'v': video_id,
 611                 'fmt': self._downloader.params.get('subtitlesformat', 'srt'),
 612                 'name': unescapeHTML(l[0]).encode('utf-8'),
 613             })
 614             url = 'https://www.youtube.com/api/timedtext?' + params
 615             sub_lang_list[lang] = url
 616         if not sub_lang_list:
 617             self._downloader.report_warning('video doesn\'t have subtitles')
 618             return {}
 619         return sub_lang_list
 620
 621     def _get_available_automatic_caption(self, video_id, webpage):
 622         """We need the webpage for getting the captions url, pass it as an
 623            argument to speed up the process."""
 624         sub_format = self._downloader.params.get('subtitlesformat', 'srt')
 625         self.to_screen('%s: Looking for automatic captions' % video_id)
 626         mobj = re.search(r';ytplayer.config = ({.*?});', webpage)
 627         err_msg = 'Couldn\'t find automatic captions for %s' % video_id
 628         if mobj is None:
 629             self._downloader.report_warning(err_msg)
 630             return {}
 631         player_config = json.loads(mobj.group(1))
 632         try:
 633             args = player_config['args']
 634             caption_url = args['ttsurl']
 635             timestamp = args['timestamp']
 636             # We get the available subtitles
 637             list_params = compat_urllib_parse.urlencode({
 638                 'type': 'list',
 639                 'tlangs': 1,
 640                 'asrs': 1,
 641             })
 642             list_url = caption_url + '&' + list_params
 643             caption_list = self._download_xml(list_url, video_id)
 644             original_lang_node = caption_list.find('track')
 645             if original_lang_node is None or original_lang_node.attrib.get('kind') != 'asr':
 646                 self._downloader.report_warning('Video doesn\'t have automatic captions')
 647                 return {}
 648             original_lang = original_lang_node.attrib['lang_code']
 649
 650             sub_lang_list = {}
 651             for lang_node in caption_list.findall('target'):
 652                 sub_lang = lang_node.attrib['lang_code']
 653                 params = compat_urllib_parse.urlencode({
 654                     'lang': original_lang,
 655                     'tlang': sub_lang,
 656                     'fmt': sub_format,
 657                     'ts': timestamp,
 658                     'kind': 'asr',
 659                 })
 660                 sub_lang_list[sub_lang] = caption_url + '&' + params
 661             return sub_lang_list
 662         # An extractor error can be raise by the download process if there are
 663         # no automatic captions but there are subtitles
 664         except (KeyError, ExtractorError):
 665             self._downloader.report_warning(err_msg)
 666             return {}
 667
 668     @classmethod
 669     def extract_id(cls, url):
 670         mobj = re.match(cls._VALID_URL, url, re.VERBOSE)
 671         if mobj is None:
 672             raise ExtractorError('Invalid URL: %s' % url)
 673         video_id = mobj.group(2)
 674         return video_id
 675
 676     def _extract_from_m3u8(self, manifest_url, video_id):
 677         url_map = {}
 678
 679         def _get_urls(_manifest):
 680             lines = _manifest.split('\n')
 681             urls = filter(lambda l: l and not l.startswith('#'),
 682                           lines)
 683             return urls
 684         manifest = self._download_webpage(manifest_url, video_id, 'Downloading formats manifest')
 685         formats_urls = _get_urls(manifest)
 686         for format_url in formats_urls:
 687             itag = self._search_regex(r'itag/(\d+?)/', format_url, 'itag')
 688             url_map[itag] = format_url
 689         return url_map
 690
 691     def _extract_annotations(self, video_id):
 692         url = 'https://www.youtube.com/annotations_invideo?features=1&legacy=1&video_id=%s' % video_id
 693         return self._download_webpage(url, video_id, note='Searching for annotations.', errnote='Unable to download video annotations.')
 694
 695     def _parse_dash_manifest(
 696             self, video_id, dash_manifest_url, player_url, age_gate):
 697         def decrypt_sig(mobj):
 698             s = mobj.group(1)
 699             dec_s = self._decrypt_signature(s, video_id, player_url, age_gate)
 700             return '/signature/%s' % dec_s
 701         dash_manifest_url = re.sub(r'/s/([\w\.]+)', decrypt_sig, dash_manifest_url)
 702         dash_doc = self._download_xml(
 703             dash_manifest_url, video_id,
 704             note='Downloading DASH manifest',
 705             errnote='Could not download DASH manifest')
 706
 707         formats = []
 708         for r in dash_doc.findall('.//{urn:mpeg:DASH:schema:MPD:2011}Representation'):
 709             url_el = r.find('{urn:mpeg:DASH:schema:MPD:2011}BaseURL')
 710             if url_el is None:
 711                 continue
 712             format_id = r.attrib['id']
 713             video_url = url_el.text
 714             filesize = int_or_none(url_el.attrib.get('{http://youtube.com/yt/2012/10/10}contentLength'))
 715             f = {
 716                 'format_id': format_id,
 717                 'url': video_url,
 718                 'width': int_or_none(r.attrib.get('width')),
 719                 'tbr': int_or_none(r.attrib.get('bandwidth'), 1000),
 720                 'asr': int_or_none(r.attrib.get('audioSamplingRate')),
 721                 'filesize': filesize,
 722                 'fps': int_or_none(r.attrib.get('frameRate')),
 723             }
 724             try:
 725                 existing_format = next(
 726                     fo for fo in formats
 727                     if fo['format_id'] == format_id)
 728             except StopIteration:
 729                 f.update(self._formats.get(format_id, {}))
 730                 formats.append(f)
 731             else:
 732                 existing_format.update(f)
 733         return formats
 734
 735     def _real_extract(self, url):
 736         proto = (
 737             'http' if self._downloader.params.get('prefer_insecure', False)
 738             else 'https')
 739
 740         # Extract original video URL from URL with redirection, like age verification, using next_url parameter
 741         mobj = re.search(self._NEXT_URL_RE, url)
 742         if mobj:
 743             url = proto + '://www.youtube.com/' + compat_urllib_parse.unquote(mobj.group(1)).lstrip('/')
 744         video_id = self.extract_id(url)
 745
 746         # Get video webpage
 747         url = proto + '://www.youtube.com/watch?v=%s&gl=US&hl=en&has_verified=1&bpctr=9999999999' % video_id
 748         video_webpage = self._download_webpage(url, video_id)
 749
 750         # Attempt to extract SWF player URL
 751         mobj = re.search(r'swfConfig.*?"(https?:\\/\\/.*?watch.*?-.*?\.swf)"', video_webpage)
 752         if mobj is not None:
 753             player_url = re.sub(r'\\(.)', r'\1', mobj.group(1))
 754         else:
 755             player_url = None
 756
 757         # Get video info
 758         if re.search(r'player-age-gate-content">', video_webpage) is not None:
 759             age_gate = True
 760             # We simulate the access to the video from www.youtube.com/v/{video_id}
 761             # this can be viewed without login into Youtube
 762             data = compat_urllib_parse.urlencode({
 763                 'video_id': video_id,
 764                 'eurl': 'https://youtube.googleapis.com/v/' + video_id,
 765                 'sts': self._search_regex(
 766                     r'"sts"\s*:\s*(\d+)', video_webpage, 'sts', default=''),
 767             })
 768             video_info_url = proto + '://www.youtube.com/get_video_info?' + data
 769             video_info_webpage = self._download_webpage(
 770                 video_info_url, video_id,
 771                 note='Refetching age-gated info webpage',
 772                 errnote='unable to download video info webpage')
 773             video_info = compat_parse_qs(video_info_webpage)
 774         else:
 775             age_gate = False
 776             try:
 777                 # Try looking directly into the video webpage
 778                 mobj = re.search(r';ytplayer\.config\s*=\s*({.*?});', video_webpage)
 779                 if not mobj:
 780                     raise ValueError('Could not find ytplayer.config')  # caught below
 781                 json_code = uppercase_escape(mobj.group(1))
 782                 ytplayer_config = json.loads(json_code)
 783                 args = ytplayer_config['args']
 784                 # Convert to the same format returned by compat_parse_qs
 785                 video_info = dict((k, [v]) for k, v in args.items())
 786                 if 'url_encoded_fmt_stream_map' not in args:
 787                     raise ValueError('No stream_map present')  # caught below
 788             except ValueError:
 789                 # We fallback to the get_video_info pages (used by the embed page)
 790                 self.report_video_info_webpage_download(video_id)
 791                 for el_type in ['&el=embedded', '&el=detailpage', '&el=vevo', '']:
 792                     video_info_url = (
 793                         '%s://www.youtube.com/get_video_info?&video_id=%s%s&ps=default&eurl=&gl=US&hl=en'
 794                         % (proto, video_id, el_type))
 795                     video_info_webpage = self._download_webpage(
 796                         video_info_url,
 797                         video_id, note=False,
 798                         errnote='unable to download video info webpage')
 799                     video_info = compat_parse_qs(video_info_webpage)
 800                     if 'token' in video_info:
 801                         break
 802         if 'token' not in video_info:
 803             if 'reason' in video_info:
 804                 raise ExtractorError(
 805                     'YouTube said: %s' % video_info['reason'][0],
 806                     expected=True, video_id=video_id)
 807             else:
 808                 raise ExtractorError(
 809                     '"token" parameter not in video info for unknown reason',
 810                     video_id=video_id)
 811
 812         if 'view_count' in video_info:
 813             view_count = int(video_info['view_count'][0])
 814         else:
 815             view_count = None
 816
 817         # Check for "rental" videos
 818         if 'ypc_video_rental_bar_text' in video_info and 'author' not in video_info:
 819             raise ExtractorError('"rental" videos not supported')
 820
 821         # Start extracting information
 822         self.report_information_extraction(video_id)
 823
 824         # uploader
 825         if 'author' not in video_info:
 826             raise ExtractorError('Unable to extract uploader name')
 827         video_uploader = compat_urllib_parse.unquote_plus(video_info['author'][0])
 828
 829         # uploader_id
 830         video_uploader_id = None
 831         mobj = re.search(r'<link itemprop="url" href="http://www.youtube.com/(?:user|channel)/([^"]+)">', video_webpage)
 832         if mobj is not None:
 833             video_uploader_id = mobj.group(1)
 834         else:
 835             self._downloader.report_warning('unable to extract uploader nickname')
 836
 837         # title
 838         if 'title' in video_info:
 839             video_title = video_info['title'][0]
 840         else:
 841             self._downloader.report_warning('Unable to extract video title')
 842             video_title = '_'
 843
 844         # thumbnail image
 845         # We try first to get a high quality image:
 846         m_thumb = re.search(r'<span itemprop="thumbnail".*?href="(.*?)">',
 847                             video_webpage, re.DOTALL)
 848         if m_thumb is not None:
 849             video_thumbnail = m_thumb.group(1)
 850         elif 'thumbnail_url' not in video_info:
 851             self._downloader.report_warning('unable to extract video thumbnail')
 852             video_thumbnail = None
 853         else:   # don't panic if we can't find it
 854             video_thumbnail = compat_urllib_parse.unquote_plus(video_info['thumbnail_url'][0])
 855
 856         # upload date
 857         upload_date = None
 858         mobj = re.search(r'(?s)id="eow-date.*?>(.*?)</span>', video_webpage)
 859         if mobj is None:
 860             mobj = re.search(
 861                 r'(?s)id="watch-uploader-info".*?>.*?(?:Published|Uploaded|Streamed live) on (.*?)</strong>',
 862                 video_webpage)
 863         if mobj is not None:
 864             upload_date = ' '.join(re.sub(r'[/,-]', r' ', mobj.group(1)).split())
 865             upload_date = unified_strdate(upload_date)
 866
 867         m_cat_container = self._search_regex(
 868             r'(?s)<h4[^>]*>\s*Category\s*</h4>\s*<ul[^>]*>(.*?)</ul>',
 869             video_webpage, 'categories', default=None)
 870         if m_cat_container:
 871             category = self._html_search_regex(
 872                 r'(?s)<a[^<]+>(.*?)</a>', m_cat_container, 'category',
 873                 default=None)
 874             video_categories = None if category is None else [category]
 875         else:
 876             video_categories = None
 877
 878         # description
 879         video_description = get_element_by_id("eow-description", video_webpage)
 880         if video_description:
 881             video_description = re.sub(r'''(?x)
 882                 <a\s+
 883                     (?:[a-zA-Z-]+="[^"]+"\s+)*?
 884                     title="([^"]+)"\s+
 885                     (?:[a-zA-Z-]+="[^"]+"\s+)*?
 886                     class="yt-uix-redirect-link"\s*>
 887                 [^<]+
 888                 </a>
 889             ''', r'\1', video_description)
 890             video_description = clean_html(video_description)
 891         else:
 892             fd_mobj = re.search(r'<meta name="description" content="([^"]+)"', video_webpage)
 893             if fd_mobj:
 894                 video_description = unescapeHTML(fd_mobj.group(1))
 895             else:
 896                 video_description = ''
 897
 898         def _extract_count(count_name):
 899             count = self._search_regex(
 900                 r'id="watch-%s"[^>]*>.*?([\d,]+)\s*</span>' % re.escape(count_name),
 901                 video_webpage, count_name, default=None)
 902             if count is not None:
 903                 return int(count.replace(',', ''))
 904             return None
 905         like_count = _extract_count('like')
 906         dislike_count = _extract_count('dislike')
 907
 908         # subtitles
 909         video_subtitles = self.extract_subtitles(video_id, video_webpage)
 910
 911         if self._downloader.params.get('listsubtitles', False):
 912             self._list_available_subtitles(video_id, video_webpage)
 913             return
 914
 915         if 'length_seconds' not in video_info:
 916             self._downloader.report_warning('unable to extract video duration')
 917             video_duration = None
 918         else:
 919             video_duration = int(compat_urllib_parse.unquote_plus(video_info['length_seconds'][0]))
 920
 921         # annotations
 922         video_annotations = None
 923         if self._downloader.params.get('writeannotations', False):
 924             video_annotations = self._extract_annotations(video_id)
 925
 926         def _map_to_format_list(urlmap):
 927             formats = []
 928             for itag, video_real_url in urlmap.items():
 929                 dct = {
 930                     'format_id': itag,
 931                     'url': video_real_url,
 932                     'player_url': player_url,
 933                 }
 934                 if itag in self._formats:
 935                     dct.update(self._formats[itag])
 936                 formats.append(dct)
 937             return formats
 938
 939         if 'conn' in video_info and video_info['conn'][0].startswith('rtmp'):
 940             self.report_rtmp_download()
 941             formats = [{
 942                 'format_id': '_rtmp',
 943                 'protocol': 'rtmp',
 944                 'url': video_info['conn'][0],
 945                 'player_url': player_url,
 946             }]
 947         elif len(video_info.get('url_encoded_fmt_stream_map', [''])[0]) >= 1 or len(video_info.get('adaptive_fmts', [''])[0]) >= 1:
 948             encoded_url_map = video_info.get('url_encoded_fmt_stream_map', [''])[0] + ',' + video_info.get('adaptive_fmts', [''])[0]
 949             if 'rtmpe%3Dyes' in encoded_url_map:
 950                 raise ExtractorError('rtmpe downloads are not supported, see https://github.com/rg3/youtube-dl/issues/343 for more information.', expected=True)
 951             url_map = {}
 952             for url_data_str in encoded_url_map.split(','):
 953                 url_data = compat_parse_qs(url_data_str)
 954                 if 'itag' not in url_data or 'url' not in url_data:
 955                     continue
 956                 format_id = url_data['itag'][0]
 957                 url = url_data['url'][0]
 958
 959                 if 'sig' in url_data:
 960                     url += '&signature=' + url_data['sig'][0]
 961                 elif 's' in url_data:
 962                     encrypted_sig = url_data['s'][0]
 963
 964                     if not age_gate:
 965                         jsplayer_url_json = self._search_regex(
 966                             r'"assets":.+?"js":\s*("[^"]+")',
 967                             video_webpage, 'JS player URL')
 968                         player_url = json.loads(jsplayer_url_json)
 969                     if player_url is None:
 970                         player_url_json = self._search_regex(
 971                             r'ytplayer\.config.*?"url"\s*:\s*("[^"]+")',
 972                             video_webpage, 'age gate player URL')
 973                         player_url = json.loads(player_url_json)
 974
 975                     if self._downloader.params.get('verbose'):
 976                         if player_url is None:
 977                             player_version = 'unknown'
 978                             player_desc = 'unknown'
 979                         else:
 980                             if player_url.endswith('swf'):
 981                                 player_version = self._search_regex(
 982                                     r'-(.+?)(?:/watch_as3)?\.swf$', player_url,
 983                                     'flash player', fatal=False)
 984                                 player_desc = 'flash player %s' % player_version
 985                             else:
 986                                 player_version = self._search_regex(
 987                                     r'html5player-([^/]+?)(?:/html5player)?\.js',
 988                                     player_url,
 989                                     'html5 player', fatal=False)
 990                                 player_desc = 'html5 player %s' % player_version
 991
 992                         parts_sizes = self._signature_cache_id(encrypted_sig)
 993                         self.to_screen('{%s} signature length %s, %s' %
 994                                        (format_id, parts_sizes, player_desc))
 995
 996                     signature = self._decrypt_signature(
 997                         encrypted_sig, video_id, player_url, age_gate)
 998                     url += '&signature=' + signature
 999                 if 'ratebypass' not in url:
1000                     url += '&ratebypass=yes'
1001                 url_map[format_id] = url
1002             formats = _map_to_format_list(url_map)
1003         elif video_info.get('hlsvp'):
1004             manifest_url = video_info['hlsvp'][0]
1005             url_map = self._extract_from_m3u8(manifest_url, video_id)
1006             formats = _map_to_format_list(url_map)
1007         else:
1008             raise ExtractorError('no conn, hlsvp or url_encoded_fmt_stream_map information found in video info')
1009
1010         # Look for the DASH manifest
1011         if self._downloader.params.get('youtube_include_dash_manifest', True):
1012             dash_mpd = video_info.get('dashmpd')
1013             if dash_mpd:
1014                 dash_manifest_url = dash_mpd[0]
1015                 try:
1016                     dash_formats = self._parse_dash_manifest(
1017                         video_id, dash_manifest_url, player_url, age_gate)
1018                 except (ExtractorError, KeyError) as e:
1019                     self.report_warning(
1020                         'Skipping DASH manifest: %r' % e, video_id)
1021                 else:
1022                     formats.extend(dash_formats)
1023
1024         self._sort_formats(formats)
1025
1026         return {
1027             'id': video_id,
1028             'uploader': video_uploader,
1029             'uploader_id': video_uploader_id,
1030             'upload_date': upload_date,
1031             'title': video_title,
1032             'thumbnail': video_thumbnail,
1033             'description': video_description,
1034             'categories': video_categories,
1035             'subtitles': video_subtitles,
1036             'duration': video_duration,
1037             'age_limit': 18 if age_gate else 0,
1038             'annotations': video_annotations,
1039             'webpage_url': proto + '://www.youtube.com/watch?v=%s' % video_id,
1040             'view_count': view_count,
1041             'like_count': like_count,
1042             'dislike_count': dislike_count,
1043             'formats': formats,
1044         }
1045
1046
1047 class YoutubePlaylistIE(YoutubeBaseInfoExtractor):
1048     IE_DESC = 'YouTube.com playlists'
1049     _VALID_URL = r"""(?x)(?:
1050                         (?:https?://)?
1051                         (?:\w+\.)?
1052                         youtube\.com/
1053                         (?:
1054                            (?:course|view_play_list|my_playlists|artist|playlist|watch|embed/videoseries)
1055                            \? (?:.*?&)*? (?:p|a|list)=
1056                         |  p/
1057                         )
1058                         (
1059                             (?:PL|LL|EC|UU|FL|RD)?[0-9A-Za-z-_]{10,}
1060                             # Top tracks, they can also include dots
1061                             |(?:MC)[\w\.]*
1062                         )
1063                         .*
1064                      |
1065                         ((?:PL|LL|EC|UU|FL|RD)[0-9A-Za-z-_]{10,})
1066                      )"""
1067     _TEMPLATE_URL = 'https://www.youtube.com/playlist?list=%s'
1068     _MORE_PAGES_INDICATOR = r'data-link-type="next"'
1069     _VIDEO_RE = r'href="\s*/watch\?v=(?P<id>[0-9A-Za-z_-]{11})&amp;[^"]*?index=(?P<index>\d+)'
1070     IE_NAME = 'youtube:playlist'
1071     _TESTS = [{
1072         'url': 'https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re',
1073         'info_dict': {
1074             'title': 'ytdl test PL',
1075             'id': 'PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re',
1076         },
1077         'playlist_count': 3,
1078     }, {
1079         'url': 'https://www.youtube.com/playlist?list=PLtPgu7CB4gbZDA7i_euNxn75ISqxwZPYx',
1080         'info_dict': {
1081             'title': 'YDL_Empty_List',
1082         },
1083         'playlist_count': 0,
1084     }, {
1085         'note': 'Playlist with deleted videos (#651). As a bonus, the video #51 is also twice in this list.',
1086         'url': 'https://www.youtube.com/playlist?list=PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
1087         'info_dict': {
1088             'title': '29C3: Not my department',
1089         },
1090         'playlist_count': 95,
1091     }, {
1092         'note': 'issue #673',
1093         'url': 'PLBB231211A4F62143',
1094         'info_dict': {
1095             'title': '[OLD]Team Fortress 2 (Class-based LP)',
1096         },
1097         'playlist_mincount': 26,
1098     }, {
1099         'note': 'Large playlist',
1100         'url': 'https://www.youtube.com/playlist?list=UUBABnxM4Ar9ten8Mdjj1j0Q',
1101         'info_dict': {
1102             'title': 'Uploads from Cauchemar',
1103         },
1104         'playlist_mincount': 799,
1105     }, {
1106         'url': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
1107         'info_dict': {
1108             'title': 'YDL_safe_search',
1109         },
1110         'playlist_count': 2,
1111     }, {
1112         'note': 'embedded',
1113         'url': 'http://www.youtube.com/embed/videoseries?list=PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
1114         'playlist_count': 4,
1115         'info_dict': {
1116             'title': 'JODA15',
1117         }
1118     }, {
1119         'note': 'Embedded SWF player',
1120         'url': 'http://www.youtube.com/p/YN5VISEtHet5D4NEvfTd0zcgFk84NqFZ?hl=en_US&fs=1&rel=0',
1121         'playlist_count': 4,
1122         'info_dict': {
1123             'title': 'JODA7',
1124         }
1125     }]
1126
1127     def _real_initialize(self):
1128         self._login()
1129
1130     def _ids_to_results(self, ids):
1131         return [
1132             self.url_result(vid_id, 'Youtube', video_id=vid_id)
1133             for vid_id in ids]
1134
1135     def _extract_mix(self, playlist_id):
1136         # The mixes are generated from a a single video
1137         # the id of the playlist is just 'RD' + video_id
1138         url = 'https://youtube.com/watch?v=%s&list=%s' % (playlist_id[-11:], playlist_id)
1139         webpage = self._download_webpage(
1140             url, playlist_id, 'Downloading Youtube mix')
1141         search_title = lambda class_name: get_element_by_attribute('class', class_name, webpage)
1142         title_span = (
1143             search_title('playlist-title') or
1144             search_title('title long-title') or
1145             search_title('title'))
1146         title = clean_html(title_span)
1147         ids = orderedSet(re.findall(
1148             r'''(?xs)data-video-username=".*?".*?
1149                        href="/watch\?v=([0-9A-Za-z_-]{11})&amp;[^"]*?list=%s''' % re.escape(playlist_id),
1150             webpage))
1151         url_results = self._ids_to_results(ids)
1152
1153         return self.playlist_result(url_results, playlist_id, title)
1154
1155     def _real_extract(self, url):
1156         # Extract playlist id
1157         mobj = re.match(self._VALID_URL, url)
1158         if mobj is None:
1159             raise ExtractorError('Invalid URL: %s' % url)
1160         playlist_id = mobj.group(1) or mobj.group(2)
1161
1162         # Check if it's a video-specific URL
1163         query_dict = compat_urlparse.parse_qs(compat_urlparse.urlparse(url).query)
1164         if 'v' in query_dict:
1165             video_id = query_dict['v'][0]
1166             if self._downloader.params.get('noplaylist'):
1167                 self.to_screen('Downloading just video %s because of --no-playlist' % video_id)
1168                 return self.url_result(video_id, 'Youtube', video_id=video_id)
1169             else:
1170                 self.to_screen('Downloading playlist %s - add --no-playlist to just download video %s' % (playlist_id, video_id))
1171
1172         if playlist_id.startswith('RD'):
1173             # Mixes require a custom extraction process
1174             return self._extract_mix(playlist_id)
1175         if playlist_id.startswith('TL'):
1176             raise ExtractorError('For downloading YouTube.com top lists, use '
1177                                  'the "yttoplist" keyword, for example "youtube-dl \'yttoplist:music:Top Tracks\'"', expected=True)
1178
1179         url = self._TEMPLATE_URL % playlist_id
1180         page = self._download_webpage(url, playlist_id)
1181         more_widget_html = content_html = page
1182
1183         # Check if the playlist exists or is private
1184         if re.search(r'<div class="yt-alert-message">[^<]*?(The|This) playlist (does not exist|is private)[^<]*?</div>', page) is not None:
1185             raise ExtractorError(
1186                 'The playlist doesn\'t exist or is private, use --username or '
1187                 '--netrc to access it.',
1188                 expected=True)
1189
1190         # Extract the video ids from the playlist pages
1191         ids = []
1192
1193         for page_num in itertools.count(1):
1194             matches = re.finditer(self._VIDEO_RE, content_html)
1195             # We remove the duplicates and the link with index 0
1196             # (it's not the first video of the playlist)
1197             new_ids = orderedSet(m.group('id') for m in matches if m.group('index') != '0')
1198             ids.extend(new_ids)
1199
1200             mobj = re.search(r'data-uix-load-more-href="/?(?P<more>[^"]+)"', more_widget_html)
1201             if not mobj:
1202                 break
1203
1204             more = self._download_json(
1205                 'https://youtube.com/%s' % mobj.group('more'), playlist_id,
1206                 'Downloading page #%s' % page_num,
1207                 transform_source=uppercase_escape)
1208             content_html = more['content_html']
1209             more_widget_html = more['load_more_widget_html']
1210
1211         playlist_title = self._html_search_regex(
1212             r'(?s)<h1 class="pl-header-title[^"]*">\s*(.*?)\s*</h1>',
1213             page, 'title')
1214
1215         url_results = self._ids_to_results(ids)
1216         return self.playlist_result(url_results, playlist_id, playlist_title)
1217
1218
1219 class YoutubeTopListIE(YoutubePlaylistIE):
1220     IE_NAME = 'youtube:toplist'
1221     IE_DESC = ('YouTube.com top lists, "yttoplist:{channel}:{list title}"'
1222                ' (Example: "yttoplist:music:Top Tracks")')
1223     _VALID_URL = r'yttoplist:(?P<chann>.*?):(?P<title>.*?)$'
1224     _TESTS = [{
1225         'url': 'yttoplist:music:Trending',
1226         'playlist_mincount': 5,
1227         'skip': 'Only works for logged-in users',
1228     }]
1229
1230     def _real_extract(self, url):
1231         mobj = re.match(self._VALID_URL, url)
1232         channel = mobj.group('chann')
1233         title = mobj.group('title')
1234         query = compat_urllib_parse.urlencode({'title': title})
1235         channel_page = self._download_webpage(
1236             'https://www.youtube.com/%s' % channel, title)
1237         link = self._html_search_regex(
1238             r'''(?x)
1239                 <a\s+href="([^"]+)".*?>\s*
1240                 <span\s+class="branded-page-module-title-text">\s*
1241                 <span[^>]*>.*?%s.*?</span>''' % re.escape(query),
1242             channel_page, 'list')
1243         url = compat_urlparse.urljoin('https://www.youtube.com/', link)
1244
1245         video_re = r'data-index="\d+".*?data-video-id="([0-9A-Za-z_-]{11})"'
1246         ids = []
1247         # sometimes the webpage doesn't contain the videos
1248         # retry until we get them
1249         for i in itertools.count(0):
1250             msg = 'Downloading Youtube mix'
1251             if i > 0:
1252                 msg += ', retry #%d' % i
1253
1254             webpage = self._download_webpage(url, title, msg)
1255             ids = orderedSet(re.findall(video_re, webpage))
1256             if ids:
1257                 break
1258         url_results = self._ids_to_results(ids)
1259         return self.playlist_result(url_results, playlist_title=title)
1260
1261
1262 class YoutubeChannelIE(InfoExtractor):
1263     IE_DESC = 'YouTube.com channels'
1264     _VALID_URL = r'https?://(?:youtu\.be|(?:\w+\.)?youtube(?:-nocookie)?\.com)/channel/(?P<id>[0-9A-Za-z_-]+)'
1265     _MORE_PAGES_INDICATOR = 'yt-uix-load-more'
1266     _MORE_PAGES_URL = 'https://www.youtube.com/c4_browse_ajax?action_load_more_videos=1&flow=list&paging=%s&view=0&sort=da&channel_id=%s'
1267     IE_NAME = 'youtube:channel'
1268     _TESTS = [{
1269         'note': 'paginated channel',
1270         'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w',
1271         'playlist_mincount': 91,
1272     }]
1273
1274     def extract_videos_from_page(self, page):
1275         ids_in_page = []
1276         for mobj in re.finditer(r'href="/watch\?v=([0-9A-Za-z_-]+)&?', page):
1277             if mobj.group(1) not in ids_in_page:
1278                 ids_in_page.append(mobj.group(1))
1279         return ids_in_page
1280
1281     def _real_extract(self, url):
1282         channel_id = self._match_id(url)
1283
1284         video_ids = []
1285         url = 'https://www.youtube.com/channel/%s/videos' % channel_id
1286         channel_page = self._download_webpage(url, channel_id)
1287         autogenerated = re.search(r'''(?x)
1288                 class="[^"]*?(?:
1289                     channel-header-autogenerated-label|
1290                     yt-channel-title-autogenerated
1291                 )[^"]*"''', channel_page) is not None
1292
1293         if autogenerated:
1294             # The videos are contained in a single page
1295             # the ajax pages can't be used, they are empty
1296             video_ids = self.extract_videos_from_page(channel_page)
1297             entries = [
1298                 self.url_result(video_id, 'Youtube', video_id=video_id)
1299                 for video_id in video_ids]
1300             return self.playlist_result(entries, channel_id)
1301
1302         def _entries():
1303             for pagenum in itertools.count(1):
1304                 url = self._MORE_PAGES_URL % (pagenum, channel_id)
1305                 page = self._download_json(
1306                     url, channel_id, note='Downloading page #%s' % pagenum,
1307                     transform_source=uppercase_escape)
1308
1309                 ids_in_page = self.extract_videos_from_page(page['content_html'])
1310                 for video_id in ids_in_page:
1311                     yield self.url_result(
1312                         video_id, 'Youtube', video_id=video_id)
1313
1314                 if self._MORE_PAGES_INDICATOR not in page['load_more_widget_html']:
1315                     break
1316
1317         return self.playlist_result(_entries(), channel_id)
1318
1319
1320 class YoutubeUserIE(InfoExtractor):
1321     IE_DESC = 'YouTube.com user videos (URL or "ytuser" keyword)'
1322     _VALID_URL = r'(?:(?:(?:https?://)?(?:\w+\.)?youtube\.com/(?:user/)?(?!(?:attribution_link|watch|results)(?:$|[^a-z_A-Z0-9-])))|ytuser:)(?!feed/)(?P<id>[A-Za-z0-9_-]+)'
1323     _TEMPLATE_URL = 'https://gdata.youtube.com/feeds/api/users/%s'
1324     _GDATA_PAGE_SIZE = 50
1325     _GDATA_URL = 'https://gdata.youtube.com/feeds/api/users/%s/uploads?max-results=%d&start-index=%d&alt=json'
1326     IE_NAME = 'youtube:user'
1327
1328     _TESTS = [{
1329         'url': 'https://www.youtube.com/user/TheLinuxFoundation',
1330         'playlist_mincount': 320,
1331         'info_dict': {
1332             'title': 'TheLinuxFoundation',
1333         }
1334     }, {
1335         'url': 'ytuser:phihag',
1336         'only_matching': True,
1337     }]
1338
1339     @classmethod
1340     def suitable(cls, url):
1341         # Don't return True if the url can be extracted with other youtube
1342         # extractor, the regex would is too permissive and it would match.
1343         other_ies = iter(klass for (name, klass) in globals().items() if name.endswith('IE') and klass is not cls)
1344         if any(ie.suitable(url) for ie in other_ies):
1345             return False
1346         else:
1347             return super(YoutubeUserIE, cls).suitable(url)
1348
1349     def _real_extract(self, url):
1350         username = self._match_id(url)
1351
1352         # Download video ids using YouTube Data API. Result size per
1353         # query is limited (currently to 50 videos) so we need to query
1354         # page by page until there are no video ids - it means we got
1355         # all of them.
1356
1357         def download_page(pagenum):
1358             start_index = pagenum * self._GDATA_PAGE_SIZE + 1
1359
1360             gdata_url = self._GDATA_URL % (username, self._GDATA_PAGE_SIZE, start_index)
1361             page = self._download_webpage(
1362                 gdata_url, username,
1363                 'Downloading video ids from %d to %d' % (
1364                     start_index, start_index + self._GDATA_PAGE_SIZE))
1365
1366             try:
1367                 response = json.loads(page)
1368             except ValueError as err:
1369                 raise ExtractorError('Invalid JSON in API response: ' + compat_str(err))
1370             if 'entry' not in response['feed']:
1371                 return
1372
1373             # Extract video identifiers
1374             entries = response['feed']['entry']
1375             for entry in entries:
1376                 title = entry['title']['$t']
1377                 video_id = entry['id']['$t'].split('/')[-1]
1378                 yield {
1379                     '_type': 'url',
1380                     'url': video_id,
1381                     'ie_key': 'Youtube',
1382                     'id': video_id,
1383                     'title': title,
1384                 }
1385         url_results = OnDemandPagedList(download_page, self._GDATA_PAGE_SIZE)
1386
1387         return self.playlist_result(url_results, playlist_title=username)
1388
1389
1390 class YoutubeSearchIE(SearchInfoExtractor):
1391     IE_DESC = 'YouTube.com searches'
1392     _API_URL = 'https://gdata.youtube.com/feeds/api/videos?q=%s&start-index=%i&max-results=50&v=2&alt=jsonc'
1393     _MAX_RESULTS = 1000
1394     IE_NAME = 'youtube:search'
1395     _SEARCH_KEY = 'ytsearch'
1396
1397     def _get_n_results(self, query, n):
1398         """Get a specified number of results for a query"""
1399
1400         video_ids = []
1401         pagenum = 0
1402         limit = n
1403         PAGE_SIZE = 50
1404
1405         while (PAGE_SIZE * pagenum) < limit:
1406             result_url = self._API_URL % (
1407                 compat_urllib_parse.quote_plus(query.encode('utf-8')),
1408                 (PAGE_SIZE * pagenum) + 1)
1409             data_json = self._download_webpage(
1410                 result_url, video_id='query "%s"' % query,
1411                 note='Downloading page %s' % (pagenum + 1),
1412                 errnote='Unable to download API page')
1413             data = json.loads(data_json)
1414             api_response = data['data']
1415
1416             if 'items' not in api_response:
1417                 raise ExtractorError(
1418                     '[youtube] No video results', expected=True)
1419
1420             new_ids = list(video['id'] for video in api_response['items'])
1421             video_ids += new_ids
1422
1423             limit = min(n, api_response['totalItems'])
1424             pagenum += 1
1425
1426         if len(video_ids) > n:
1427             video_ids = video_ids[:n]
1428         videos = [self.url_result(video_id, 'Youtube', video_id=video_id)
1429                   for video_id in video_ids]
1430         return self.playlist_result(videos, query)
1431
1432
1433 class YoutubeSearchDateIE(YoutubeSearchIE):
1434     IE_NAME = YoutubeSearchIE.IE_NAME + ':date'
1435     _API_URL = 'https://gdata.youtube.com/feeds/api/videos?q=%s&start-index=%i&max-results=50&v=2&alt=jsonc&orderby=published'
1436     _SEARCH_KEY = 'ytsearchdate'
1437     IE_DESC = 'YouTube.com searches, newest videos first'
1438
1439
1440 class YoutubeSearchURLIE(InfoExtractor):
1441     IE_DESC = 'YouTube.com search URLs'
1442     IE_NAME = 'youtube:search_url'
1443     _VALID_URL = r'https?://(?:www\.)?youtube\.com/results\?(.*?&)?search_query=(?P<query>[^&]+)(?:[&]|$)'
1444     _TESTS = [{
1445         'url': 'https://www.youtube.com/results?baz=bar&search_query=youtube-dl+test+video&filters=video&lclk=video',
1446         'playlist_mincount': 5,
1447         'info_dict': {
1448             'title': 'youtube-dl test video',
1449         }
1450     }]
1451
1452     def _real_extract(self, url):
1453         mobj = re.match(self._VALID_URL, url)
1454         query = compat_urllib_parse.unquote_plus(mobj.group('query'))
1455
1456         webpage = self._download_webpage(url, query)
1457         result_code = self._search_regex(
1458             r'(?s)<ol class="item-section"(.*?)</ol>', webpage, 'result HTML')
1459
1460         part_codes = re.findall(
1461             r'(?s)<h3 class="yt-lockup-title">(.*?)</h3>', result_code)
1462         entries = []
1463         for part_code in part_codes:
1464             part_title = self._html_search_regex(
1465                 [r'(?s)title="([^"]+)"', r'>([^<]+)</a>'], part_code, 'item title', fatal=False)
1466             part_url_snippet = self._html_search_regex(
1467                 r'(?s)href="([^"]+)"', part_code, 'item URL')
1468             part_url = compat_urlparse.urljoin(
1469                 'https://www.youtube.com/', part_url_snippet)
1470             entries.append({
1471                 '_type': 'url',
1472                 'url': part_url,
1473                 'title': part_title,
1474             })
1475
1476         return {
1477             '_type': 'playlist',
1478             'entries': entries,
1479             'title': query,
1480         }
1481
1482
1483 class YoutubeShowIE(InfoExtractor):
1484     IE_DESC = 'YouTube.com (multi-season) shows'
1485     _VALID_URL = r'https?://www\.youtube\.com/show/(?P<id>[^?#]*)'
1486     IE_NAME = 'youtube:show'
1487     _TESTS = [{
1488         'url': 'http://www.youtube.com/show/airdisasters',
1489         'playlist_mincount': 3,
1490         'info_dict': {
1491             'id': 'airdisasters',
1492             'title': 'Air Disasters',
1493         }
1494     }]
1495
1496     def _real_extract(self, url):
1497         mobj = re.match(self._VALID_URL, url)
1498         playlist_id = mobj.group('id')
1499         webpage = self._download_webpage(
1500             url, playlist_id, 'Downloading show webpage')
1501         # There's one playlist for each season of the show
1502         m_seasons = list(re.finditer(r'href="(/playlist\?list=.*?)"', webpage))
1503         self.to_screen('%s: Found %s seasons' % (playlist_id, len(m_seasons)))
1504         entries = [
1505             self.url_result(
1506                 'https://www.youtube.com' + season.group(1), 'YoutubePlaylist')
1507             for season in m_seasons
1508         ]
1509         title = self._og_search_title(webpage, fatal=False)
1510
1511         return {
1512             '_type': 'playlist',
1513             'id': playlist_id,
1514             'title': title,
1515             'entries': entries,
1516         }
1517
1518
1519 class YoutubeFeedsInfoExtractor(YoutubeBaseInfoExtractor):
1520     """
1521     Base class for extractors that fetch info from
1522     http://www.youtube.com/feed_ajax
1523     Subclasses must define the _FEED_NAME and _PLAYLIST_TITLE properties.
1524     """
1525     _LOGIN_REQUIRED = True
1526     # use action_load_personal_feed instead of action_load_system_feed
1527     _PERSONAL_FEED = False
1528
1529     @property
1530     def _FEED_TEMPLATE(self):
1531         action = 'action_load_system_feed'
1532         if self._PERSONAL_FEED:
1533             action = 'action_load_personal_feed'
1534         return 'https://www.youtube.com/feed_ajax?%s=1&feed_name=%s&paging=%%s' % (action, self._FEED_NAME)
1535
1536     @property
1537     def IE_NAME(self):
1538         return 'youtube:%s' % self._FEED_NAME
1539
1540     def _real_initialize(self):
1541         self._login()
1542
1543     def _real_extract(self, url):
1544         feed_entries = []
1545         paging = 0
1546         for i in itertools.count(1):
1547             info = self._download_json(self._FEED_TEMPLATE % paging,
1548                                        '%s feed' % self._FEED_NAME,
1549                                        'Downloading page %s' % i)
1550             feed_html = info.get('feed_html') or info.get('content_html')
1551             load_more_widget_html = info.get('load_more_widget_html') or feed_html
1552             m_ids = re.finditer(r'"/watch\?v=(.*?)["&]', feed_html)
1553             ids = orderedSet(m.group(1) for m in m_ids)
1554             feed_entries.extend(
1555                 self.url_result(video_id, 'Youtube', video_id=video_id)
1556                 for video_id in ids)
1557             mobj = re.search(
1558                 r'data-uix-load-more-href="/?[^"]+paging=(?P<paging>\d+)',
1559                 load_more_widget_html)
1560             if mobj is None:
1561                 break
1562             paging = mobj.group('paging')
1563         return self.playlist_result(feed_entries, playlist_title=self._PLAYLIST_TITLE)
1564
1565
1566 class YoutubeRecommendedIE(YoutubeFeedsInfoExtractor):
1567     IE_DESC = 'YouTube.com recommended videos, ":ytrec" for short (requires authentication)'
1568     _VALID_URL = r'https?://www\.youtube\.com/feed/recommended|:ytrec(?:ommended)?'
1569     _FEED_NAME = 'recommended'
1570     _PLAYLIST_TITLE = 'Youtube Recommended videos'
1571
1572
1573 class YoutubeWatchLaterIE(YoutubeFeedsInfoExtractor):
1574     IE_DESC = 'Youtube watch later list, ":ytwatchlater" for short (requires authentication)'
1575     _VALID_URL = r'https?://www\.youtube\.com/feed/watch_later|:ytwatchlater'
1576     _FEED_NAME = 'watch_later'
1577     _PLAYLIST_TITLE = 'Youtube Watch Later'
1578     _PERSONAL_FEED = True
1579
1580
1581 class YoutubeHistoryIE(YoutubeFeedsInfoExtractor):
1582     IE_DESC = 'Youtube watch history, ":ythistory" for short (requires authentication)'
1583     _VALID_URL = 'https?://www\.youtube\.com/feed/history|:ythistory'
1584     _FEED_NAME = 'history'
1585     _PERSONAL_FEED = True
1586     _PLAYLIST_TITLE = 'Youtube Watch History'
1587
1588
1589 class YoutubeFavouritesIE(YoutubeBaseInfoExtractor):
1590     IE_NAME = 'youtube:favorites'
1591     IE_DESC = 'YouTube.com favourite videos, ":ytfav" for short (requires authentication)'
1592     _VALID_URL = r'https?://www\.youtube\.com/my_favorites|:ytfav(?:ou?rites)?'
1593     _LOGIN_REQUIRED = True
1594
1595     def _real_extract(self, url):
1596         webpage = self._download_webpage('https://www.youtube.com/my_favorites', 'Youtube Favourites videos')
1597         playlist_id = self._search_regex(r'list=(.+?)["&]', webpage, 'favourites playlist id')
1598         return self.url_result(playlist_id, 'YoutubePlaylist')
1599
1600
1601 class YoutubeSubscriptionsIE(YoutubePlaylistIE):
1602     IE_NAME = 'youtube:subscriptions'
1603     IE_DESC = 'YouTube.com subscriptions feed, "ytsubs" keyword (requires authentication)'
1604     _VALID_URL = r'https?://www\.youtube\.com/feed/subscriptions|:ytsubs(?:criptions)?'
1605     _TESTS = []
1606
1607     def _real_extract(self, url):
1608         title = 'Youtube Subscriptions'
1609         page = self._download_webpage('https://www.youtube.com/feed/subscriptions', title)
1610
1611         # The extraction process is the same as for playlists, but the regex
1612         # for the video ids doesn't contain an index
1613         ids = []
1614         more_widget_html = content_html = page
1615
1616         for page_num in itertools.count(1):
1617             matches = re.findall(r'href="\s*/watch\?v=([0-9A-Za-z_-]{11})', content_html)
1618             new_ids = orderedSet(matches)
1619             ids.extend(new_ids)
1620
1621             mobj = re.search(r'data-uix-load-more-href="/?(?P<more>[^"]+)"', more_widget_html)
1622             if not mobj:
1623                 break
1624
1625             more = self._download_json(
1626                 'https://youtube.com/%s' % mobj.group('more'), title,
1627                 'Downloading page #%s' % page_num,
1628                 transform_source=uppercase_escape)
1629             content_html = more['content_html']
1630             more_widget_html = more['load_more_widget_html']
1631
1632         return {
1633             '_type': 'playlist',
1634             'title': title,
1635             'entries': self._ids_to_results(ids),
1636         }
1637
1638
1639 class YoutubeTruncatedURLIE(InfoExtractor):
1640     IE_NAME = 'youtube:truncated_url'
1641     IE_DESC = False  # Do not list
1642     _VALID_URL = r'''(?x)
1643         (?:https?://)?[^/]+/watch\?(?:
1644             feature=[a-z_]+|
1645             annotation_id=annotation_[^&]+
1646         )?$|
1647         (?:https?://)?(?:www\.)?youtube\.com/attribution_link\?a=[^&]+$
1648     '''
1649
1650     _TESTS = [{
1651         'url': 'http://www.youtube.com/watch?annotation_id=annotation_3951667041',
1652         'only_matching': True,
1653     }, {
1654         'url': 'http://www.youtube.com/watch?',
1655         'only_matching': True,
1656     }]
1657
1658     def _real_extract(self, url):
1659         raise ExtractorError(
1660             'Did you forget to quote the URL? Remember that & is a meta '
1661             'character in most shells, so you want to put the URL in quotes, '
1662             'like  youtube-dl '
1663             '"http://www.youtube.com/watch?feature=foo&v=BaW_jenozKc" '
1664             ' or simply  youtube-dl BaW_jenozKc  .',
1665             expected=True)