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