Merge pull request #8374 from yan12125/facebook-dash
[youtube-dl] / 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 ..jsinterp import JSInterpreter
15 from ..swfinterp import SWFInterpreter
16 from ..compat import (
17     compat_chr,
18     compat_parse_qs,
19     compat_urllib_parse,
20     compat_urllib_parse_unquote,
21     compat_urllib_parse_unquote_plus,
22     compat_urllib_parse_urlparse,
23     compat_urlparse,
24     compat_str,
25 )
26 from ..utils import (
27     clean_html,
28     encode_dict,
29     error_to_compat_str,
30     ExtractorError,
31     float_or_none,
32     get_element_by_attribute,
33     get_element_by_id,
34     int_or_none,
35     mimetype2ext,
36     orderedSet,
37     parse_duration,
38     remove_quotes,
39     remove_start,
40     sanitized_Request,
41     smuggle_url,
42     str_to_int,
43     unescapeHTML,
44     unified_strdate,
45     unsmuggle_url,
46     uppercase_escape,
47     ISO3166Utils,
48 )
49
50
51 class YoutubeBaseInfoExtractor(InfoExtractor):
52     """Provide base functions for Youtube extractors"""
53     _LOGIN_URL = 'https://accounts.google.com/ServiceLogin'
54     _TWOFACTOR_URL = 'https://accounts.google.com/signin/challenge'
55     _NETRC_MACHINE = 'youtube'
56     # If True it will raise an error if no login info is provided
57     _LOGIN_REQUIRED = False
58
59     def _set_language(self):
60         self._set_cookie(
61             '.youtube.com', 'PREF', 'f1=50000000&hl=en',
62             # YouTube sets the expire time to about two months
63             expire_time=time.time() + 2 * 30 * 24 * 3600)
64
65     def _ids_to_results(self, ids):
66         return [
67             self.url_result(vid_id, 'Youtube', video_id=vid_id)
68             for vid_id in ids]
69
70     def _login(self):
71         """
72         Attempt to log in to YouTube.
73         True is returned if successful or skipped.
74         False is returned if login failed.
75
76         If _LOGIN_REQUIRED is set and no authentication was provided, an error is raised.
77         """
78         (username, password) = self._get_login_info()
79         # No authentication to be performed
80         if username is None:
81             if self._LOGIN_REQUIRED:
82                 raise ExtractorError('No login info available, needed for using %s.' % self.IE_NAME, expected=True)
83             return True
84
85         login_page = self._download_webpage(
86             self._LOGIN_URL, None,
87             note='Downloading login page',
88             errnote='unable to fetch login page', fatal=False)
89         if login_page is False:
90             return
91
92         galx = self._search_regex(r'(?s)<input.+?name="GALX".+?value="(.+?)"',
93                                   login_page, 'Login GALX parameter')
94
95         # Log in
96         login_form_strs = {
97             'continue': 'https://www.youtube.com/signin?action_handle_signin=true&feature=sign_in_button&hl=en_US&nomobiletemp=1',
98             'Email': username,
99             'GALX': galx,
100             'Passwd': password,
101
102             'PersistentCookie': 'yes',
103             '_utf8': '霱',
104             'bgresponse': 'js_disabled',
105             'checkConnection': '',
106             'checkedDomains': 'youtube',
107             'dnConn': '',
108             'pstMsg': '0',
109             'rmShown': '1',
110             'secTok': '',
111             'signIn': 'Sign in',
112             'timeStmp': '',
113             'service': 'youtube',
114             'uilel': '3',
115             'hl': 'en_US',
116         }
117
118         login_data = compat_urllib_parse.urlencode(encode_dict(login_form_strs)).encode('ascii')
119
120         req = sanitized_Request(self._LOGIN_URL, login_data)
121         login_results = self._download_webpage(
122             req, None,
123             note='Logging in', errnote='unable to log in', fatal=False)
124         if login_results is False:
125             return False
126
127         if re.search(r'id="errormsg_0_Passwd"', login_results) is not None:
128             raise ExtractorError('Please use your account password and a two-factor code instead of an application-specific password.', expected=True)
129
130         # Two-Factor
131         # TODO add SMS and phone call support - these require making a request and then prompting the user
132
133         if re.search(r'(?i)<form[^>]* id="challenge"', login_results) is not None:
134             tfa_code = self._get_tfa_info('2-step verification code')
135
136             if not tfa_code:
137                 self._downloader.report_warning(
138                     'Two-factor authentication required. Provide it either interactively or with --twofactor <code>'
139                     '(Note that only TOTP (Google Authenticator App) codes work at this time.)')
140                 return False
141
142             tfa_code = remove_start(tfa_code, 'G-')
143
144             tfa_form_strs = self._form_hidden_inputs('challenge', login_results)
145
146             tfa_form_strs.update({
147                 'Pin': tfa_code,
148                 'TrustDevice': 'on',
149             })
150
151             tfa_data = compat_urllib_parse.urlencode(encode_dict(tfa_form_strs)).encode('ascii')
152
153             tfa_req = sanitized_Request(self._TWOFACTOR_URL, tfa_data)
154             tfa_results = self._download_webpage(
155                 tfa_req, None,
156                 note='Submitting TFA code', errnote='unable to submit tfa', fatal=False)
157
158             if tfa_results is False:
159                 return False
160
161             if re.search(r'(?i)<form[^>]* id="challenge"', tfa_results) is not None:
162                 self._downloader.report_warning('Two-factor code expired or invalid. Please try again, or use a one-use backup code instead.')
163                 return False
164             if re.search(r'(?i)<form[^>]* id="gaia_loginform"', tfa_results) is not None:
165                 self._downloader.report_warning('unable to log in - did the page structure change?')
166                 return False
167             if re.search(r'smsauth-interstitial-reviewsettings', tfa_results) is not None:
168                 self._downloader.report_warning('Your Google account has a security notice. Please log in on your web browser, resolve the notice, and try again.')
169                 return False
170
171         if re.search(r'(?i)<form[^>]* id="gaia_loginform"', login_results) is not None:
172             self._downloader.report_warning('unable to log in: bad username or password')
173             return False
174         return True
175
176     def _real_initialize(self):
177         if self._downloader is None:
178             return
179         self._set_language()
180         if not self._login():
181             return
182
183
184 class YoutubeEntryListBaseInfoExtractor(YoutubeBaseInfoExtractor):
185     # Extract entries from page with "Load more" button
186     def _entries(self, page, playlist_id):
187         more_widget_html = content_html = page
188         for page_num in itertools.count(1):
189             for entry in self._process_page(content_html):
190                 yield entry
191
192             mobj = re.search(r'data-uix-load-more-href="/?(?P<more>[^"]+)"', more_widget_html)
193             if not mobj:
194                 break
195
196             more = self._download_json(
197                 'https://youtube.com/%s' % mobj.group('more'), playlist_id,
198                 'Downloading page #%s' % page_num,
199                 transform_source=uppercase_escape)
200             content_html = more['content_html']
201             if not content_html.strip():
202                 # Some webpages show a "Load more" button but they don't
203                 # have more videos
204                 break
205             more_widget_html = more['load_more_widget_html']
206
207
208 class YoutubePlaylistBaseInfoExtractor(YoutubeEntryListBaseInfoExtractor):
209     def _process_page(self, content):
210         for video_id, video_title in self.extract_videos_from_page(content):
211             yield self.url_result(video_id, 'Youtube', video_id, video_title)
212
213     def extract_videos_from_page(self, page):
214         ids_in_page = []
215         titles_in_page = []
216         for mobj in re.finditer(self._VIDEO_RE, page):
217             # The link with index 0 is not the first video of the playlist (not sure if still actual)
218             if 'index' in mobj.groupdict() and mobj.group('id') == '0':
219                 continue
220             video_id = mobj.group('id')
221             video_title = unescapeHTML(mobj.group('title'))
222             if video_title:
223                 video_title = video_title.strip()
224             try:
225                 idx = ids_in_page.index(video_id)
226                 if video_title and not titles_in_page[idx]:
227                     titles_in_page[idx] = video_title
228             except ValueError:
229                 ids_in_page.append(video_id)
230                 titles_in_page.append(video_title)
231         return zip(ids_in_page, titles_in_page)
232
233
234 class YoutubePlaylistsBaseInfoExtractor(YoutubeEntryListBaseInfoExtractor):
235     def _process_page(self, content):
236         for playlist_id in orderedSet(re.findall(r'href="/?playlist\?list=([0-9A-Za-z-_]{10,})"', content)):
237             yield self.url_result(
238                 'https://www.youtube.com/playlist?list=%s' % playlist_id, 'YoutubePlaylist')
239
240     def _real_extract(self, url):
241         playlist_id = self._match_id(url)
242         webpage = self._download_webpage(url, playlist_id)
243         title = self._og_search_title(webpage, fatal=False)
244         return self.playlist_result(self._entries(webpage, playlist_id), playlist_id, title)
245
246
247 class YoutubeIE(YoutubeBaseInfoExtractor):
248     IE_DESC = 'YouTube.com'
249     _VALID_URL = r"""(?x)^
250                      (
251                          (?:https?://|//)                                    # http(s):// or protocol-independent URL
252                          (?:(?:(?:(?:\w+\.)?[yY][oO][uU][tT][uU][bB][eE](?:-nocookie)?\.com/|
253                             (?:www\.)?deturl\.com/www\.youtube\.com/|
254                             (?:www\.)?pwnyoutube\.com/|
255                             (?:www\.)?yourepeat\.com/|
256                             tube\.majestyc\.net/|
257                             youtube\.googleapis\.com/)                        # the various hostnames, with wildcard subdomains
258                          (?:.*?\#/)?                                          # handle anchor (#/) redirect urls
259                          (?:                                                  # the various things that can precede the ID:
260                              (?:(?:v|embed|e)/(?!videoseries))                # v/ or embed/ or e/
261                              |(?:                                             # or the v= param in all its forms
262                                  (?:(?:watch|movie)(?:_popup)?(?:\.php)?/?)?  # preceding watch(_popup|.php) or nothing (like /?v=xxxx)
263                                  (?:\?|\#!?)                                  # the params delimiter ? or # or #!
264                                  (?:.*?[&;])??                                # any other preceding param (like /?s=tuff&v=xxxx or ?s=tuff&amp;v=V36LpHqtcDY)
265                                  v=
266                              )
267                          ))
268                          |(?:
269                             youtu\.be|                                        # just youtu.be/xxxx
270                             vid\.plus                                         # or vid.plus/xxxx
271                          )/
272                          |(?:www\.)?cleanvideosearch\.com/media/action/yt/watch\?videoId=
273                          )
274                      )?                                                       # all until now is optional -> you can pass the naked ID
275                      ([0-9A-Za-z_-]{11})                                      # here is it! the YouTube video ID
276                      (?!.*?&list=)                                            # combined list/video URLs are handled by the playlist IE
277                      (?(1).+)?                                                # if we found the ID, everything can follow
278                      $"""
279     _NEXT_URL_RE = r'[\?&]next_url=([^&]+)'
280     _formats = {
281         '5': {'ext': 'flv', 'width': 400, 'height': 240, 'acodec': 'mp3', 'abr': 64, 'vcodec': 'h263'},
282         '6': {'ext': 'flv', 'width': 450, 'height': 270, 'acodec': 'mp3', 'abr': 64, 'vcodec': 'h263'},
283         '13': {'ext': '3gp', 'acodec': 'aac', 'vcodec': 'mp4v'},
284         '17': {'ext': '3gp', 'width': 176, 'height': 144, 'acodec': 'aac', 'abr': 24, 'vcodec': 'mp4v'},
285         '18': {'ext': 'mp4', 'width': 640, 'height': 360, 'acodec': 'aac', 'abr': 96, 'vcodec': 'h264'},
286         '22': {'ext': 'mp4', 'width': 1280, 'height': 720, 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264'},
287         '34': {'ext': 'flv', 'width': 640, 'height': 360, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
288         '35': {'ext': 'flv', 'width': 854, 'height': 480, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
289         '36': {'ext': '3gp', 'width': 320, 'height': 240, 'acodec': 'aac', 'abr': 32, 'vcodec': 'mp4v'},
290         '37': {'ext': 'mp4', 'width': 1920, 'height': 1080, 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264'},
291         '38': {'ext': 'mp4', 'width': 4096, 'height': 3072, 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264'},
292         '43': {'ext': 'webm', 'width': 640, 'height': 360, 'acodec': 'vorbis', 'abr': 128, 'vcodec': 'vp8'},
293         '44': {'ext': 'webm', 'width': 854, 'height': 480, 'acodec': 'vorbis', 'abr': 128, 'vcodec': 'vp8'},
294         '45': {'ext': 'webm', 'width': 1280, 'height': 720, 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8'},
295         '46': {'ext': 'webm', 'width': 1920, 'height': 1080, 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8'},
296         '59': {'ext': 'mp4', 'width': 854, 'height': 480, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
297         '78': {'ext': 'mp4', 'width': 854, 'height': 480, 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264'},
298
299
300         # 3D videos
301         '82': {'ext': 'mp4', 'height': 360, 'format_note': '3D', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -20},
302         '83': {'ext': 'mp4', 'height': 480, 'format_note': '3D', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -20},
303         '84': {'ext': 'mp4', 'height': 720, 'format_note': '3D', 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264', 'preference': -20},
304         '85': {'ext': 'mp4', 'height': 1080, 'format_note': '3D', 'acodec': 'aac', 'abr': 192, 'vcodec': 'h264', 'preference': -20},
305         '100': {'ext': 'webm', 'height': 360, 'format_note': '3D', 'acodec': 'vorbis', 'abr': 128, 'vcodec': 'vp8', 'preference': -20},
306         '101': {'ext': 'webm', 'height': 480, 'format_note': '3D', 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8', 'preference': -20},
307         '102': {'ext': 'webm', 'height': 720, 'format_note': '3D', 'acodec': 'vorbis', 'abr': 192, 'vcodec': 'vp8', 'preference': -20},
308
309         # Apple HTTP Live Streaming
310         '92': {'ext': 'mp4', 'height': 240, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 48, 'vcodec': 'h264', 'preference': -10},
311         '93': {'ext': 'mp4', 'height': 360, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -10},
312         '94': {'ext': 'mp4', 'height': 480, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 128, 'vcodec': 'h264', 'preference': -10},
313         '95': {'ext': 'mp4', 'height': 720, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 256, 'vcodec': 'h264', 'preference': -10},
314         '96': {'ext': 'mp4', 'height': 1080, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 256, 'vcodec': 'h264', 'preference': -10},
315         '132': {'ext': 'mp4', 'height': 240, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 48, 'vcodec': 'h264', 'preference': -10},
316         '151': {'ext': 'mp4', 'height': 72, 'format_note': 'HLS', 'acodec': 'aac', 'abr': 24, 'vcodec': 'h264', 'preference': -10},
317
318         # DASH mp4 video
319         '133': {'ext': 'mp4', 'height': 240, 'format_note': 'DASH video', 'vcodec': 'h264', 'preference': -40},
320         '134': {'ext': 'mp4', 'height': 360, 'format_note': 'DASH video', 'vcodec': 'h264', 'preference': -40},
321         '135': {'ext': 'mp4', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'h264', 'preference': -40},
322         '136': {'ext': 'mp4', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'h264', 'preference': -40},
323         '137': {'ext': 'mp4', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'h264', 'preference': -40},
324         '138': {'ext': 'mp4', 'format_note': 'DASH video', 'vcodec': 'h264', 'preference': -40},  # Height can vary (https://github.com/rg3/youtube-dl/issues/4559)
325         '160': {'ext': 'mp4', 'height': 144, 'format_note': 'DASH video', 'vcodec': 'h264', 'preference': -40},
326         '264': {'ext': 'mp4', 'height': 1440, 'format_note': 'DASH video', 'vcodec': 'h264', 'preference': -40},
327         '298': {'ext': 'mp4', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'h264', 'fps': 60, 'preference': -40},
328         '299': {'ext': 'mp4', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'h264', 'fps': 60, 'preference': -40},
329         '266': {'ext': 'mp4', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'h264', 'preference': -40},
330
331         # Dash mp4 audio
332         '139': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'abr': 48, 'preference': -50, 'container': 'm4a_dash'},
333         '140': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'abr': 128, 'preference': -50, 'container': 'm4a_dash'},
334         '141': {'ext': 'm4a', 'format_note': 'DASH audio', 'acodec': 'aac', 'abr': 256, 'preference': -50, 'container': 'm4a_dash'},
335
336         # Dash webm
337         '167': {'ext': 'webm', 'height': 360, 'width': 640, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8', 'preference': -40},
338         '168': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8', 'preference': -40},
339         '169': {'ext': 'webm', 'height': 720, 'width': 1280, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8', 'preference': -40},
340         '170': {'ext': 'webm', 'height': 1080, 'width': 1920, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8', 'preference': -40},
341         '218': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8', 'preference': -40},
342         '219': {'ext': 'webm', 'height': 480, 'width': 854, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp8', 'preference': -40},
343         '278': {'ext': 'webm', 'height': 144, 'format_note': 'DASH video', 'container': 'webm', 'vcodec': 'vp9', 'preference': -40},
344         '242': {'ext': 'webm', 'height': 240, 'format_note': 'DASH video', 'vcodec': 'vp9', 'preference': -40},
345         '243': {'ext': 'webm', 'height': 360, 'format_note': 'DASH video', 'vcodec': 'vp9', 'preference': -40},
346         '244': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'vp9', 'preference': -40},
347         '245': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'vp9', 'preference': -40},
348         '246': {'ext': 'webm', 'height': 480, 'format_note': 'DASH video', 'vcodec': 'vp9', 'preference': -40},
349         '247': {'ext': 'webm', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'vp9', 'preference': -40},
350         '248': {'ext': 'webm', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'vp9', 'preference': -40},
351         '271': {'ext': 'webm', 'height': 1440, 'format_note': 'DASH video', 'vcodec': 'vp9', 'preference': -40},
352         # itag 272 videos are either 3840x2160 (e.g. RtoitU2A-3E) or 7680x4320 (sLprVF6d7Ug)
353         '272': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'vp9', 'preference': -40},
354         '302': {'ext': 'webm', 'height': 720, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60, 'preference': -40},
355         '303': {'ext': 'webm', 'height': 1080, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60, 'preference': -40},
356         '308': {'ext': 'webm', 'height': 1440, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60, 'preference': -40},
357         '313': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'vp9', 'preference': -40},
358         '315': {'ext': 'webm', 'height': 2160, 'format_note': 'DASH video', 'vcodec': 'vp9', 'fps': 60, 'preference': -40},
359
360         # Dash webm audio
361         '171': {'ext': 'webm', 'acodec': 'vorbis', 'format_note': 'DASH audio', 'abr': 128, 'preference': -50},
362         '172': {'ext': 'webm', 'acodec': 'vorbis', 'format_note': 'DASH audio', 'abr': 256, 'preference': -50},
363
364         # Dash webm audio with opus inside
365         '249': {'ext': 'webm', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 50, 'preference': -50},
366         '250': {'ext': 'webm', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 70, 'preference': -50},
367         '251': {'ext': 'webm', 'format_note': 'DASH audio', 'acodec': 'opus', 'abr': 160, 'preference': -50},
368
369         # RTMP (unnamed)
370         '_rtmp': {'protocol': 'rtmp'},
371     }
372
373     IE_NAME = 'youtube'
374     _TESTS = [
375         {
376             'url': 'http://www.youtube.com/watch?v=BaW_jenozKcj&t=1s&end=9',
377             'info_dict': {
378                 'id': 'BaW_jenozKc',
379                 'ext': 'mp4',
380                 'title': 'youtube-dl test video "\'/\\ä↭𝕐',
381                 'uploader': 'Philipp Hagemeister',
382                 'uploader_id': 'phihag',
383                 'upload_date': '20121002',
384                 '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 .',
385                 'categories': ['Science & Technology'],
386                 'tags': ['youtube-dl'],
387                 'like_count': int,
388                 'dislike_count': int,
389                 'start_time': 1,
390                 'end_time': 9,
391             }
392         },
393         {
394             'url': 'http://www.youtube.com/watch?v=UxxajLWwzqY',
395             'note': 'Test generic use_cipher_signature video (#897)',
396             'info_dict': {
397                 'id': 'UxxajLWwzqY',
398                 'ext': 'mp4',
399                 'upload_date': '20120506',
400                 'title': 'Icona Pop - I Love It (feat. Charli XCX) [OFFICIAL VIDEO]',
401                 'alt_title': 'I Love It (feat. Charli XCX)',
402                 'description': 'md5:782e8651347686cba06e58f71ab51773',
403                 'tags': ['Icona Pop i love it', 'sweden', 'pop music', 'big beat records', 'big beat', 'charli',
404                          'xcx', 'charli xcx', 'girls', 'hbo', 'i love it', "i don't care", 'icona', 'pop',
405                          'iconic ep', 'iconic', 'love', 'it'],
406                 'uploader': 'Icona Pop',
407                 'uploader_id': 'IconaPop',
408                 'creator': 'Icona Pop',
409             }
410         },
411         {
412             'url': 'https://www.youtube.com/watch?v=07FYdnEawAQ',
413             'note': 'Test VEVO video with age protection (#956)',
414             'info_dict': {
415                 'id': '07FYdnEawAQ',
416                 'ext': 'mp4',
417                 'upload_date': '20130703',
418                 'title': 'Justin Timberlake - Tunnel Vision (Explicit)',
419                 'alt_title': 'Tunnel Vision',
420                 'description': 'md5:64249768eec3bc4276236606ea996373',
421                 'uploader': 'justintimberlakeVEVO',
422                 'uploader_id': 'justintimberlakeVEVO',
423                 'creator': 'Justin Timberlake',
424                 'age_limit': 18,
425             }
426         },
427         {
428             'url': '//www.YouTube.com/watch?v=yZIXLfi8CZQ',
429             'note': 'Embed-only video (#1746)',
430             'info_dict': {
431                 'id': 'yZIXLfi8CZQ',
432                 'ext': 'mp4',
433                 'upload_date': '20120608',
434                 'title': 'Principal Sexually Assaults A Teacher - Episode 117 - 8th June 2012',
435                 'description': 'md5:09b78bd971f1e3e289601dfba15ca4f7',
436                 'uploader': 'SET India',
437                 'uploader_id': 'setindia',
438                 'age_limit': 18,
439             }
440         },
441         {
442             'url': 'http://www.youtube.com/watch?v=BaW_jenozKcj&v=UxxajLWwzqY',
443             'note': 'Use the first video ID in the URL',
444             'info_dict': {
445                 'id': 'BaW_jenozKc',
446                 'ext': 'mp4',
447                 'title': 'youtube-dl test video "\'/\\ä↭𝕐',
448                 'uploader': 'Philipp Hagemeister',
449                 'uploader_id': 'phihag',
450                 'upload_date': '20121002',
451                 '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 .',
452                 'categories': ['Science & Technology'],
453                 'tags': ['youtube-dl'],
454                 'like_count': int,
455                 'dislike_count': int,
456             },
457             'params': {
458                 'skip_download': True,
459             },
460         },
461         {
462             'url': 'http://www.youtube.com/watch?v=a9LDPn-MO4I',
463             'note': '256k DASH audio (format 141) via DASH manifest',
464             'info_dict': {
465                 'id': 'a9LDPn-MO4I',
466                 'ext': 'm4a',
467                 'upload_date': '20121002',
468                 'uploader_id': '8KVIDEO',
469                 'description': '',
470                 'uploader': '8KVIDEO',
471                 'title': 'UHDTV TEST 8K VIDEO.mp4'
472             },
473             'params': {
474                 'youtube_include_dash_manifest': True,
475                 'format': '141',
476             },
477         },
478         # DASH manifest with encrypted signature
479         {
480             'url': 'https://www.youtube.com/watch?v=IB3lcPjvWLA',
481             'info_dict': {
482                 'id': 'IB3lcPjvWLA',
483                 'ext': 'm4a',
484                 'title': 'Afrojack, Spree Wilson - The Spark ft. Spree Wilson',
485                 'description': 'md5:12e7067fa6735a77bdcbb58cb1187d2d',
486                 'uploader': 'AfrojackVEVO',
487                 'uploader_id': 'AfrojackVEVO',
488                 'upload_date': '20131011',
489             },
490             'params': {
491                 'youtube_include_dash_manifest': True,
492                 'format': '141',
493             },
494         },
495         # JS player signature function name containing $
496         {
497             'url': 'https://www.youtube.com/watch?v=nfWlot6h_JM',
498             'info_dict': {
499                 'id': 'nfWlot6h_JM',
500                 'ext': 'm4a',
501                 'title': 'Taylor Swift - Shake It Off',
502                 'alt_title': 'Shake It Off',
503                 'description': 'md5:95f66187cd7c8b2c13eb78e1223b63c3',
504                 'uploader': 'TaylorSwiftVEVO',
505                 'uploader_id': 'TaylorSwiftVEVO',
506                 'upload_date': '20140818',
507                 'creator': 'Taylor Swift',
508             },
509             'params': {
510                 'youtube_include_dash_manifest': True,
511                 'format': '141',
512             },
513         },
514         # Controversy video
515         {
516             'url': 'https://www.youtube.com/watch?v=T4XJQO3qol8',
517             'info_dict': {
518                 'id': 'T4XJQO3qol8',
519                 'ext': 'mp4',
520                 'upload_date': '20100909',
521                 'uploader': 'The Amazing Atheist',
522                 'uploader_id': 'TheAmazingAtheist',
523                 'title': 'Burning Everyone\'s Koran',
524                 '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',
525             }
526         },
527         # Normal age-gate video (No vevo, embed allowed)
528         {
529             'url': 'http://youtube.com/watch?v=HtVdAasjOgU',
530             'info_dict': {
531                 'id': 'HtVdAasjOgU',
532                 'ext': 'mp4',
533                 'title': 'The Witcher 3: Wild Hunt - The Sword Of Destiny Trailer',
534                 'description': 're:(?s).{100,}About the Game\n.*?The Witcher 3: Wild Hunt.{100,}',
535                 'uploader': 'The Witcher',
536                 'uploader_id': 'WitcherGame',
537                 'upload_date': '20140605',
538                 'age_limit': 18,
539             },
540         },
541         # Age-gate video with encrypted signature
542         {
543             'url': 'http://www.youtube.com/watch?v=6kLq3WMV1nU',
544             'info_dict': {
545                 'id': '6kLq3WMV1nU',
546                 'ext': 'mp4',
547                 'title': 'Dedication To My Ex (Miss That) (Lyric Video)',
548                 'description': 'md5:33765bb339e1b47e7e72b5490139bb41',
549                 'uploader': 'LloydVEVO',
550                 'uploader_id': 'LloydVEVO',
551                 'upload_date': '20110629',
552                 'age_limit': 18,
553             },
554         },
555         # video_info is None (https://github.com/rg3/youtube-dl/issues/4421)
556         {
557             'url': '__2ABJjxzNo',
558             'info_dict': {
559                 'id': '__2ABJjxzNo',
560                 'ext': 'mp4',
561                 'upload_date': '20100430',
562                 'uploader_id': 'deadmau5',
563                 'creator': 'deadmau5',
564                 'description': 'md5:12c56784b8032162bb936a5f76d55360',
565                 'uploader': 'deadmau5',
566                 'title': 'Deadmau5 - Some Chords (HD)',
567                 'alt_title': 'Some Chords',
568             },
569             'expected_warnings': [
570                 'DASH manifest missing',
571             ]
572         },
573         # Olympics (https://github.com/rg3/youtube-dl/issues/4431)
574         {
575             'url': 'lqQg6PlCWgI',
576             'info_dict': {
577                 'id': 'lqQg6PlCWgI',
578                 'ext': 'mp4',
579                 'upload_date': '20150827',
580                 'uploader_id': 'olympic',
581                 'description': 'HO09  - Women -  GER-AUS - Hockey - 31 July 2012 - London 2012 Olympic Games',
582                 'uploader': 'Olympics',
583                 'title': 'Hockey - Women -  GER-AUS - London 2012 Olympic Games',
584             },
585             'params': {
586                 'skip_download': 'requires avconv',
587             }
588         },
589         # Non-square pixels
590         {
591             'url': 'https://www.youtube.com/watch?v=_b-2C3KPAM0',
592             'info_dict': {
593                 'id': '_b-2C3KPAM0',
594                 'ext': 'mp4',
595                 'stretched_ratio': 16 / 9.,
596                 'upload_date': '20110310',
597                 'uploader_id': 'AllenMeow',
598                 'description': 'made by Wacom from Korea | 字幕&加油添醋 by TY\'s Allen | 感謝heylisa00cavey1001同學熱情提供梗及翻譯',
599                 'uploader': '孫艾倫',
600                 'title': '[A-made] 變態妍字幕版 太妍 我就是這樣的人',
601             },
602         },
603         # url_encoded_fmt_stream_map is empty string
604         {
605             'url': 'qEJwOuvDf7I',
606             'info_dict': {
607                 'id': 'qEJwOuvDf7I',
608                 'ext': 'webm',
609                 'title': 'Обсуждение судебной практики по выборам 14 сентября 2014 года в Санкт-Петербурге',
610                 'description': '',
611                 'upload_date': '20150404',
612                 'uploader_id': 'spbelect',
613                 'uploader': 'Наблюдатели Петербурга',
614             },
615             'params': {
616                 'skip_download': 'requires avconv',
617             },
618             'skip': 'This live event has ended.',
619         },
620         # Extraction from multiple DASH manifests (https://github.com/rg3/youtube-dl/pull/6097)
621         {
622             'url': 'https://www.youtube.com/watch?v=FIl7x6_3R5Y',
623             'info_dict': {
624                 'id': 'FIl7x6_3R5Y',
625                 'ext': 'mp4',
626                 'title': 'md5:7b81415841e02ecd4313668cde88737a',
627                 'description': 'md5:116377fd2963b81ec4ce64b542173306',
628                 'upload_date': '20150625',
629                 'uploader_id': 'dorappi2000',
630                 'uploader': 'dorappi2000',
631                 'formats': 'mincount:33',
632             },
633         },
634         # DASH manifest with segment_list
635         {
636             'url': 'https://www.youtube.com/embed/CsmdDsKjzN8',
637             'md5': '8ce563a1d667b599d21064e982ab9e31',
638             'info_dict': {
639                 'id': 'CsmdDsKjzN8',
640                 'ext': 'mp4',
641                 'upload_date': '20150501',  # According to '<meta itemprop="datePublished"', but in other places it's 20150510
642                 'uploader': 'Airtek',
643                 'description': 'Retransmisión en directo de la XVIII media maratón de Zaragoza.',
644                 'uploader_id': 'UCzTzUmjXxxacNnL8I3m4LnQ',
645                 'title': 'Retransmisión XVIII Media maratón Zaragoza 2015',
646             },
647             'params': {
648                 'youtube_include_dash_manifest': True,
649                 'format': '135',  # bestvideo
650             }
651         },
652         {
653             # Multifeed videos (multiple cameras), URL is for Main Camera
654             'url': 'https://www.youtube.com/watch?v=jqWvoWXjCVs',
655             'info_dict': {
656                 'id': 'jqWvoWXjCVs',
657                 'title': 'teamPGP: Rocket League Noob Stream',
658                 'description': 'md5:dc7872fb300e143831327f1bae3af010',
659             },
660             'playlist': [{
661                 'info_dict': {
662                     'id': 'jqWvoWXjCVs',
663                     'ext': 'mp4',
664                     'title': 'teamPGP: Rocket League Noob Stream (Main Camera)',
665                     'description': 'md5:dc7872fb300e143831327f1bae3af010',
666                     'upload_date': '20150721',
667                     'uploader': 'Beer Games Beer',
668                     'uploader_id': 'beergamesbeer',
669                 },
670             }, {
671                 'info_dict': {
672                     'id': '6h8e8xoXJzg',
673                     'ext': 'mp4',
674                     'title': 'teamPGP: Rocket League Noob Stream (kreestuh)',
675                     'description': 'md5:dc7872fb300e143831327f1bae3af010',
676                     'upload_date': '20150721',
677                     'uploader': 'Beer Games Beer',
678                     'uploader_id': 'beergamesbeer',
679                 },
680             }, {
681                 'info_dict': {
682                     'id': 'PUOgX5z9xZw',
683                     'ext': 'mp4',
684                     'title': 'teamPGP: Rocket League Noob Stream (grizzle)',
685                     'description': 'md5:dc7872fb300e143831327f1bae3af010',
686                     'upload_date': '20150721',
687                     'uploader': 'Beer Games Beer',
688                     'uploader_id': 'beergamesbeer',
689                 },
690             }, {
691                 'info_dict': {
692                     'id': 'teuwxikvS5k',
693                     'ext': 'mp4',
694                     'title': 'teamPGP: Rocket League Noob Stream (zim)',
695                     'description': 'md5:dc7872fb300e143831327f1bae3af010',
696                     'upload_date': '20150721',
697                     'uploader': 'Beer Games Beer',
698                     'uploader_id': 'beergamesbeer',
699                 },
700             }],
701             'params': {
702                 'skip_download': True,
703             },
704         },
705         {
706             'url': 'http://vid.plus/FlRa-iH7PGw',
707             'only_matching': True,
708         },
709         {
710             # Title with JS-like syntax "};" (see https://github.com/rg3/youtube-dl/issues/7468)
711             # Also tests cut-off URL expansion in video description (see
712             # https://github.com/rg3/youtube-dl/issues/1892,
713             # https://github.com/rg3/youtube-dl/issues/8164)
714             'url': 'https://www.youtube.com/watch?v=lsguqyKfVQg',
715             'info_dict': {
716                 'id': 'lsguqyKfVQg',
717                 'ext': 'mp4',
718                 'title': '{dark walk}; Loki/AC/Dishonored; collab w/Elflover21',
719                 'alt_title': 'Dark Walk',
720                 'description': 'md5:8085699c11dc3f597ce0410b0dcbb34a',
721                 'upload_date': '20151119',
722                 'uploader_id': 'IronSoulElf',
723                 'uploader': 'IronSoulElf',
724                 'creator': 'Todd Haberman, Daniel Law Heath & Aaron Kaplan',
725             },
726             'params': {
727                 'skip_download': True,
728             },
729         },
730         {
731             # Tags with '};' (see https://github.com/rg3/youtube-dl/issues/7468)
732             'url': 'https://www.youtube.com/watch?v=Ms7iBXnlUO8',
733             'only_matching': True,
734         },
735         {
736             # Video with yt:stretch=17:0
737             'url': 'https://www.youtube.com/watch?v=Q39EVAstoRM',
738             'info_dict': {
739                 'id': 'Q39EVAstoRM',
740                 'ext': 'mp4',
741                 'title': 'Clash Of Clans#14 Dicas De Ataque Para CV 4',
742                 'description': 'md5:ee18a25c350637c8faff806845bddee9',
743                 'upload_date': '20151107',
744                 'uploader_id': 'UCCr7TALkRbo3EtFzETQF1LA',
745                 'uploader': 'CH GAMER DROID',
746             },
747             'params': {
748                 'skip_download': True,
749             },
750         },
751         {
752             'url': 'https://www.youtube.com/watch?feature=player_embedded&amp;amp;v=V36LpHqtcDY',
753             'only_matching': True,
754         }
755     ]
756
757     def __init__(self, *args, **kwargs):
758         super(YoutubeIE, self).__init__(*args, **kwargs)
759         self._player_cache = {}
760
761     def report_video_info_webpage_download(self, video_id):
762         """Report attempt to download video info webpage."""
763         self.to_screen('%s: Downloading video info webpage' % video_id)
764
765     def report_information_extraction(self, video_id):
766         """Report attempt to extract video information."""
767         self.to_screen('%s: Extracting video information' % video_id)
768
769     def report_unavailable_format(self, video_id, format):
770         """Report extracted video URL."""
771         self.to_screen('%s: Format %s not available' % (video_id, format))
772
773     def report_rtmp_download(self):
774         """Indicate the download will use the RTMP protocol."""
775         self.to_screen('RTMP download detected')
776
777     def _signature_cache_id(self, example_sig):
778         """ Return a string representation of a signature """
779         return '.'.join(compat_str(len(part)) for part in example_sig.split('.'))
780
781     def _extract_signature_function(self, video_id, player_url, example_sig):
782         id_m = re.match(
783             r'.*?-(?P<id>[a-zA-Z0-9_-]+)(?:/watch_as3|/html5player(?:-new)?|/base)?\.(?P<ext>[a-z]+)$',
784             player_url)
785         if not id_m:
786             raise ExtractorError('Cannot identify player %r' % player_url)
787         player_type = id_m.group('ext')
788         player_id = id_m.group('id')
789
790         # Read from filesystem cache
791         func_id = '%s_%s_%s' % (
792             player_type, player_id, self._signature_cache_id(example_sig))
793         assert os.path.basename(func_id) == func_id
794
795         cache_spec = self._downloader.cache.load('youtube-sigfuncs', func_id)
796         if cache_spec is not None:
797             return lambda s: ''.join(s[i] for i in cache_spec)
798
799         download_note = (
800             'Downloading player %s' % player_url
801             if self._downloader.params.get('verbose') else
802             'Downloading %s player %s' % (player_type, player_id)
803         )
804         if player_type == 'js':
805             code = self._download_webpage(
806                 player_url, video_id,
807                 note=download_note,
808                 errnote='Download of %s failed' % player_url)
809             res = self._parse_sig_js(code)
810         elif player_type == 'swf':
811             urlh = self._request_webpage(
812                 player_url, video_id,
813                 note=download_note,
814                 errnote='Download of %s failed' % player_url)
815             code = urlh.read()
816             res = self._parse_sig_swf(code)
817         else:
818             assert False, 'Invalid player type %r' % player_type
819
820         test_string = ''.join(map(compat_chr, range(len(example_sig))))
821         cache_res = res(test_string)
822         cache_spec = [ord(c) for c in cache_res]
823
824         self._downloader.cache.store('youtube-sigfuncs', func_id, cache_spec)
825         return res
826
827     def _print_sig_code(self, func, example_sig):
828         def gen_sig_code(idxs):
829             def _genslice(start, end, step):
830                 starts = '' if start == 0 else str(start)
831                 ends = (':%d' % (end + step)) if end + step >= 0 else ':'
832                 steps = '' if step == 1 else (':%d' % step)
833                 return 's[%s%s%s]' % (starts, ends, steps)
834
835             step = None
836             # Quelch pyflakes warnings - start will be set when step is set
837             start = '(Never used)'
838             for i, prev in zip(idxs[1:], idxs[:-1]):
839                 if step is not None:
840                     if i - prev == step:
841                         continue
842                     yield _genslice(start, prev, step)
843                     step = None
844                     continue
845                 if i - prev in [-1, 1]:
846                     step = i - prev
847                     start = prev
848                     continue
849                 else:
850                     yield 's[%d]' % prev
851             if step is None:
852                 yield 's[%d]' % i
853             else:
854                 yield _genslice(start, i, step)
855
856         test_string = ''.join(map(compat_chr, range(len(example_sig))))
857         cache_res = func(test_string)
858         cache_spec = [ord(c) for c in cache_res]
859         expr_code = ' + '.join(gen_sig_code(cache_spec))
860         signature_id_tuple = '(%s)' % (
861             ', '.join(compat_str(len(p)) for p in example_sig.split('.')))
862         code = ('if tuple(len(p) for p in s.split(\'.\')) == %s:\n'
863                 '    return %s\n') % (signature_id_tuple, expr_code)
864         self.to_screen('Extracted signature function:\n' + code)
865
866     def _parse_sig_js(self, jscode):
867         funcname = self._search_regex(
868             r'\.sig\|\|([a-zA-Z0-9$]+)\(', jscode,
869             'Initial JS player signature function name')
870
871         jsi = JSInterpreter(jscode)
872         initial_function = jsi.extract_function(funcname)
873         return lambda s: initial_function([s])
874
875     def _parse_sig_swf(self, file_contents):
876         swfi = SWFInterpreter(file_contents)
877         TARGET_CLASSNAME = 'SignatureDecipher'
878         searched_class = swfi.extract_class(TARGET_CLASSNAME)
879         initial_function = swfi.extract_function(searched_class, 'decipher')
880         return lambda s: initial_function([s])
881
882     def _decrypt_signature(self, s, video_id, player_url, age_gate=False):
883         """Turn the encrypted s field into a working signature"""
884
885         if player_url is None:
886             raise ExtractorError('Cannot decrypt signature without player_url')
887
888         if player_url.startswith('//'):
889             player_url = 'https:' + player_url
890         try:
891             player_id = (player_url, self._signature_cache_id(s))
892             if player_id not in self._player_cache:
893                 func = self._extract_signature_function(
894                     video_id, player_url, s
895                 )
896                 self._player_cache[player_id] = func
897             func = self._player_cache[player_id]
898             if self._downloader.params.get('youtube_print_sig_code'):
899                 self._print_sig_code(func, s)
900             return func(s)
901         except Exception as e:
902             tb = traceback.format_exc()
903             raise ExtractorError(
904                 'Signature extraction failed: ' + tb, cause=e)
905
906     def _get_subtitles(self, video_id, webpage):
907         try:
908             subs_doc = self._download_xml(
909                 'https://video.google.com/timedtext?hl=en&type=list&v=%s' % video_id,
910                 video_id, note=False)
911         except ExtractorError as err:
912             self._downloader.report_warning('unable to download video subtitles: %s' % error_to_compat_str(err))
913             return {}
914
915         sub_lang_list = {}
916         for track in subs_doc.findall('track'):
917             lang = track.attrib['lang_code']
918             if lang in sub_lang_list:
919                 continue
920             sub_formats = []
921             for ext in ['sbv', 'vtt', 'srt']:
922                 params = compat_urllib_parse.urlencode({
923                     'lang': lang,
924                     'v': video_id,
925                     'fmt': ext,
926                     'name': track.attrib['name'].encode('utf-8'),
927                 })
928                 sub_formats.append({
929                     'url': 'https://www.youtube.com/api/timedtext?' + params,
930                     'ext': ext,
931                 })
932             sub_lang_list[lang] = sub_formats
933         if not sub_lang_list:
934             self._downloader.report_warning('video doesn\'t have subtitles')
935             return {}
936         return sub_lang_list
937
938     def _get_ytplayer_config(self, video_id, webpage):
939         patterns = (
940             # User data may contain arbitrary character sequences that may affect
941             # JSON extraction with regex, e.g. when '};' is contained the second
942             # regex won't capture the whole JSON. Yet working around by trying more
943             # concrete regex first keeping in mind proper quoted string handling
944             # to be implemented in future that will replace this workaround (see
945             # https://github.com/rg3/youtube-dl/issues/7468,
946             # https://github.com/rg3/youtube-dl/pull/7599)
947             r';ytplayer\.config\s*=\s*({.+?});ytplayer',
948             r';ytplayer\.config\s*=\s*({.+?});',
949         )
950         config = self._search_regex(
951             patterns, webpage, 'ytplayer.config', default=None)
952         if config:
953             return self._parse_json(
954                 uppercase_escape(config), video_id, fatal=False)
955
956     def _get_automatic_captions(self, video_id, webpage):
957         """We need the webpage for getting the captions url, pass it as an
958            argument to speed up the process."""
959         self.to_screen('%s: Looking for automatic captions' % video_id)
960         player_config = self._get_ytplayer_config(video_id, webpage)
961         err_msg = 'Couldn\'t find automatic captions for %s' % video_id
962         if not player_config:
963             self._downloader.report_warning(err_msg)
964             return {}
965         try:
966             args = player_config['args']
967             caption_url = args['ttsurl']
968             if not caption_url:
969                 self._downloader.report_warning(err_msg)
970                 return {}
971             timestamp = args['timestamp']
972             # We get the available subtitles
973             list_params = compat_urllib_parse.urlencode({
974                 'type': 'list',
975                 'tlangs': 1,
976                 'asrs': 1,
977             })
978             list_url = caption_url + '&' + list_params
979             caption_list = self._download_xml(list_url, video_id)
980             original_lang_node = caption_list.find('track')
981             if original_lang_node is None:
982                 self._downloader.report_warning('Video doesn\'t have automatic captions')
983                 return {}
984             original_lang = original_lang_node.attrib['lang_code']
985             caption_kind = original_lang_node.attrib.get('kind', '')
986
987             sub_lang_list = {}
988             for lang_node in caption_list.findall('target'):
989                 sub_lang = lang_node.attrib['lang_code']
990                 sub_formats = []
991                 for ext in ['sbv', 'vtt', 'srt']:
992                     params = compat_urllib_parse.urlencode({
993                         'lang': original_lang,
994                         'tlang': sub_lang,
995                         'fmt': ext,
996                         'ts': timestamp,
997                         'kind': caption_kind,
998                     })
999                     sub_formats.append({
1000                         'url': caption_url + '&' + params,
1001                         'ext': ext,
1002                     })
1003                 sub_lang_list[sub_lang] = sub_formats
1004             return sub_lang_list
1005         # An extractor error can be raise by the download process if there are
1006         # no automatic captions but there are subtitles
1007         except (KeyError, ExtractorError):
1008             self._downloader.report_warning(err_msg)
1009             return {}
1010
1011     @classmethod
1012     def extract_id(cls, url):
1013         mobj = re.match(cls._VALID_URL, url, re.VERBOSE)
1014         if mobj is None:
1015             raise ExtractorError('Invalid URL: %s' % url)
1016         video_id = mobj.group(2)
1017         return video_id
1018
1019     def _extract_from_m3u8(self, manifest_url, video_id):
1020         url_map = {}
1021
1022         def _get_urls(_manifest):
1023             lines = _manifest.split('\n')
1024             urls = filter(lambda l: l and not l.startswith('#'),
1025                           lines)
1026             return urls
1027         manifest = self._download_webpage(manifest_url, video_id, 'Downloading formats manifest')
1028         formats_urls = _get_urls(manifest)
1029         for format_url in formats_urls:
1030             itag = self._search_regex(r'itag/(\d+?)/', format_url, 'itag')
1031             url_map[itag] = format_url
1032         return url_map
1033
1034     def _extract_annotations(self, video_id):
1035         url = 'https://www.youtube.com/annotations_invideo?features=1&legacy=1&video_id=%s' % video_id
1036         return self._download_webpage(url, video_id, note='Searching for annotations.', errnote='Unable to download video annotations.')
1037
1038     def _real_extract(self, url):
1039         url, smuggled_data = unsmuggle_url(url, {})
1040
1041         proto = (
1042             'http' if self._downloader.params.get('prefer_insecure', False)
1043             else 'https')
1044
1045         start_time = None
1046         end_time = None
1047         parsed_url = compat_urllib_parse_urlparse(url)
1048         for component in [parsed_url.fragment, parsed_url.query]:
1049             query = compat_parse_qs(component)
1050             if start_time is None and 't' in query:
1051                 start_time = parse_duration(query['t'][0])
1052             if start_time is None and 'start' in query:
1053                 start_time = parse_duration(query['start'][0])
1054             if end_time is None and 'end' in query:
1055                 end_time = parse_duration(query['end'][0])
1056
1057         # Extract original video URL from URL with redirection, like age verification, using next_url parameter
1058         mobj = re.search(self._NEXT_URL_RE, url)
1059         if mobj:
1060             url = proto + '://www.youtube.com/' + compat_urllib_parse_unquote(mobj.group(1)).lstrip('/')
1061         video_id = self.extract_id(url)
1062
1063         # Get video webpage
1064         url = proto + '://www.youtube.com/watch?v=%s&gl=US&hl=en&has_verified=1&bpctr=9999999999' % video_id
1065         video_webpage = self._download_webpage(url, video_id)
1066
1067         # Attempt to extract SWF player URL
1068         mobj = re.search(r'swfConfig.*?"(https?:\\/\\/.*?watch.*?-.*?\.swf)"', video_webpage)
1069         if mobj is not None:
1070             player_url = re.sub(r'\\(.)', r'\1', mobj.group(1))
1071         else:
1072             player_url = None
1073
1074         dash_mpds = []
1075
1076         def add_dash_mpd(video_info):
1077             dash_mpd = video_info.get('dashmpd')
1078             if dash_mpd and dash_mpd[0] not in dash_mpds:
1079                 dash_mpds.append(dash_mpd[0])
1080
1081         # Get video info
1082         embed_webpage = None
1083         is_live = None
1084         if re.search(r'player-age-gate-content">', video_webpage) is not None:
1085             age_gate = True
1086             # We simulate the access to the video from www.youtube.com/v/{video_id}
1087             # this can be viewed without login into Youtube
1088             url = proto + '://www.youtube.com/embed/%s' % video_id
1089             embed_webpage = self._download_webpage(url, video_id, 'Downloading embed webpage')
1090             data = compat_urllib_parse.urlencode({
1091                 'video_id': video_id,
1092                 'eurl': 'https://youtube.googleapis.com/v/' + video_id,
1093                 'sts': self._search_regex(
1094                     r'"sts"\s*:\s*(\d+)', embed_webpage, 'sts', default=''),
1095             })
1096             video_info_url = proto + '://www.youtube.com/get_video_info?' + data
1097             video_info_webpage = self._download_webpage(
1098                 video_info_url, video_id,
1099                 note='Refetching age-gated info webpage',
1100                 errnote='unable to download video info webpage')
1101             video_info = compat_parse_qs(video_info_webpage)
1102             add_dash_mpd(video_info)
1103         else:
1104             age_gate = False
1105             video_info = None
1106             # Try looking directly into the video webpage
1107             ytplayer_config = self._get_ytplayer_config(video_id, video_webpage)
1108             if ytplayer_config:
1109                 args = ytplayer_config['args']
1110                 if args.get('url_encoded_fmt_stream_map'):
1111                     # Convert to the same format returned by compat_parse_qs
1112                     video_info = dict((k, [v]) for k, v in args.items())
1113                     add_dash_mpd(video_info)
1114                 if args.get('livestream') == '1' or args.get('live_playback') == 1:
1115                     is_live = True
1116             if not video_info or self._downloader.params.get('youtube_include_dash_manifest', True):
1117                 # We also try looking in get_video_info since it may contain different dashmpd
1118                 # URL that points to a DASH manifest with possibly different itag set (some itags
1119                 # are missing from DASH manifest pointed by webpage's dashmpd, some - from DASH
1120                 # manifest pointed by get_video_info's dashmpd).
1121                 # The general idea is to take a union of itags of both DASH manifests (for example
1122                 # video with such 'manifest behavior' see https://github.com/rg3/youtube-dl/issues/6093)
1123                 self.report_video_info_webpage_download(video_id)
1124                 for el_type in ['&el=info', '&el=embedded', '&el=detailpage', '&el=vevo', '']:
1125                     video_info_url = (
1126                         '%s://www.youtube.com/get_video_info?&video_id=%s%s&ps=default&eurl=&gl=US&hl=en'
1127                         % (proto, video_id, el_type))
1128                     video_info_webpage = self._download_webpage(
1129                         video_info_url,
1130                         video_id, note=False,
1131                         errnote='unable to download video info webpage')
1132                     get_video_info = compat_parse_qs(video_info_webpage)
1133                     if get_video_info.get('use_cipher_signature') != ['True']:
1134                         add_dash_mpd(get_video_info)
1135                     if not video_info:
1136                         video_info = get_video_info
1137                     if 'token' in get_video_info:
1138                         # Different get_video_info requests may report different results, e.g.
1139                         # some may report video unavailability, but some may serve it without
1140                         # any complaint (see https://github.com/rg3/youtube-dl/issues/7362,
1141                         # the original webpage as well as el=info and el=embedded get_video_info
1142                         # requests report video unavailability due to geo restriction while
1143                         # el=detailpage succeeds and returns valid data). This is probably
1144                         # due to YouTube measures against IP ranges of hosting providers.
1145                         # Working around by preferring the first succeeded video_info containing
1146                         # the token if no such video_info yet was found.
1147                         if 'token' not in video_info:
1148                             video_info = get_video_info
1149                         break
1150         if 'token' not in video_info:
1151             if 'reason' in video_info:
1152                 if 'The uploader has not made this video available in your country.' in video_info['reason']:
1153                     regions_allowed = self._html_search_meta('regionsAllowed', video_webpage, default=None)
1154                     if regions_allowed:
1155                         raise ExtractorError('YouTube said: This video is available in %s only' % (
1156                             ', '.join(map(ISO3166Utils.short2full, regions_allowed.split(',')))),
1157                             expected=True)
1158                 raise ExtractorError(
1159                     'YouTube said: %s' % video_info['reason'][0],
1160                     expected=True, video_id=video_id)
1161             else:
1162                 raise ExtractorError(
1163                     '"token" parameter not in video info for unknown reason',
1164                     video_id=video_id)
1165
1166         # title
1167         if 'title' in video_info:
1168             video_title = video_info['title'][0]
1169         else:
1170             self._downloader.report_warning('Unable to extract video title')
1171             video_title = '_'
1172
1173         # description
1174         video_description = get_element_by_id("eow-description", video_webpage)
1175         if video_description:
1176             video_description = re.sub(r'''(?x)
1177                 <a\s+
1178                     (?:[a-zA-Z-]+="[^"]+"\s+)*?
1179                     (?:title|href)="([^"]+)"\s+
1180                     (?:[a-zA-Z-]+="[^"]+"\s+)*?
1181                     class="(?:yt-uix-redirect-link|yt-uix-sessionlink[^"]*)"[^>]*>
1182                 [^<]+\.{3}\s*
1183                 </a>
1184             ''', r'\1', video_description)
1185             video_description = clean_html(video_description)
1186         else:
1187             fd_mobj = re.search(r'<meta name="description" content="([^"]+)"', video_webpage)
1188             if fd_mobj:
1189                 video_description = unescapeHTML(fd_mobj.group(1))
1190             else:
1191                 video_description = ''
1192
1193         if 'multifeed_metadata_list' in video_info and not smuggled_data.get('force_singlefeed', False):
1194             if not self._downloader.params.get('noplaylist'):
1195                 entries = []
1196                 feed_ids = []
1197                 multifeed_metadata_list = compat_urllib_parse_unquote_plus(video_info['multifeed_metadata_list'][0])
1198                 for feed in multifeed_metadata_list.split(','):
1199                     feed_data = compat_parse_qs(feed)
1200                     entries.append({
1201                         '_type': 'url_transparent',
1202                         'ie_key': 'Youtube',
1203                         'url': smuggle_url(
1204                             '%s://www.youtube.com/watch?v=%s' % (proto, feed_data['id'][0]),
1205                             {'force_singlefeed': True}),
1206                         'title': '%s (%s)' % (video_title, feed_data['title'][0]),
1207                     })
1208                     feed_ids.append(feed_data['id'][0])
1209                 self.to_screen(
1210                     'Downloading multifeed video (%s) - add --no-playlist to just download video %s'
1211                     % (', '.join(feed_ids), video_id))
1212                 return self.playlist_result(entries, video_id, video_title, video_description)
1213             self.to_screen('Downloading just video %s because of --no-playlist' % video_id)
1214
1215         if 'view_count' in video_info:
1216             view_count = int(video_info['view_count'][0])
1217         else:
1218             view_count = None
1219
1220         # Check for "rental" videos
1221         if 'ypc_video_rental_bar_text' in video_info and 'author' not in video_info:
1222             raise ExtractorError('"rental" videos not supported')
1223
1224         # Start extracting information
1225         self.report_information_extraction(video_id)
1226
1227         # uploader
1228         if 'author' not in video_info:
1229             raise ExtractorError('Unable to extract uploader name')
1230         video_uploader = compat_urllib_parse_unquote_plus(video_info['author'][0])
1231
1232         # uploader_id
1233         video_uploader_id = None
1234         mobj = re.search(r'<link itemprop="url" href="http://www.youtube.com/(?:user|channel)/([^"]+)">', video_webpage)
1235         if mobj is not None:
1236             video_uploader_id = mobj.group(1)
1237         else:
1238             self._downloader.report_warning('unable to extract uploader nickname')
1239
1240         # thumbnail image
1241         # We try first to get a high quality image:
1242         m_thumb = re.search(r'<span itemprop="thumbnail".*?href="(.*?)">',
1243                             video_webpage, re.DOTALL)
1244         if m_thumb is not None:
1245             video_thumbnail = m_thumb.group(1)
1246         elif 'thumbnail_url' not in video_info:
1247             self._downloader.report_warning('unable to extract video thumbnail')
1248             video_thumbnail = None
1249         else:   # don't panic if we can't find it
1250             video_thumbnail = compat_urllib_parse_unquote_plus(video_info['thumbnail_url'][0])
1251
1252         # upload date
1253         upload_date = self._html_search_meta(
1254             'datePublished', video_webpage, 'upload date', default=None)
1255         if not upload_date:
1256             upload_date = self._search_regex(
1257                 [r'(?s)id="eow-date.*?>(.*?)</span>',
1258                  r'id="watch-uploader-info".*?>.*?(?:Published|Uploaded|Streamed live|Started) on (.+?)</strong>'],
1259                 video_webpage, 'upload date', default=None)
1260             if upload_date:
1261                 upload_date = ' '.join(re.sub(r'[/,-]', r' ', mobj.group(1)).split())
1262         upload_date = unified_strdate(upload_date)
1263
1264         m_music = re.search(
1265             r'<h4[^>]+class="title"[^>]*>\s*Music\s*</h4>\s*<ul[^>]*>\s*<li>(?P<title>.+?) by (?P<creator>.+?)(?:\(.+?\))?</li',
1266             video_webpage)
1267         if m_music:
1268             video_alt_title = remove_quotes(unescapeHTML(m_music.group('title')))
1269             video_creator = clean_html(m_music.group('creator'))
1270         else:
1271             video_alt_title = video_creator = None
1272
1273         m_cat_container = self._search_regex(
1274             r'(?s)<h4[^>]*>\s*Category\s*</h4>\s*<ul[^>]*>(.*?)</ul>',
1275             video_webpage, 'categories', default=None)
1276         if m_cat_container:
1277             category = self._html_search_regex(
1278                 r'(?s)<a[^<]+>(.*?)</a>', m_cat_container, 'category',
1279                 default=None)
1280             video_categories = None if category is None else [category]
1281         else:
1282             video_categories = None
1283
1284         video_tags = [
1285             unescapeHTML(m.group('content'))
1286             for m in re.finditer(self._meta_regex('og:video:tag'), video_webpage)]
1287
1288         def _extract_count(count_name):
1289             return str_to_int(self._search_regex(
1290                 r'-%s-button[^>]+><span[^>]+class="yt-uix-button-content"[^>]*>([\d,]+)</span>'
1291                 % re.escape(count_name),
1292                 video_webpage, count_name, default=None))
1293
1294         like_count = _extract_count('like')
1295         dislike_count = _extract_count('dislike')
1296
1297         # subtitles
1298         video_subtitles = self.extract_subtitles(video_id, video_webpage)
1299         automatic_captions = self.extract_automatic_captions(video_id, video_webpage)
1300
1301         if 'length_seconds' not in video_info:
1302             self._downloader.report_warning('unable to extract video duration')
1303             video_duration = None
1304         else:
1305             video_duration = int(compat_urllib_parse_unquote_plus(video_info['length_seconds'][0]))
1306
1307         # annotations
1308         video_annotations = None
1309         if self._downloader.params.get('writeannotations', False):
1310             video_annotations = self._extract_annotations(video_id)
1311
1312         def _map_to_format_list(urlmap):
1313             formats = []
1314             for itag, video_real_url in urlmap.items():
1315                 dct = {
1316                     'format_id': itag,
1317                     'url': video_real_url,
1318                     'player_url': player_url,
1319                 }
1320                 if itag in self._formats:
1321                     dct.update(self._formats[itag])
1322                 formats.append(dct)
1323             return formats
1324
1325         if 'conn' in video_info and video_info['conn'][0].startswith('rtmp'):
1326             self.report_rtmp_download()
1327             formats = [{
1328                 'format_id': '_rtmp',
1329                 'protocol': 'rtmp',
1330                 'url': video_info['conn'][0],
1331                 'player_url': player_url,
1332             }]
1333         elif len(video_info.get('url_encoded_fmt_stream_map', [''])[0]) >= 1 or len(video_info.get('adaptive_fmts', [''])[0]) >= 1:
1334             encoded_url_map = video_info.get('url_encoded_fmt_stream_map', [''])[0] + ',' + video_info.get('adaptive_fmts', [''])[0]
1335             if 'rtmpe%3Dyes' in encoded_url_map:
1336                 raise ExtractorError('rtmpe downloads are not supported, see https://github.com/rg3/youtube-dl/issues/343 for more information.', expected=True)
1337             formats = []
1338             for url_data_str in encoded_url_map.split(','):
1339                 url_data = compat_parse_qs(url_data_str)
1340                 if 'itag' not in url_data or 'url' not in url_data:
1341                     continue
1342                 format_id = url_data['itag'][0]
1343                 url = url_data['url'][0]
1344
1345                 if 'sig' in url_data:
1346                     url += '&signature=' + url_data['sig'][0]
1347                 elif 's' in url_data:
1348                     encrypted_sig = url_data['s'][0]
1349                     ASSETS_RE = r'"assets":.+?"js":\s*("[^"]+")'
1350
1351                     jsplayer_url_json = self._search_regex(
1352                         ASSETS_RE,
1353                         embed_webpage if age_gate else video_webpage,
1354                         'JS player URL (1)', default=None)
1355                     if not jsplayer_url_json and not age_gate:
1356                         # We need the embed website after all
1357                         if embed_webpage is None:
1358                             embed_url = proto + '://www.youtube.com/embed/%s' % video_id
1359                             embed_webpage = self._download_webpage(
1360                                 embed_url, video_id, 'Downloading embed webpage')
1361                         jsplayer_url_json = self._search_regex(
1362                             ASSETS_RE, embed_webpage, 'JS player URL')
1363
1364                     player_url = json.loads(jsplayer_url_json)
1365                     if player_url is None:
1366                         player_url_json = self._search_regex(
1367                             r'ytplayer\.config.*?"url"\s*:\s*("[^"]+")',
1368                             video_webpage, 'age gate player URL')
1369                         player_url = json.loads(player_url_json)
1370
1371                     if self._downloader.params.get('verbose'):
1372                         if player_url is None:
1373                             player_version = 'unknown'
1374                             player_desc = 'unknown'
1375                         else:
1376                             if player_url.endswith('swf'):
1377                                 player_version = self._search_regex(
1378                                     r'-(.+?)(?:/watch_as3)?\.swf$', player_url,
1379                                     'flash player', fatal=False)
1380                                 player_desc = 'flash player %s' % player_version
1381                             else:
1382                                 player_version = self._search_regex(
1383                                     [r'html5player-([^/]+?)(?:/html5player(?:-new)?)?\.js', r'(?:www|player)-([^/]+)/base\.js'],
1384                                     player_url,
1385                                     'html5 player', fatal=False)
1386                                 player_desc = 'html5 player %s' % player_version
1387
1388                         parts_sizes = self._signature_cache_id(encrypted_sig)
1389                         self.to_screen('{%s} signature length %s, %s' %
1390                                        (format_id, parts_sizes, player_desc))
1391
1392                     signature = self._decrypt_signature(
1393                         encrypted_sig, video_id, player_url, age_gate)
1394                     url += '&signature=' + signature
1395                 if 'ratebypass' not in url:
1396                     url += '&ratebypass=yes'
1397
1398                 dct = {
1399                     'format_id': format_id,
1400                     'url': url,
1401                     'player_url': player_url,
1402                 }
1403                 if format_id in self._formats:
1404                     dct.update(self._formats[format_id])
1405
1406                 # Some itags are not included in DASH manifest thus corresponding formats will
1407                 # lack metadata (see https://github.com/rg3/youtube-dl/pull/5993).
1408                 # Trying to extract metadata from url_encoded_fmt_stream_map entry.
1409                 mobj = re.search(r'^(?P<width>\d+)[xX](?P<height>\d+)$', url_data.get('size', [''])[0])
1410                 width, height = (int(mobj.group('width')), int(mobj.group('height'))) if mobj else (None, None)
1411
1412                 more_fields = {
1413                     'filesize': int_or_none(url_data.get('clen', [None])[0]),
1414                     'tbr': float_or_none(url_data.get('bitrate', [None])[0], 1000),
1415                     'width': width,
1416                     'height': height,
1417                     'fps': int_or_none(url_data.get('fps', [None])[0]),
1418                     'format_note': url_data.get('quality_label', [None])[0] or url_data.get('quality', [None])[0],
1419                 }
1420                 for key, value in more_fields.items():
1421                     if value:
1422                         dct[key] = value
1423                 type_ = url_data.get('type', [None])[0]
1424                 if type_:
1425                     type_split = type_.split(';')
1426                     kind_ext = type_split[0].split('/')
1427                     if len(kind_ext) == 2:
1428                         kind, _ = kind_ext
1429                         dct['ext'] = mimetype2ext(type_split[0])
1430                         if kind in ('audio', 'video'):
1431                             codecs = None
1432                             for mobj in re.finditer(
1433                                     r'(?P<key>[a-zA-Z_-]+)=(?P<quote>["\']?)(?P<val>.+?)(?P=quote)(?:;|$)', type_):
1434                                 if mobj.group('key') == 'codecs':
1435                                     codecs = mobj.group('val')
1436                                     break
1437                             if codecs:
1438                                 codecs = codecs.split(',')
1439                                 if len(codecs) == 2:
1440                                     acodec, vcodec = codecs[1], codecs[0]
1441                                 else:
1442                                     acodec, vcodec = (codecs[0], 'none') if kind == 'audio' else ('none', codecs[0])
1443                                 dct.update({
1444                                     'acodec': acodec,
1445                                     'vcodec': vcodec,
1446                                 })
1447                 formats.append(dct)
1448         elif video_info.get('hlsvp'):
1449             manifest_url = video_info['hlsvp'][0]
1450             url_map = self._extract_from_m3u8(manifest_url, video_id)
1451             formats = _map_to_format_list(url_map)
1452             # Accept-Encoding header causes failures in live streams on Youtube and Youtube Gaming
1453             for a_format in formats:
1454                 a_format.setdefault('http_headers', {})['Youtubedl-no-compression'] = 'True'
1455         else:
1456             unavailable_message = self._html_search_regex(
1457                 r'(?s)<h1[^>]+id="unavailable-message"[^>]*>(.+?)</h1>',
1458                 video_webpage, 'unavailable message', default=None)
1459             if unavailable_message:
1460                 raise ExtractorError(unavailable_message, expected=True)
1461             raise ExtractorError('no conn, hlsvp or url_encoded_fmt_stream_map information found in video info')
1462
1463         # Look for the DASH manifest
1464         if self._downloader.params.get('youtube_include_dash_manifest', True):
1465             dash_mpd_fatal = True
1466             for dash_manifest_url in dash_mpds:
1467                 dash_formats = {}
1468                 try:
1469                     def decrypt_sig(mobj):
1470                         s = mobj.group(1)
1471                         dec_s = self._decrypt_signature(s, video_id, player_url, age_gate)
1472                         return '/signature/%s' % dec_s
1473
1474                     dash_manifest_url = re.sub(r'/s/([a-fA-F0-9\.]+)', decrypt_sig, dash_manifest_url)
1475
1476                     for df in self._extract_dash_manifest_formats(
1477                             dash_manifest_url, video_id, fatal=dash_mpd_fatal,
1478                             namespace='urn:mpeg:DASH:schema:MPD:2011', formats_dict=self._formats):
1479                         # Do not overwrite DASH format found in some previous DASH manifest
1480                         if df['format_id'] not in dash_formats:
1481                             dash_formats[df['format_id']] = df
1482                         # Additional DASH manifests may end up in HTTP Error 403 therefore
1483                         # allow them to fail without bug report message if we already have
1484                         # some DASH manifest succeeded. This is temporary workaround to reduce
1485                         # burst of bug reports until we figure out the reason and whether it
1486                         # can be fixed at all.
1487                         dash_mpd_fatal = False
1488                 except (ExtractorError, KeyError) as e:
1489                     self.report_warning(
1490                         'Skipping DASH manifest: %r' % e, video_id)
1491                 if dash_formats:
1492                     # Remove the formats we found through non-DASH, they
1493                     # contain less info and it can be wrong, because we use
1494                     # fixed values (for example the resolution). See
1495                     # https://github.com/rg3/youtube-dl/issues/5774 for an
1496                     # example.
1497                     formats = [f for f in formats if f['format_id'] not in dash_formats.keys()]
1498                     formats.extend(dash_formats.values())
1499
1500         # Check for malformed aspect ratio
1501         stretched_m = re.search(
1502             r'<meta\s+property="og:video:tag".*?content="yt:stretch=(?P<w>[0-9]+):(?P<h>[0-9]+)">',
1503             video_webpage)
1504         if stretched_m:
1505             w = float(stretched_m.group('w'))
1506             h = float(stretched_m.group('h'))
1507             # yt:stretch may hold invalid ratio data (e.g. for Q39EVAstoRM ratio is 17:0).
1508             # We will only process correct ratios.
1509             if w > 0 and h > 0:
1510                 ratio = w / h
1511                 for f in formats:
1512                     if f.get('vcodec') != 'none':
1513                         f['stretched_ratio'] = ratio
1514
1515         self._sort_formats(formats)
1516
1517         return {
1518             'id': video_id,
1519             'uploader': video_uploader,
1520             'uploader_id': video_uploader_id,
1521             'upload_date': upload_date,
1522             'creator': video_creator,
1523             'title': video_title,
1524             'alt_title': video_alt_title,
1525             'thumbnail': video_thumbnail,
1526             'description': video_description,
1527             'categories': video_categories,
1528             'tags': video_tags,
1529             'subtitles': video_subtitles,
1530             'automatic_captions': automatic_captions,
1531             'duration': video_duration,
1532             'age_limit': 18 if age_gate else 0,
1533             'annotations': video_annotations,
1534             'webpage_url': proto + '://www.youtube.com/watch?v=%s' % video_id,
1535             'view_count': view_count,
1536             'like_count': like_count,
1537             'dislike_count': dislike_count,
1538             'average_rating': float_or_none(video_info.get('avg_rating', [None])[0]),
1539             'formats': formats,
1540             'is_live': is_live,
1541             'start_time': start_time,
1542             'end_time': end_time,
1543         }
1544
1545
1546 class YoutubePlaylistIE(YoutubePlaylistBaseInfoExtractor):
1547     IE_DESC = 'YouTube.com playlists'
1548     _VALID_URL = r"""(?x)(?:
1549                         (?:https?://)?
1550                         (?:\w+\.)?
1551                         youtube\.com/
1552                         (?:
1553                            (?:course|view_play_list|my_playlists|artist|playlist|watch|embed/videoseries)
1554                            \? (?:.*?[&;])*? (?:p|a|list)=
1555                         |  p/
1556                         )
1557                         (
1558                             (?:PL|LL|EC|UU|FL|RD|UL)?[0-9A-Za-z-_]{10,}
1559                             # Top tracks, they can also include dots
1560                             |(?:MC)[\w\.]*
1561                         )
1562                         .*
1563                      |
1564                         ((?:PL|LL|EC|UU|FL|RD|UL)[0-9A-Za-z-_]{10,})
1565                      )"""
1566     _TEMPLATE_URL = 'https://www.youtube.com/playlist?list=%s'
1567     _VIDEO_RE = r'href="\s*/watch\?v=(?P<id>[0-9A-Za-z_-]{11})&amp;[^"]*?index=(?P<index>\d+)(?:[^>]+>(?P<title>[^<]+))?'
1568     IE_NAME = 'youtube:playlist'
1569     _TESTS = [{
1570         'url': 'https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re',
1571         'info_dict': {
1572             'title': 'ytdl test PL',
1573             'id': 'PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re',
1574         },
1575         'playlist_count': 3,
1576     }, {
1577         'url': 'https://www.youtube.com/playlist?list=PLtPgu7CB4gbZDA7i_euNxn75ISqxwZPYx',
1578         'info_dict': {
1579             'id': 'PLtPgu7CB4gbZDA7i_euNxn75ISqxwZPYx',
1580             'title': 'YDL_Empty_List',
1581         },
1582         'playlist_count': 0,
1583     }, {
1584         'note': 'Playlist with deleted videos (#651). As a bonus, the video #51 is also twice in this list.',
1585         'url': 'https://www.youtube.com/playlist?list=PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
1586         'info_dict': {
1587             'title': '29C3: Not my department',
1588             'id': 'PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
1589         },
1590         'playlist_count': 95,
1591     }, {
1592         'note': 'issue #673',
1593         'url': 'PLBB231211A4F62143',
1594         'info_dict': {
1595             'title': '[OLD]Team Fortress 2 (Class-based LP)',
1596             'id': 'PLBB231211A4F62143',
1597         },
1598         'playlist_mincount': 26,
1599     }, {
1600         'note': 'Large playlist',
1601         'url': 'https://www.youtube.com/playlist?list=UUBABnxM4Ar9ten8Mdjj1j0Q',
1602         'info_dict': {
1603             'title': 'Uploads from Cauchemar',
1604             'id': 'UUBABnxM4Ar9ten8Mdjj1j0Q',
1605         },
1606         'playlist_mincount': 799,
1607     }, {
1608         'url': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
1609         'info_dict': {
1610             'title': 'YDL_safe_search',
1611             'id': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
1612         },
1613         'playlist_count': 2,
1614     }, {
1615         'note': 'embedded',
1616         'url': 'http://www.youtube.com/embed/videoseries?list=PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
1617         'playlist_count': 4,
1618         'info_dict': {
1619             'title': 'JODA15',
1620             'id': 'PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
1621         }
1622     }, {
1623         'note': 'Embedded SWF player',
1624         'url': 'http://www.youtube.com/p/YN5VISEtHet5D4NEvfTd0zcgFk84NqFZ?hl=en_US&fs=1&rel=0',
1625         'playlist_count': 4,
1626         'info_dict': {
1627             'title': 'JODA7',
1628             'id': 'YN5VISEtHet5D4NEvfTd0zcgFk84NqFZ',
1629         }
1630     }, {
1631         'note': 'Buggy playlist: the webpage has a "Load more" button but it doesn\'t have more videos',
1632         'url': 'https://www.youtube.com/playlist?list=UUXw-G3eDE9trcvY2sBMM_aA',
1633         'info_dict': {
1634             'title': 'Uploads from Interstellar Movie',
1635             'id': 'UUXw-G3eDE9trcvY2sBMM_aA',
1636         },
1637         'playlist_mincout': 21,
1638     }]
1639
1640     def _real_initialize(self):
1641         self._login()
1642
1643     def _extract_mix(self, playlist_id):
1644         # The mixes are generated from a single video
1645         # the id of the playlist is just 'RD' + video_id
1646         url = 'https://youtube.com/watch?v=%s&list=%s' % (playlist_id[-11:], playlist_id)
1647         webpage = self._download_webpage(
1648             url, playlist_id, 'Downloading Youtube mix')
1649         search_title = lambda class_name: get_element_by_attribute('class', class_name, webpage)
1650         title_span = (
1651             search_title('playlist-title') or
1652             search_title('title long-title') or
1653             search_title('title'))
1654         title = clean_html(title_span)
1655         ids = orderedSet(re.findall(
1656             r'''(?xs)data-video-username=".*?".*?
1657                        href="/watch\?v=([0-9A-Za-z_-]{11})&amp;[^"]*?list=%s''' % re.escape(playlist_id),
1658             webpage))
1659         url_results = self._ids_to_results(ids)
1660
1661         return self.playlist_result(url_results, playlist_id, title)
1662
1663     def _extract_playlist(self, playlist_id):
1664         url = self._TEMPLATE_URL % playlist_id
1665         page = self._download_webpage(url, playlist_id)
1666
1667         for match in re.findall(r'<div class="yt-alert-message">([^<]+)</div>', page):
1668             match = match.strip()
1669             # Check if the playlist exists or is private
1670             if re.match(r'[^<]*(The|This) playlist (does not exist|is private)[^<]*', match):
1671                 raise ExtractorError(
1672                     'The playlist doesn\'t exist or is private, use --username or '
1673                     '--netrc to access it.',
1674                     expected=True)
1675             elif re.match(r'[^<]*Invalid parameters[^<]*', match):
1676                 raise ExtractorError(
1677                     'Invalid parameters. Maybe URL is incorrect.',
1678                     expected=True)
1679             elif re.match(r'[^<]*Choose your language[^<]*', match):
1680                 continue
1681             else:
1682                 self.report_warning('Youtube gives an alert message: ' + match)
1683
1684         playlist_title = self._html_search_regex(
1685             r'(?s)<h1 class="pl-header-title[^"]*"[^>]*>\s*(.*?)\s*</h1>',
1686             page, 'title')
1687
1688         return self.playlist_result(self._entries(page, playlist_id), playlist_id, playlist_title)
1689
1690     def _real_extract(self, url):
1691         # Extract playlist id
1692         mobj = re.match(self._VALID_URL, url)
1693         if mobj is None:
1694             raise ExtractorError('Invalid URL: %s' % url)
1695         playlist_id = mobj.group(1) or mobj.group(2)
1696
1697         # Check if it's a video-specific URL
1698         query_dict = compat_urlparse.parse_qs(compat_urlparse.urlparse(url).query)
1699         if 'v' in query_dict:
1700             video_id = query_dict['v'][0]
1701             if self._downloader.params.get('noplaylist'):
1702                 self.to_screen('Downloading just video %s because of --no-playlist' % video_id)
1703                 return self.url_result(video_id, 'Youtube', video_id=video_id)
1704             else:
1705                 self.to_screen('Downloading playlist %s - add --no-playlist to just download video %s' % (playlist_id, video_id))
1706
1707         if playlist_id.startswith('RD') or playlist_id.startswith('UL'):
1708             # Mixes require a custom extraction process
1709             return self._extract_mix(playlist_id)
1710
1711         return self._extract_playlist(playlist_id)
1712
1713
1714 class YoutubeChannelIE(YoutubePlaylistBaseInfoExtractor):
1715     IE_DESC = 'YouTube.com channels'
1716     _VALID_URL = r'https?://(?:youtu\.be|(?:\w+\.)?youtube(?:-nocookie)?\.com)/channel/(?P<id>[0-9A-Za-z_-]+)'
1717     _TEMPLATE_URL = 'https://www.youtube.com/channel/%s/videos'
1718     _VIDEO_RE = r'(?:title="(?P<title>[^"]+)"[^>]+)?href="/watch\?v=(?P<id>[0-9A-Za-z_-]+)&?'
1719     IE_NAME = 'youtube:channel'
1720     _TESTS = [{
1721         'note': 'paginated channel',
1722         'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w',
1723         'playlist_mincount': 91,
1724         'info_dict': {
1725             'id': 'UUKfVa3S1e4PHvxWcwyMMg8w',
1726             'title': 'Uploads from lex will',
1727         }
1728     }, {
1729         'note': 'Age restricted channel',
1730         # from https://www.youtube.com/user/DeusExOfficial
1731         'url': 'https://www.youtube.com/channel/UCs0ifCMCm1icqRbqhUINa0w',
1732         'playlist_mincount': 64,
1733         'info_dict': {
1734             'id': 'UUs0ifCMCm1icqRbqhUINa0w',
1735             'title': 'Uploads from Deus Ex',
1736         },
1737     }]
1738
1739     @classmethod
1740     def suitable(cls, url):
1741         return False if YoutubePlaylistsIE.suitable(url) else super(YoutubeChannelIE, cls).suitable(url)
1742
1743     def _real_extract(self, url):
1744         channel_id = self._match_id(url)
1745
1746         url = self._TEMPLATE_URL % channel_id
1747
1748         # Channel by page listing is restricted to 35 pages of 30 items, i.e. 1050 videos total (see #5778)
1749         # Workaround by extracting as a playlist if managed to obtain channel playlist URL
1750         # otherwise fallback on channel by page extraction
1751         channel_page = self._download_webpage(
1752             url + '?view=57', channel_id,
1753             'Downloading channel page', fatal=False)
1754         if channel_page is False:
1755             channel_playlist_id = False
1756         else:
1757             channel_playlist_id = self._html_search_meta(
1758                 'channelId', channel_page, 'channel id', default=None)
1759             if not channel_playlist_id:
1760                 channel_playlist_id = self._search_regex(
1761                     r'data-(?:channel-external-|yt)id="([^"]+)"',
1762                     channel_page, 'channel id', default=None)
1763         if channel_playlist_id and channel_playlist_id.startswith('UC'):
1764             playlist_id = 'UU' + channel_playlist_id[2:]
1765             return self.url_result(
1766                 compat_urlparse.urljoin(url, '/playlist?list=%s' % playlist_id), 'YoutubePlaylist')
1767
1768         channel_page = self._download_webpage(url, channel_id, 'Downloading page #1')
1769         autogenerated = re.search(r'''(?x)
1770                 class="[^"]*?(?:
1771                     channel-header-autogenerated-label|
1772                     yt-channel-title-autogenerated
1773                 )[^"]*"''', channel_page) is not None
1774
1775         if autogenerated:
1776             # The videos are contained in a single page
1777             # the ajax pages can't be used, they are empty
1778             entries = [
1779                 self.url_result(
1780                     video_id, 'Youtube', video_id=video_id,
1781                     video_title=video_title)
1782                 for video_id, video_title in self.extract_videos_from_page(channel_page)]
1783             return self.playlist_result(entries, channel_id)
1784
1785         return self.playlist_result(self._entries(channel_page, channel_id), channel_id)
1786
1787
1788 class YoutubeUserIE(YoutubeChannelIE):
1789     IE_DESC = 'YouTube.com user videos (URL or "ytuser" keyword)'
1790     _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_-]+)'
1791     _TEMPLATE_URL = 'https://www.youtube.com/user/%s/videos'
1792     IE_NAME = 'youtube:user'
1793
1794     _TESTS = [{
1795         'url': 'https://www.youtube.com/user/TheLinuxFoundation',
1796         'playlist_mincount': 320,
1797         'info_dict': {
1798             'title': 'TheLinuxFoundation',
1799         }
1800     }, {
1801         'url': 'ytuser:phihag',
1802         'only_matching': True,
1803     }]
1804
1805     @classmethod
1806     def suitable(cls, url):
1807         # Don't return True if the url can be extracted with other youtube
1808         # extractor, the regex would is too permissive and it would match.
1809         other_ies = iter(klass for (name, klass) in globals().items() if name.endswith('IE') and klass is not cls)
1810         if any(ie.suitable(url) for ie in other_ies):
1811             return False
1812         else:
1813             return super(YoutubeUserIE, cls).suitable(url)
1814
1815
1816 class YoutubePlaylistsIE(YoutubePlaylistsBaseInfoExtractor):
1817     IE_DESC = 'YouTube.com user/channel playlists'
1818     _VALID_URL = r'https?://(?:\w+\.)?youtube\.com/(?:user|channel)/(?P<id>[^/]+)/playlists'
1819     IE_NAME = 'youtube:playlists'
1820
1821     _TESTS = [{
1822         'url': 'http://www.youtube.com/user/ThirstForScience/playlists',
1823         'playlist_mincount': 4,
1824         'info_dict': {
1825             'id': 'ThirstForScience',
1826             'title': 'Thirst for Science',
1827         },
1828     }, {
1829         # with "Load more" button
1830         'url': 'http://www.youtube.com/user/igorkle1/playlists?view=1&sort=dd',
1831         'playlist_mincount': 70,
1832         'info_dict': {
1833             'id': 'igorkle1',
1834             'title': 'Игорь Клейнер',
1835         },
1836     }, {
1837         'url': 'https://www.youtube.com/channel/UCiU1dHvZObB2iP6xkJ__Icw/playlists',
1838         'playlist_mincount': 17,
1839         'info_dict': {
1840             'id': 'UCiU1dHvZObB2iP6xkJ__Icw',
1841             'title': 'Chem Player',
1842         },
1843     }]
1844
1845
1846 class YoutubeSearchIE(SearchInfoExtractor, YoutubePlaylistIE):
1847     IE_DESC = 'YouTube.com searches'
1848     # there doesn't appear to be a real limit, for example if you search for
1849     # 'python' you get more than 8.000.000 results
1850     _MAX_RESULTS = float('inf')
1851     IE_NAME = 'youtube:search'
1852     _SEARCH_KEY = 'ytsearch'
1853     _EXTRA_QUERY_ARGS = {}
1854     _TESTS = []
1855
1856     def _get_n_results(self, query, n):
1857         """Get a specified number of results for a query"""
1858
1859         videos = []
1860         limit = n
1861
1862         for pagenum in itertools.count(1):
1863             url_query = {
1864                 'search_query': query.encode('utf-8'),
1865                 'page': pagenum,
1866                 'spf': 'navigate',
1867             }
1868             url_query.update(self._EXTRA_QUERY_ARGS)
1869             result_url = 'https://www.youtube.com/results?' + compat_urllib_parse.urlencode(url_query)
1870             data = self._download_json(
1871                 result_url, video_id='query "%s"' % query,
1872                 note='Downloading page %s' % pagenum,
1873                 errnote='Unable to download API page')
1874             html_content = data[1]['body']['content']
1875
1876             if 'class="search-message' in html_content:
1877                 raise ExtractorError(
1878                     '[youtube] No video results', expected=True)
1879
1880             new_videos = self._ids_to_results(orderedSet(re.findall(
1881                 r'href="/watch\?v=(.{11})', html_content)))
1882             videos += new_videos
1883             if not new_videos or len(videos) > limit:
1884                 break
1885
1886         if len(videos) > n:
1887             videos = videos[:n]
1888         return self.playlist_result(videos, query)
1889
1890
1891 class YoutubeSearchDateIE(YoutubeSearchIE):
1892     IE_NAME = YoutubeSearchIE.IE_NAME + ':date'
1893     _SEARCH_KEY = 'ytsearchdate'
1894     IE_DESC = 'YouTube.com searches, newest videos first'
1895     _EXTRA_QUERY_ARGS = {'search_sort': 'video_date_uploaded'}
1896
1897
1898 class YoutubeSearchURLIE(InfoExtractor):
1899     IE_DESC = 'YouTube.com search URLs'
1900     IE_NAME = 'youtube:search_url'
1901     _VALID_URL = r'https?://(?:www\.)?youtube\.com/results\?(.*?&)?search_query=(?P<query>[^&]+)(?:[&]|$)'
1902     _TESTS = [{
1903         'url': 'https://www.youtube.com/results?baz=bar&search_query=youtube-dl+test+video&filters=video&lclk=video',
1904         'playlist_mincount': 5,
1905         'info_dict': {
1906             'title': 'youtube-dl test video',
1907         }
1908     }]
1909
1910     def _real_extract(self, url):
1911         mobj = re.match(self._VALID_URL, url)
1912         query = compat_urllib_parse_unquote_plus(mobj.group('query'))
1913
1914         webpage = self._download_webpage(url, query)
1915         result_code = self._search_regex(
1916             r'(?s)<ol[^>]+class="item-section"(.*?)</ol>', webpage, 'result HTML')
1917
1918         part_codes = re.findall(
1919             r'(?s)<h3[^>]+class="[^"]*yt-lockup-title[^"]*"[^>]*>(.*?)</h3>', result_code)
1920         entries = []
1921         for part_code in part_codes:
1922             part_title = self._html_search_regex(
1923                 [r'(?s)title="([^"]+)"', r'>([^<]+)</a>'], part_code, 'item title', fatal=False)
1924             part_url_snippet = self._html_search_regex(
1925                 r'(?s)href="([^"]+)"', part_code, 'item URL')
1926             part_url = compat_urlparse.urljoin(
1927                 'https://www.youtube.com/', part_url_snippet)
1928             entries.append({
1929                 '_type': 'url',
1930                 'url': part_url,
1931                 'title': part_title,
1932             })
1933
1934         return {
1935             '_type': 'playlist',
1936             'entries': entries,
1937             'title': query,
1938         }
1939
1940
1941 class YoutubeShowIE(YoutubePlaylistsBaseInfoExtractor):
1942     IE_DESC = 'YouTube.com (multi-season) shows'
1943     _VALID_URL = r'https?://www\.youtube\.com/show/(?P<id>[^?#]*)'
1944     IE_NAME = 'youtube:show'
1945     _TESTS = [{
1946         'url': 'https://www.youtube.com/show/airdisasters',
1947         'playlist_mincount': 5,
1948         'info_dict': {
1949             'id': 'airdisasters',
1950             'title': 'Air Disasters',
1951         }
1952     }]
1953
1954     def _real_extract(self, url):
1955         playlist_id = self._match_id(url)
1956         return super(YoutubeShowIE, self)._real_extract(
1957             'https://www.youtube.com/show/%s/playlists' % playlist_id)
1958
1959
1960 class YoutubeFeedsInfoExtractor(YoutubeBaseInfoExtractor):
1961     """
1962     Base class for feed extractors
1963     Subclasses must define the _FEED_NAME and _PLAYLIST_TITLE properties.
1964     """
1965     _LOGIN_REQUIRED = True
1966
1967     @property
1968     def IE_NAME(self):
1969         return 'youtube:%s' % self._FEED_NAME
1970
1971     def _real_initialize(self):
1972         self._login()
1973
1974     def _real_extract(self, url):
1975         page = self._download_webpage(
1976             'https://www.youtube.com/feed/%s' % self._FEED_NAME, self._PLAYLIST_TITLE)
1977
1978         # The extraction process is the same as for playlists, but the regex
1979         # for the video ids doesn't contain an index
1980         ids = []
1981         more_widget_html = content_html = page
1982         for page_num in itertools.count(1):
1983             matches = re.findall(r'href="\s*/watch\?v=([0-9A-Za-z_-]{11})', content_html)
1984
1985             # 'recommended' feed has infinite 'load more' and each new portion spins
1986             # the same videos in (sometimes) slightly different order, so we'll check
1987             # for unicity and break when portion has no new videos
1988             new_ids = filter(lambda video_id: video_id not in ids, orderedSet(matches))
1989             if not new_ids:
1990                 break
1991
1992             ids.extend(new_ids)
1993
1994             mobj = re.search(r'data-uix-load-more-href="/?(?P<more>[^"]+)"', more_widget_html)
1995             if not mobj:
1996                 break
1997
1998             more = self._download_json(
1999                 'https://youtube.com/%s' % mobj.group('more'), self._PLAYLIST_TITLE,
2000                 'Downloading page #%s' % page_num,
2001                 transform_source=uppercase_escape)
2002             content_html = more['content_html']
2003             more_widget_html = more['load_more_widget_html']
2004
2005         return self.playlist_result(
2006             self._ids_to_results(ids), playlist_title=self._PLAYLIST_TITLE)
2007
2008
2009 class YoutubeWatchLaterIE(YoutubePlaylistIE):
2010     IE_NAME = 'youtube:watchlater'
2011     IE_DESC = 'Youtube watch later list, ":ytwatchlater" for short (requires authentication)'
2012     _VALID_URL = r'https?://www\.youtube\.com/(?:feed/watch_later|playlist\?list=WL)|:ytwatchlater'
2013
2014     _TESTS = []  # override PlaylistIE tests
2015
2016     def _real_extract(self, url):
2017         return self._extract_playlist('WL')
2018
2019
2020 class YoutubeFavouritesIE(YoutubeBaseInfoExtractor):
2021     IE_NAME = 'youtube:favorites'
2022     IE_DESC = 'YouTube.com favourite videos, ":ytfav" for short (requires authentication)'
2023     _VALID_URL = r'https?://www\.youtube\.com/my_favorites|:ytfav(?:ou?rites)?'
2024     _LOGIN_REQUIRED = True
2025
2026     def _real_extract(self, url):
2027         webpage = self._download_webpage('https://www.youtube.com/my_favorites', 'Youtube Favourites videos')
2028         playlist_id = self._search_regex(r'list=(.+?)["&]', webpage, 'favourites playlist id')
2029         return self.url_result(playlist_id, 'YoutubePlaylist')
2030
2031
2032 class YoutubeRecommendedIE(YoutubeFeedsInfoExtractor):
2033     IE_DESC = 'YouTube.com recommended videos, ":ytrec" for short (requires authentication)'
2034     _VALID_URL = r'https?://www\.youtube\.com/feed/recommended|:ytrec(?:ommended)?'
2035     _FEED_NAME = 'recommended'
2036     _PLAYLIST_TITLE = 'Youtube Recommended videos'
2037
2038
2039 class YoutubeSubscriptionsIE(YoutubeFeedsInfoExtractor):
2040     IE_DESC = 'YouTube.com subscriptions feed, "ytsubs" keyword (requires authentication)'
2041     _VALID_URL = r'https?://www\.youtube\.com/feed/subscriptions|:ytsubs(?:criptions)?'
2042     _FEED_NAME = 'subscriptions'
2043     _PLAYLIST_TITLE = 'Youtube Subscriptions'
2044
2045
2046 class YoutubeHistoryIE(YoutubeFeedsInfoExtractor):
2047     IE_DESC = 'Youtube watch history, ":ythistory" for short (requires authentication)'
2048     _VALID_URL = 'https?://www\.youtube\.com/feed/history|:ythistory'
2049     _FEED_NAME = 'history'
2050     _PLAYLIST_TITLE = 'Youtube History'
2051
2052
2053 class YoutubeTruncatedURLIE(InfoExtractor):
2054     IE_NAME = 'youtube:truncated_url'
2055     IE_DESC = False  # Do not list
2056     _VALID_URL = r'''(?x)
2057         (?:https?://)?
2058         (?:\w+\.)?[yY][oO][uU][tT][uU][bB][eE](?:-nocookie)?\.com/
2059         (?:watch\?(?:
2060             feature=[a-z_]+|
2061             annotation_id=annotation_[^&]+|
2062             x-yt-cl=[0-9]+|
2063             hl=[^&]*|
2064             t=[0-9]+
2065         )?
2066         |
2067             attribution_link\?a=[^&]+
2068         )
2069         $
2070     '''
2071
2072     _TESTS = [{
2073         'url': 'http://www.youtube.com/watch?annotation_id=annotation_3951667041',
2074         'only_matching': True,
2075     }, {
2076         'url': 'http://www.youtube.com/watch?',
2077         'only_matching': True,
2078     }, {
2079         'url': 'https://www.youtube.com/watch?x-yt-cl=84503534',
2080         'only_matching': True,
2081     }, {
2082         'url': 'https://www.youtube.com/watch?feature=foo',
2083         'only_matching': True,
2084     }, {
2085         'url': 'https://www.youtube.com/watch?hl=en-GB',
2086         'only_matching': True,
2087     }, {
2088         'url': 'https://www.youtube.com/watch?t=2372',
2089         'only_matching': True,
2090     }]
2091
2092     def _real_extract(self, url):
2093         raise ExtractorError(
2094             'Did you forget to quote the URL? Remember that & is a meta '
2095             'character in most shells, so you want to put the URL in quotes, '
2096             'like  youtube-dl '
2097             '"http://www.youtube.com/watch?feature=foo&v=BaW_jenozKc" '
2098             ' or simply  youtube-dl BaW_jenozKc  .',
2099             expected=True)
2100
2101
2102 class YoutubeTruncatedIDIE(InfoExtractor):
2103     IE_NAME = 'youtube:truncated_id'
2104     IE_DESC = False  # Do not list
2105     _VALID_URL = r'https?://(?:www\.)?youtube\.com/watch\?v=(?P<id>[0-9A-Za-z_-]{1,10})$'
2106
2107     _TESTS = [{
2108         'url': 'https://www.youtube.com/watch?v=N_708QY7Ob',
2109         'only_matching': True,
2110     }]
2111
2112     def _real_extract(self, url):
2113         video_id = self._match_id(url)
2114         raise ExtractorError(
2115             'Incomplete YouTube ID %s. URL %s looks truncated.' % (video_id, url),
2116             expected=True)