[common] Remove unused arguments
[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(InfoExtractor):
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 re.findall(r'href="/?playlist\?list=(.+?)"', 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                     dash_doc = self._download_xml(
1476                         dash_manifest_url, video_id,
1477                         note='Downloading DASH manifest',
1478                         errnote='Could not download DASH manifest',
1479                         fatal=dash_mpd_fatal)
1480
1481                     for df in self._parse_dash_manifest(
1482                             dash_doc, namespace='urn:mpeg:DASH:schema:MPD:2011', formats_dict=self._formats):
1483                         # Do not overwrite DASH format found in some previous DASH manifest
1484                         if df['format_id'] not in dash_formats:
1485                             dash_formats[df['format_id']] = df
1486                         # Additional DASH manifests may end up in HTTP Error 403 therefore
1487                         # allow them to fail without bug report message if we already have
1488                         # some DASH manifest succeeded. This is temporary workaround to reduce
1489                         # burst of bug reports until we figure out the reason and whether it
1490                         # can be fixed at all.
1491                         dash_mpd_fatal = False
1492                 except (ExtractorError, KeyError) as e:
1493                     self.report_warning(
1494                         'Skipping DASH manifest: %r' % e, video_id)
1495                 if dash_formats:
1496                     # Remove the formats we found through non-DASH, they
1497                     # contain less info and it can be wrong, because we use
1498                     # fixed values (for example the resolution). See
1499                     # https://github.com/rg3/youtube-dl/issues/5774 for an
1500                     # example.
1501                     formats = [f for f in formats if f['format_id'] not in dash_formats.keys()]
1502                     formats.extend(dash_formats.values())
1503
1504         # Check for malformed aspect ratio
1505         stretched_m = re.search(
1506             r'<meta\s+property="og:video:tag".*?content="yt:stretch=(?P<w>[0-9]+):(?P<h>[0-9]+)">',
1507             video_webpage)
1508         if stretched_m:
1509             w = float(stretched_m.group('w'))
1510             h = float(stretched_m.group('h'))
1511             # yt:stretch may hold invalid ratio data (e.g. for Q39EVAstoRM ratio is 17:0).
1512             # We will only process correct ratios.
1513             if w > 0 and h > 0:
1514                 ratio = w / h
1515                 for f in formats:
1516                     if f.get('vcodec') != 'none':
1517                         f['stretched_ratio'] = ratio
1518
1519         self._sort_formats(formats)
1520
1521         return {
1522             'id': video_id,
1523             'uploader': video_uploader,
1524             'uploader_id': video_uploader_id,
1525             'upload_date': upload_date,
1526             'creator': video_creator,
1527             'title': video_title,
1528             'alt_title': video_alt_title,
1529             'thumbnail': video_thumbnail,
1530             'description': video_description,
1531             'categories': video_categories,
1532             'tags': video_tags,
1533             'subtitles': video_subtitles,
1534             'automatic_captions': automatic_captions,
1535             'duration': video_duration,
1536             'age_limit': 18 if age_gate else 0,
1537             'annotations': video_annotations,
1538             'webpage_url': proto + '://www.youtube.com/watch?v=%s' % video_id,
1539             'view_count': view_count,
1540             'like_count': like_count,
1541             'dislike_count': dislike_count,
1542             'average_rating': float_or_none(video_info.get('avg_rating', [None])[0]),
1543             'formats': formats,
1544             'is_live': is_live,
1545             'start_time': start_time,
1546             'end_time': end_time,
1547         }
1548
1549
1550 class YoutubePlaylistIE(YoutubeBaseInfoExtractor, YoutubePlaylistBaseInfoExtractor):
1551     IE_DESC = 'YouTube.com playlists'
1552     _VALID_URL = r"""(?x)(?:
1553                         (?:https?://)?
1554                         (?:\w+\.)?
1555                         youtube\.com/
1556                         (?:
1557                            (?:course|view_play_list|my_playlists|artist|playlist|watch|embed/videoseries)
1558                            \? (?:.*?[&;])*? (?:p|a|list)=
1559                         |  p/
1560                         )
1561                         (
1562                             (?:PL|LL|EC|UU|FL|RD|UL)?[0-9A-Za-z-_]{10,}
1563                             # Top tracks, they can also include dots
1564                             |(?:MC)[\w\.]*
1565                         )
1566                         .*
1567                      |
1568                         ((?:PL|LL|EC|UU|FL|RD|UL)[0-9A-Za-z-_]{10,})
1569                      )"""
1570     _TEMPLATE_URL = 'https://www.youtube.com/playlist?list=%s'
1571     _VIDEO_RE = r'href="\s*/watch\?v=(?P<id>[0-9A-Za-z_-]{11})&amp;[^"]*?index=(?P<index>\d+)(?:[^>]+>(?P<title>[^<]+))?'
1572     IE_NAME = 'youtube:playlist'
1573     _TESTS = [{
1574         'url': 'https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re',
1575         'info_dict': {
1576             'title': 'ytdl test PL',
1577             'id': 'PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re',
1578         },
1579         'playlist_count': 3,
1580     }, {
1581         'url': 'https://www.youtube.com/playlist?list=PLtPgu7CB4gbZDA7i_euNxn75ISqxwZPYx',
1582         'info_dict': {
1583             'id': 'PLtPgu7CB4gbZDA7i_euNxn75ISqxwZPYx',
1584             'title': 'YDL_Empty_List',
1585         },
1586         'playlist_count': 0,
1587     }, {
1588         'note': 'Playlist with deleted videos (#651). As a bonus, the video #51 is also twice in this list.',
1589         'url': 'https://www.youtube.com/playlist?list=PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
1590         'info_dict': {
1591             'title': '29C3: Not my department',
1592             'id': 'PLwP_SiAcdui0KVebT0mU9Apz359a4ubsC',
1593         },
1594         'playlist_count': 95,
1595     }, {
1596         'note': 'issue #673',
1597         'url': 'PLBB231211A4F62143',
1598         'info_dict': {
1599             'title': '[OLD]Team Fortress 2 (Class-based LP)',
1600             'id': 'PLBB231211A4F62143',
1601         },
1602         'playlist_mincount': 26,
1603     }, {
1604         'note': 'Large playlist',
1605         'url': 'https://www.youtube.com/playlist?list=UUBABnxM4Ar9ten8Mdjj1j0Q',
1606         'info_dict': {
1607             'title': 'Uploads from Cauchemar',
1608             'id': 'UUBABnxM4Ar9ten8Mdjj1j0Q',
1609         },
1610         'playlist_mincount': 799,
1611     }, {
1612         'url': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
1613         'info_dict': {
1614             'title': 'YDL_safe_search',
1615             'id': 'PLtPgu7CB4gbY9oDN3drwC3cMbJggS7dKl',
1616         },
1617         'playlist_count': 2,
1618     }, {
1619         'note': 'embedded',
1620         'url': 'http://www.youtube.com/embed/videoseries?list=PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
1621         'playlist_count': 4,
1622         'info_dict': {
1623             'title': 'JODA15',
1624             'id': 'PL6IaIsEjSbf96XFRuNccS_RuEXwNdsoEu',
1625         }
1626     }, {
1627         'note': 'Embedded SWF player',
1628         'url': 'http://www.youtube.com/p/YN5VISEtHet5D4NEvfTd0zcgFk84NqFZ?hl=en_US&fs=1&rel=0',
1629         'playlist_count': 4,
1630         'info_dict': {
1631             'title': 'JODA7',
1632             'id': 'YN5VISEtHet5D4NEvfTd0zcgFk84NqFZ',
1633         }
1634     }, {
1635         'note': 'Buggy playlist: the webpage has a "Load more" button but it doesn\'t have more videos',
1636         'url': 'https://www.youtube.com/playlist?list=UUXw-G3eDE9trcvY2sBMM_aA',
1637         'info_dict': {
1638             'title': 'Uploads from Interstellar Movie',
1639             'id': 'UUXw-G3eDE9trcvY2sBMM_aA',
1640         },
1641         'playlist_mincout': 21,
1642     }]
1643
1644     def _real_initialize(self):
1645         self._login()
1646
1647     def _extract_mix(self, playlist_id):
1648         # The mixes are generated from a single video
1649         # the id of the playlist is just 'RD' + video_id
1650         url = 'https://youtube.com/watch?v=%s&list=%s' % (playlist_id[-11:], playlist_id)
1651         webpage = self._download_webpage(
1652             url, playlist_id, 'Downloading Youtube mix')
1653         search_title = lambda class_name: get_element_by_attribute('class', class_name, webpage)
1654         title_span = (
1655             search_title('playlist-title') or
1656             search_title('title long-title') or
1657             search_title('title'))
1658         title = clean_html(title_span)
1659         ids = orderedSet(re.findall(
1660             r'''(?xs)data-video-username=".*?".*?
1661                        href="/watch\?v=([0-9A-Za-z_-]{11})&amp;[^"]*?list=%s''' % re.escape(playlist_id),
1662             webpage))
1663         url_results = self._ids_to_results(ids)
1664
1665         return self.playlist_result(url_results, playlist_id, title)
1666
1667     def _extract_playlist(self, playlist_id):
1668         url = self._TEMPLATE_URL % playlist_id
1669         page = self._download_webpage(url, playlist_id)
1670
1671         for match in re.findall(r'<div class="yt-alert-message">([^<]+)</div>', page):
1672             match = match.strip()
1673             # Check if the playlist exists or is private
1674             if re.match(r'[^<]*(The|This) playlist (does not exist|is private)[^<]*', match):
1675                 raise ExtractorError(
1676                     'The playlist doesn\'t exist or is private, use --username or '
1677                     '--netrc to access it.',
1678                     expected=True)
1679             elif re.match(r'[^<]*Invalid parameters[^<]*', match):
1680                 raise ExtractorError(
1681                     'Invalid parameters. Maybe URL is incorrect.',
1682                     expected=True)
1683             elif re.match(r'[^<]*Choose your language[^<]*', match):
1684                 continue
1685             else:
1686                 self.report_warning('Youtube gives an alert message: ' + match)
1687
1688         playlist_title = self._html_search_regex(
1689             r'(?s)<h1 class="pl-header-title[^"]*"[^>]*>\s*(.*?)\s*</h1>',
1690             page, 'title')
1691
1692         return self.playlist_result(self._entries(page, playlist_id), playlist_id, playlist_title)
1693
1694     def _real_extract(self, url):
1695         # Extract playlist id
1696         mobj = re.match(self._VALID_URL, url)
1697         if mobj is None:
1698             raise ExtractorError('Invalid URL: %s' % url)
1699         playlist_id = mobj.group(1) or mobj.group(2)
1700
1701         # Check if it's a video-specific URL
1702         query_dict = compat_urlparse.parse_qs(compat_urlparse.urlparse(url).query)
1703         if 'v' in query_dict:
1704             video_id = query_dict['v'][0]
1705             if self._downloader.params.get('noplaylist'):
1706                 self.to_screen('Downloading just video %s because of --no-playlist' % video_id)
1707                 return self.url_result(video_id, 'Youtube', video_id=video_id)
1708             else:
1709                 self.to_screen('Downloading playlist %s - add --no-playlist to just download video %s' % (playlist_id, video_id))
1710
1711         if playlist_id.startswith('RD') or playlist_id.startswith('UL'):
1712             # Mixes require a custom extraction process
1713             return self._extract_mix(playlist_id)
1714
1715         return self._extract_playlist(playlist_id)
1716
1717
1718 class YoutubeChannelIE(YoutubePlaylistBaseInfoExtractor):
1719     IE_DESC = 'YouTube.com channels'
1720     _VALID_URL = r'https?://(?:youtu\.be|(?:\w+\.)?youtube(?:-nocookie)?\.com)/channel/(?P<id>[0-9A-Za-z_-]+)'
1721     _TEMPLATE_URL = 'https://www.youtube.com/channel/%s/videos'
1722     _VIDEO_RE = r'(?:title="(?P<title>[^"]+)"[^>]+)?href="/watch\?v=(?P<id>[0-9A-Za-z_-]+)&?'
1723     IE_NAME = 'youtube:channel'
1724     _TESTS = [{
1725         'note': 'paginated channel',
1726         'url': 'https://www.youtube.com/channel/UCKfVa3S1e4PHvxWcwyMMg8w',
1727         'playlist_mincount': 91,
1728         'info_dict': {
1729             'id': 'UUKfVa3S1e4PHvxWcwyMMg8w',
1730             'title': 'Uploads from lex will',
1731         }
1732     }, {
1733         'note': 'Age restricted channel',
1734         # from https://www.youtube.com/user/DeusExOfficial
1735         'url': 'https://www.youtube.com/channel/UCs0ifCMCm1icqRbqhUINa0w',
1736         'playlist_mincount': 64,
1737         'info_dict': {
1738             'id': 'UUs0ifCMCm1icqRbqhUINa0w',
1739             'title': 'Uploads from Deus Ex',
1740         },
1741     }]
1742
1743     @classmethod
1744     def suitable(cls, url):
1745         return False if YoutubePlaylistsIE.suitable(url) else super(YoutubeChannelIE, cls).suitable(url)
1746
1747     def _real_extract(self, url):
1748         channel_id = self._match_id(url)
1749
1750         url = self._TEMPLATE_URL % channel_id
1751
1752         # Channel by page listing is restricted to 35 pages of 30 items, i.e. 1050 videos total (see #5778)
1753         # Workaround by extracting as a playlist if managed to obtain channel playlist URL
1754         # otherwise fallback on channel by page extraction
1755         channel_page = self._download_webpage(
1756             url + '?view=57', channel_id,
1757             'Downloading channel page', fatal=False)
1758         if channel_page is False:
1759             channel_playlist_id = False
1760         else:
1761             channel_playlist_id = self._html_search_meta(
1762                 'channelId', channel_page, 'channel id', default=None)
1763             if not channel_playlist_id:
1764                 channel_playlist_id = self._search_regex(
1765                     r'data-(?:channel-external-|yt)id="([^"]+)"',
1766                     channel_page, 'channel id', default=None)
1767         if channel_playlist_id and channel_playlist_id.startswith('UC'):
1768             playlist_id = 'UU' + channel_playlist_id[2:]
1769             return self.url_result(
1770                 compat_urlparse.urljoin(url, '/playlist?list=%s' % playlist_id), 'YoutubePlaylist')
1771
1772         channel_page = self._download_webpage(url, channel_id, 'Downloading page #1')
1773         autogenerated = re.search(r'''(?x)
1774                 class="[^"]*?(?:
1775                     channel-header-autogenerated-label|
1776                     yt-channel-title-autogenerated
1777                 )[^"]*"''', channel_page) is not None
1778
1779         if autogenerated:
1780             # The videos are contained in a single page
1781             # the ajax pages can't be used, they are empty
1782             entries = [
1783                 self.url_result(
1784                     video_id, 'Youtube', video_id=video_id,
1785                     video_title=video_title)
1786                 for video_id, video_title in self.extract_videos_from_page(channel_page)]
1787             return self.playlist_result(entries, channel_id)
1788
1789         return self.playlist_result(self._entries(channel_page, channel_id), channel_id)
1790
1791
1792 class YoutubeUserIE(YoutubeChannelIE):
1793     IE_DESC = 'YouTube.com user videos (URL or "ytuser" keyword)'
1794     _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_-]+)'
1795     _TEMPLATE_URL = 'https://www.youtube.com/user/%s/videos'
1796     IE_NAME = 'youtube:user'
1797
1798     _TESTS = [{
1799         'url': 'https://www.youtube.com/user/TheLinuxFoundation',
1800         'playlist_mincount': 320,
1801         'info_dict': {
1802             'title': 'TheLinuxFoundation',
1803         }
1804     }, {
1805         'url': 'ytuser:phihag',
1806         'only_matching': True,
1807     }]
1808
1809     @classmethod
1810     def suitable(cls, url):
1811         # Don't return True if the url can be extracted with other youtube
1812         # extractor, the regex would is too permissive and it would match.
1813         other_ies = iter(klass for (name, klass) in globals().items() if name.endswith('IE') and klass is not cls)
1814         if any(ie.suitable(url) for ie in other_ies):
1815             return False
1816         else:
1817             return super(YoutubeUserIE, cls).suitable(url)
1818
1819
1820 class YoutubePlaylistsIE(YoutubePlaylistsBaseInfoExtractor):
1821     IE_DESC = 'YouTube.com user/channel playlists'
1822     _VALID_URL = r'https?://(?:\w+\.)?youtube\.com/(?:user|channel)/(?P<id>[^/]+)/playlists'
1823     IE_NAME = 'youtube:playlists'
1824
1825     _TESTS = [{
1826         'url': 'http://www.youtube.com/user/ThirstForScience/playlists',
1827         'playlist_mincount': 4,
1828         'info_dict': {
1829             'id': 'ThirstForScience',
1830             'title': 'Thirst for Science',
1831         },
1832     }, {
1833         # with "Load more" button
1834         'url': 'http://www.youtube.com/user/igorkle1/playlists?view=1&sort=dd',
1835         'playlist_mincount': 70,
1836         'info_dict': {
1837             'id': 'igorkle1',
1838             'title': 'Игорь Клейнер',
1839         },
1840     }, {
1841         'url': 'https://www.youtube.com/channel/UCiU1dHvZObB2iP6xkJ__Icw/playlists',
1842         'playlist_mincount': 17,
1843         'info_dict': {
1844             'id': 'UCiU1dHvZObB2iP6xkJ__Icw',
1845             'title': 'Chem Player',
1846         },
1847     }]
1848
1849
1850 class YoutubeSearchIE(SearchInfoExtractor, YoutubePlaylistIE):
1851     IE_DESC = 'YouTube.com searches'
1852     # there doesn't appear to be a real limit, for example if you search for
1853     # 'python' you get more than 8.000.000 results
1854     _MAX_RESULTS = float('inf')
1855     IE_NAME = 'youtube:search'
1856     _SEARCH_KEY = 'ytsearch'
1857     _EXTRA_QUERY_ARGS = {}
1858     _TESTS = []
1859
1860     def _get_n_results(self, query, n):
1861         """Get a specified number of results for a query"""
1862
1863         videos = []
1864         limit = n
1865
1866         for pagenum in itertools.count(1):
1867             url_query = {
1868                 'search_query': query.encode('utf-8'),
1869                 'page': pagenum,
1870                 'spf': 'navigate',
1871             }
1872             url_query.update(self._EXTRA_QUERY_ARGS)
1873             result_url = 'https://www.youtube.com/results?' + compat_urllib_parse.urlencode(url_query)
1874             data = self._download_json(
1875                 result_url, video_id='query "%s"' % query,
1876                 note='Downloading page %s' % pagenum,
1877                 errnote='Unable to download API page')
1878             html_content = data[1]['body']['content']
1879
1880             if 'class="search-message' in html_content:
1881                 raise ExtractorError(
1882                     '[youtube] No video results', expected=True)
1883
1884             new_videos = self._ids_to_results(orderedSet(re.findall(
1885                 r'href="/watch\?v=(.{11})', html_content)))
1886             videos += new_videos
1887             if not new_videos or len(videos) > limit:
1888                 break
1889
1890         if len(videos) > n:
1891             videos = videos[:n]
1892         return self.playlist_result(videos, query)
1893
1894
1895 class YoutubeSearchDateIE(YoutubeSearchIE):
1896     IE_NAME = YoutubeSearchIE.IE_NAME + ':date'
1897     _SEARCH_KEY = 'ytsearchdate'
1898     IE_DESC = 'YouTube.com searches, newest videos first'
1899     _EXTRA_QUERY_ARGS = {'search_sort': 'video_date_uploaded'}
1900
1901
1902 class YoutubeSearchURLIE(InfoExtractor):
1903     IE_DESC = 'YouTube.com search URLs'
1904     IE_NAME = 'youtube:search_url'
1905     _VALID_URL = r'https?://(?:www\.)?youtube\.com/results\?(.*?&)?search_query=(?P<query>[^&]+)(?:[&]|$)'
1906     _TESTS = [{
1907         'url': 'https://www.youtube.com/results?baz=bar&search_query=youtube-dl+test+video&filters=video&lclk=video',
1908         'playlist_mincount': 5,
1909         'info_dict': {
1910             'title': 'youtube-dl test video',
1911         }
1912     }]
1913
1914     def _real_extract(self, url):
1915         mobj = re.match(self._VALID_URL, url)
1916         query = compat_urllib_parse_unquote_plus(mobj.group('query'))
1917
1918         webpage = self._download_webpage(url, query)
1919         result_code = self._search_regex(
1920             r'(?s)<ol[^>]+class="item-section"(.*?)</ol>', webpage, 'result HTML')
1921
1922         part_codes = re.findall(
1923             r'(?s)<h3[^>]+class="[^"]*yt-lockup-title[^"]*"[^>]*>(.*?)</h3>', result_code)
1924         entries = []
1925         for part_code in part_codes:
1926             part_title = self._html_search_regex(
1927                 [r'(?s)title="([^"]+)"', r'>([^<]+)</a>'], part_code, 'item title', fatal=False)
1928             part_url_snippet = self._html_search_regex(
1929                 r'(?s)href="([^"]+)"', part_code, 'item URL')
1930             part_url = compat_urlparse.urljoin(
1931                 'https://www.youtube.com/', part_url_snippet)
1932             entries.append({
1933                 '_type': 'url',
1934                 'url': part_url,
1935                 'title': part_title,
1936             })
1937
1938         return {
1939             '_type': 'playlist',
1940             'entries': entries,
1941             'title': query,
1942         }
1943
1944
1945 class YoutubeShowIE(YoutubePlaylistsBaseInfoExtractor):
1946     IE_DESC = 'YouTube.com (multi-season) shows'
1947     _VALID_URL = r'https?://www\.youtube\.com/show/(?P<id>[^?#]*)'
1948     IE_NAME = 'youtube:show'
1949     _TESTS = [{
1950         'url': 'https://www.youtube.com/show/airdisasters',
1951         'playlist_mincount': 5,
1952         'info_dict': {
1953             'id': 'airdisasters',
1954             'title': 'Air Disasters',
1955         }
1956     }]
1957
1958     def _real_extract(self, url):
1959         playlist_id = self._match_id(url)
1960         return super(YoutubeShowIE, self)._real_extract(
1961             'https://www.youtube.com/show/%s/playlists' % playlist_id)
1962
1963
1964 class YoutubeFeedsInfoExtractor(YoutubeBaseInfoExtractor):
1965     """
1966     Base class for feed extractors
1967     Subclasses must define the _FEED_NAME and _PLAYLIST_TITLE properties.
1968     """
1969     _LOGIN_REQUIRED = True
1970
1971     @property
1972     def IE_NAME(self):
1973         return 'youtube:%s' % self._FEED_NAME
1974
1975     def _real_initialize(self):
1976         self._login()
1977
1978     def _real_extract(self, url):
1979         page = self._download_webpage(
1980             'https://www.youtube.com/feed/%s' % self._FEED_NAME, self._PLAYLIST_TITLE)
1981
1982         # The extraction process is the same as for playlists, but the regex
1983         # for the video ids doesn't contain an index
1984         ids = []
1985         more_widget_html = content_html = page
1986         for page_num in itertools.count(1):
1987             matches = re.findall(r'href="\s*/watch\?v=([0-9A-Za-z_-]{11})', content_html)
1988
1989             # 'recommended' feed has infinite 'load more' and each new portion spins
1990             # the same videos in (sometimes) slightly different order, so we'll check
1991             # for unicity and break when portion has no new videos
1992             new_ids = filter(lambda video_id: video_id not in ids, orderedSet(matches))
1993             if not new_ids:
1994                 break
1995
1996             ids.extend(new_ids)
1997
1998             mobj = re.search(r'data-uix-load-more-href="/?(?P<more>[^"]+)"', more_widget_html)
1999             if not mobj:
2000                 break
2001
2002             more = self._download_json(
2003                 'https://youtube.com/%s' % mobj.group('more'), self._PLAYLIST_TITLE,
2004                 'Downloading page #%s' % page_num,
2005                 transform_source=uppercase_escape)
2006             content_html = more['content_html']
2007             more_widget_html = more['load_more_widget_html']
2008
2009         return self.playlist_result(
2010             self._ids_to_results(ids), playlist_title=self._PLAYLIST_TITLE)
2011
2012
2013 class YoutubeWatchLaterIE(YoutubePlaylistIE):
2014     IE_NAME = 'youtube:watchlater'
2015     IE_DESC = 'Youtube watch later list, ":ytwatchlater" for short (requires authentication)'
2016     _VALID_URL = r'https?://www\.youtube\.com/(?:feed/watch_later|playlist\?list=WL)|:ytwatchlater'
2017
2018     _TESTS = []  # override PlaylistIE tests
2019
2020     def _real_extract(self, url):
2021         return self._extract_playlist('WL')
2022
2023
2024 class YoutubeFavouritesIE(YoutubeBaseInfoExtractor):
2025     IE_NAME = 'youtube:favorites'
2026     IE_DESC = 'YouTube.com favourite videos, ":ytfav" for short (requires authentication)'
2027     _VALID_URL = r'https?://www\.youtube\.com/my_favorites|:ytfav(?:ou?rites)?'
2028     _LOGIN_REQUIRED = True
2029
2030     def _real_extract(self, url):
2031         webpage = self._download_webpage('https://www.youtube.com/my_favorites', 'Youtube Favourites videos')
2032         playlist_id = self._search_regex(r'list=(.+?)["&]', webpage, 'favourites playlist id')
2033         return self.url_result(playlist_id, 'YoutubePlaylist')
2034
2035
2036 class YoutubeRecommendedIE(YoutubeFeedsInfoExtractor):
2037     IE_DESC = 'YouTube.com recommended videos, ":ytrec" for short (requires authentication)'
2038     _VALID_URL = r'https?://www\.youtube\.com/feed/recommended|:ytrec(?:ommended)?'
2039     _FEED_NAME = 'recommended'
2040     _PLAYLIST_TITLE = 'Youtube Recommended videos'
2041
2042
2043 class YoutubeSubscriptionsIE(YoutubeFeedsInfoExtractor):
2044     IE_DESC = 'YouTube.com subscriptions feed, "ytsubs" keyword (requires authentication)'
2045     _VALID_URL = r'https?://www\.youtube\.com/feed/subscriptions|:ytsubs(?:criptions)?'
2046     _FEED_NAME = 'subscriptions'
2047     _PLAYLIST_TITLE = 'Youtube Subscriptions'
2048
2049
2050 class YoutubeHistoryIE(YoutubeFeedsInfoExtractor):
2051     IE_DESC = 'Youtube watch history, ":ythistory" for short (requires authentication)'
2052     _VALID_URL = 'https?://www\.youtube\.com/feed/history|:ythistory'
2053     _FEED_NAME = 'history'
2054     _PLAYLIST_TITLE = 'Youtube History'
2055
2056
2057 class YoutubeTruncatedURLIE(InfoExtractor):
2058     IE_NAME = 'youtube:truncated_url'
2059     IE_DESC = False  # Do not list
2060     _VALID_URL = r'''(?x)
2061         (?:https?://)?
2062         (?:\w+\.)?[yY][oO][uU][tT][uU][bB][eE](?:-nocookie)?\.com/
2063         (?:watch\?(?:
2064             feature=[a-z_]+|
2065             annotation_id=annotation_[^&]+|
2066             x-yt-cl=[0-9]+|
2067             hl=[^&]*|
2068             t=[0-9]+
2069         )?
2070         |
2071             attribution_link\?a=[^&]+
2072         )
2073         $
2074     '''
2075
2076     _TESTS = [{
2077         'url': 'http://www.youtube.com/watch?annotation_id=annotation_3951667041',
2078         'only_matching': True,
2079     }, {
2080         'url': 'http://www.youtube.com/watch?',
2081         'only_matching': True,
2082     }, {
2083         'url': 'https://www.youtube.com/watch?x-yt-cl=84503534',
2084         'only_matching': True,
2085     }, {
2086         'url': 'https://www.youtube.com/watch?feature=foo',
2087         'only_matching': True,
2088     }, {
2089         'url': 'https://www.youtube.com/watch?hl=en-GB',
2090         'only_matching': True,
2091     }, {
2092         'url': 'https://www.youtube.com/watch?t=2372',
2093         'only_matching': True,
2094     }]
2095
2096     def _real_extract(self, url):
2097         raise ExtractorError(
2098             'Did you forget to quote the URL? Remember that & is a meta '
2099             'character in most shells, so you want to put the URL in quotes, '
2100             'like  youtube-dl '
2101             '"http://www.youtube.com/watch?feature=foo&v=BaW_jenozKc" '
2102             ' or simply  youtube-dl BaW_jenozKc  .',
2103             expected=True)
2104
2105
2106 class YoutubeTruncatedIDIE(InfoExtractor):
2107     IE_NAME = 'youtube:truncated_id'
2108     IE_DESC = False  # Do not list
2109     _VALID_URL = r'https?://(?:www\.)?youtube\.com/watch\?v=(?P<id>[0-9A-Za-z_-]{1,10})$'
2110
2111     _TESTS = [{
2112         'url': 'https://www.youtube.com/watch?v=N_708QY7Ob',
2113         'only_matching': True,
2114     }]
2115
2116     def _real_extract(self, url):
2117         video_id = self._match_id(url)
2118         raise ExtractorError(
2119             'Incomplete YouTube ID %s. URL %s looks truncated.' % (video_id, url),
2120             expected=True)