2 # -*- coding: utf-8 -*-
5 'Ricardo Garcia Gonzalez',
13 'Philipp Hagemeister',
20 __license__ = 'Public Domain'
21 __version__ = '2012.02.27'
23 UPDATE_URL = 'https://raw.github.com/rg3/youtube-dl/master/youtube-dl'
56 except ImportError: # Python 2.4
59 import cStringIO as StringIO
63 # parse_qs was moved from the cgi module to the urlparse module recently.
65 from urlparse import parse_qs
67 from cgi import parse_qs
75 import xml.etree.ElementTree
76 except ImportError: # Python<2.5: Not officially supported, but let it slip
77 warnings.warn('xml.etree.ElementTree support is missing. Consider upgrading to Python >= 2.5 if you get related errors.')
80 'User-Agent': 'Mozilla/5.0 (X11; Linux x86_64; rv:5.0.1) Gecko/20100101 Firefox/5.0.1',
81 'Accept-Charset': 'ISO-8859-1,utf-8;q=0.7,*;q=0.7',
82 'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
83 'Accept-Encoding': 'gzip, deflate',
84 'Accept-Language': 'en-us,en;q=0.5',
89 except ImportError: # Python <2.6, use trivialjson (https://github.com/phihag/trivialjson):
95 def raiseError(msg, i):
96 raise ValueError(msg + ' at position ' + str(i) + ' of ' + repr(s) + ': ' + repr(s[i:]))
97 def skipSpace(i, expectMore=True):
98 while i < len(s) and s[i] in ' \t\r\n':
102 raiseError('Premature end', i)
104 def decodeEscape(match):
120 return unichr(int(esc[1:5], 16))
121 if len(esc) == 5+6 and esc[5:7] == '\\u':
122 hi = int(esc[1:5], 16)
123 low = int(esc[7:11], 16)
124 return unichr((hi - 0xd800) * 0x400 + low - 0xdc00 + 0x10000)
125 raise ValueError('Unknown escape ' + str(esc))
132 while s[e-bslashes-1] == '\\':
134 if bslashes % 2 == 1:
138 rexp = re.compile(r'\\(u[dD][89aAbB][0-9a-fA-F]{2}\\u[0-9a-fA-F]{4}|u[0-9a-fA-F]{4}|.|$)')
139 stri = rexp.sub(decodeEscape, s[i:e])
145 if s[i] == '}': # Empty dictionary
149 raiseError('Expected a string object key', i)
150 i,key = parseString(i)
152 if i >= len(s) or s[i] != ':':
153 raiseError('Expected a colon', i)
160 raiseError('Expected comma or closing curly brace', i)
165 if s[i] == ']': # Empty array
170 i = skipSpace(i) # Raise exception if premature end
174 raiseError('Expected a comma or closing bracket', i)
176 def parseDiscrete(i):
177 for k,v in {'true': True, 'false': False, 'null': None}.items():
178 if s.startswith(k, i):
180 raiseError('Not a boolean (or null)', i)
182 mobj = re.match('^(-?(0|[1-9][0-9]*)(\.[0-9]*)?([eE][+-]?[0-9]+)?)', s[i:])
184 raiseError('Not a number', i)
186 if '.' in nums or 'e' in nums or 'E' in nums:
187 return (i+len(nums), float(nums))
188 return (i+len(nums), int(nums))
189 CHARMAP = {'{': parseObj, '[': parseArray, '"': parseString, 't': parseDiscrete, 'f': parseDiscrete, 'n': parseDiscrete}
192 i,res = CHARMAP.get(s[i], parseNumber)(i)
193 i = skipSpace(i, False)
197 raise ValueError('Extra data at end of input (index ' + str(i) + ' of ' + repr(s) + ': ' + repr(s[i:]) + ')')
200 def preferredencoding():
201 """Get preferred encoding.
203 Returns the best encoding scheme for the system, based on
204 locale.getpreferredencoding() and some further tweaks.
206 def yield_preferredencoding():
208 pref = locale.getpreferredencoding()
214 return yield_preferredencoding().next()
217 def htmlentity_transform(matchobj):
218 """Transforms an HTML entity to a Unicode character.
220 This function receives a match object and is intended to be used with
221 the re.sub() function.
223 entity = matchobj.group(1)
225 # Known non-numeric HTML entity
226 if entity in htmlentitydefs.name2codepoint:
227 return unichr(htmlentitydefs.name2codepoint[entity])
230 mobj = re.match(ur'(?u)#(x?\d+)', entity)
232 numstr = mobj.group(1)
233 if numstr.startswith(u'x'):
235 numstr = u'0%s' % numstr
238 return unichr(long(numstr, base))
240 # Unknown entity in name, return its literal representation
241 return (u'&%s;' % entity)
244 def sanitize_title(utitle):
245 """Sanitizes a video title so it could be used as part of a filename."""
246 utitle = re.sub(ur'(?u)&(.+?);', htmlentity_transform, utitle)
247 return utitle.replace(unicode(os.sep), u'%')
250 def sanitize_open(filename, open_mode):
251 """Try to open the given filename, and slightly tweak it if this fails.
253 Attempts to open the given filename. If this fails, it tries to change
254 the filename slightly, step by step, until it's either able to open it
255 or it fails and raises a final exception, like the standard open()
258 It returns the tuple (stream, definitive_file_name).
262 if sys.platform == 'win32':
264 msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
265 return (sys.stdout, filename)
266 stream = open(_encodeFilename(filename), open_mode)
267 return (stream, filename)
268 except (IOError, OSError), err:
269 # In case of error, try to remove win32 forbidden chars
270 filename = re.sub(ur'[/<>:"\|\?\*]', u'#', filename)
272 # An exception here should be caught in the caller
273 stream = open(_encodeFilename(filename), open_mode)
274 return (stream, filename)
277 def timeconvert(timestr):
278 """Convert RFC 2822 defined time string into system timestamp"""
280 timetuple = email.utils.parsedate_tz(timestr)
281 if timetuple is not None:
282 timestamp = email.utils.mktime_tz(timetuple)
285 def _simplify_title(title):
286 expr = re.compile(ur'[^\w\d_\-]+', flags=re.UNICODE)
287 return expr.sub(u'_', title).strip(u'_')
289 def _orderedSet(iterable):
290 """ Remove all duplicates from the input iterable """
297 def _unescapeHTML(s):
299 @param s a string (of type unicode)
301 assert type(s) == type(u'')
303 htmlParser = HTMLParser.HTMLParser()
304 return htmlParser.unescape(s)
306 def _encodeFilename(s):
308 @param s The name of the file (of type unicode)
311 assert type(s) == type(u'')
313 if sys.platform == 'win32' and sys.getwindowsversion().major >= 5:
314 # Pass u'' directly to use Unicode APIs on Windows 2000 and up
315 # (Detecting Windows NT 4 is tricky because 'major >= 4' would
316 # match Windows 9x series as well. Besides, NT 4 is obsolete.)
319 return s.encode(sys.getfilesystemencoding(), 'ignore')
321 class DownloadError(Exception):
322 """Download Error exception.
324 This exception may be thrown by FileDownloader objects if they are not
325 configured to continue on errors. They will contain the appropriate
331 class SameFileError(Exception):
332 """Same File exception.
334 This exception will be thrown by FileDownloader objects if they detect
335 multiple files would have to be downloaded to the same file on disk.
340 class PostProcessingError(Exception):
341 """Post Processing exception.
343 This exception may be raised by PostProcessor's .run() method to
344 indicate an error in the postprocessing task.
348 class MaxDownloadsReached(Exception):
349 """ --max-downloads limit has been reached. """
353 class UnavailableVideoError(Exception):
354 """Unavailable Format exception.
356 This exception will be thrown when a video is requested
357 in a format that is not available for that video.
362 class ContentTooShortError(Exception):
363 """Content Too Short exception.
365 This exception may be raised by FileDownloader objects when a file they
366 download is too small for what the server announced first, indicating
367 the connection was probably interrupted.
373 def __init__(self, downloaded, expected):
374 self.downloaded = downloaded
375 self.expected = expected
378 class YoutubeDLHandler(urllib2.HTTPHandler):
379 """Handler for HTTP requests and responses.
381 This class, when installed with an OpenerDirector, automatically adds
382 the standard headers to every HTTP request and handles gzipped and
383 deflated responses from web servers. If compression is to be avoided in
384 a particular request, the original request in the program code only has
385 to include the HTTP header "Youtubedl-No-Compression", which will be
386 removed before making the real request.
388 Part of this code was copied from:
390 http://techknack.net/python-urllib2-handlers/
392 Andrew Rowls, the author of that code, agreed to release it to the
399 return zlib.decompress(data, -zlib.MAX_WBITS)
401 return zlib.decompress(data)
404 def addinfourl_wrapper(stream, headers, url, code):
405 if hasattr(urllib2.addinfourl, 'getcode'):
406 return urllib2.addinfourl(stream, headers, url, code)
407 ret = urllib2.addinfourl(stream, headers, url)
411 def http_request(self, req):
412 for h in std_headers:
415 req.add_header(h, std_headers[h])
416 if 'Youtubedl-no-compression' in req.headers:
417 if 'Accept-encoding' in req.headers:
418 del req.headers['Accept-encoding']
419 del req.headers['Youtubedl-no-compression']
422 def http_response(self, req, resp):
425 if resp.headers.get('Content-encoding', '') == 'gzip':
426 gz = gzip.GzipFile(fileobj=StringIO.StringIO(resp.read()), mode='r')
427 resp = self.addinfourl_wrapper(gz, old_resp.headers, old_resp.url, old_resp.code)
428 resp.msg = old_resp.msg
430 if resp.headers.get('Content-encoding', '') == 'deflate':
431 gz = StringIO.StringIO(self.deflate(resp.read()))
432 resp = self.addinfourl_wrapper(gz, old_resp.headers, old_resp.url, old_resp.code)
433 resp.msg = old_resp.msg
437 class FileDownloader(object):
438 """File Downloader class.
440 File downloader objects are the ones responsible of downloading the
441 actual video file and writing it to disk if the user has requested
442 it, among some other tasks. In most cases there should be one per
443 program. As, given a video URL, the downloader doesn't know how to
444 extract all the needed information, task that InfoExtractors do, it
445 has to pass the URL to one of them.
447 For this, file downloader objects have a method that allows
448 InfoExtractors to be registered in a given order. When it is passed
449 a URL, the file downloader handles it to the first InfoExtractor it
450 finds that reports being able to handle it. The InfoExtractor extracts
451 all the information about the video or videos the URL refers to, and
452 asks the FileDownloader to process the video information, possibly
453 downloading the video.
455 File downloaders accept a lot of parameters. In order not to saturate
456 the object constructor with arguments, it receives a dictionary of
457 options instead. These options are available through the params
458 attribute for the InfoExtractors to use. The FileDownloader also
459 registers itself as the downloader in charge for the InfoExtractors
460 that are added to it, so this is a "mutual registration".
464 username: Username for authentication purposes.
465 password: Password for authentication purposes.
466 usenetrc: Use netrc for authentication instead.
467 quiet: Do not print messages to stdout.
468 forceurl: Force printing final URL.
469 forcetitle: Force printing title.
470 forcethumbnail: Force printing thumbnail URL.
471 forcedescription: Force printing description.
472 forcefilename: Force printing final filename.
473 simulate: Do not download the video files.
474 format: Video format code.
475 format_limit: Highest quality format to try.
476 outtmpl: Template for output names.
477 ignoreerrors: Do not stop on download errors.
478 ratelimit: Download speed limit, in bytes/sec.
479 nooverwrites: Prevent overwriting files.
480 retries: Number of times to retry for HTTP error 5xx
481 continuedl: Try to continue downloads if possible.
482 noprogress: Do not print the progress bar.
483 playliststart: Playlist item to start at.
484 playlistend: Playlist item to end at.
485 matchtitle: Download only matching titles.
486 rejecttitle: Reject downloads for matching titles.
487 logtostderr: Log messages to stderr instead of stdout.
488 consoletitle: Display progress in console window's titlebar.
489 nopart: Do not use temporary .part files.
490 updatetime: Use the Last-modified header to set output file timestamps.
491 writedescription: Write the video description to a .description file
492 writeinfojson: Write the video description to a .info.json file
498 _download_retcode = None
499 _num_downloads = None
502 def __init__(self, params):
503 """Create a FileDownloader object with the given options."""
506 self._download_retcode = 0
507 self._num_downloads = 0
508 self._screen_file = [sys.stdout, sys.stderr][params.get('logtostderr', False)]
512 def format_bytes(bytes):
515 if type(bytes) is str:
520 exponent = long(math.log(bytes, 1024.0))
521 suffix = 'bkMGTPEZY'[exponent]
522 converted = float(bytes) / float(1024 ** exponent)
523 return '%.2f%s' % (converted, suffix)
526 def calc_percent(byte_counter, data_len):
529 return '%6s' % ('%3.1f%%' % (float(byte_counter) / float(data_len) * 100.0))
532 def calc_eta(start, now, total, current):
536 if current == 0 or dif < 0.001: # One millisecond
538 rate = float(current) / dif
539 eta = long((float(total) - float(current)) / rate)
540 (eta_mins, eta_secs) = divmod(eta, 60)
543 return '%02d:%02d' % (eta_mins, eta_secs)
546 def calc_speed(start, now, bytes):
548 if bytes == 0 or dif < 0.001: # One millisecond
549 return '%10s' % '---b/s'
550 return '%10s' % ('%s/s' % FileDownloader.format_bytes(float(bytes) / dif))
553 def best_block_size(elapsed_time, bytes):
554 new_min = max(bytes / 2.0, 1.0)
555 new_max = min(max(bytes * 2.0, 1.0), 4194304) # Do not surpass 4 MB
556 if elapsed_time < 0.001:
558 rate = bytes / elapsed_time
566 def parse_bytes(bytestr):
567 """Parse a string indicating a byte quantity into a long integer."""
568 matchobj = re.match(r'(?i)^(\d+(?:\.\d+)?)([kMGTPEZY]?)$', bytestr)
571 number = float(matchobj.group(1))
572 multiplier = 1024.0 ** 'bkmgtpezy'.index(matchobj.group(2).lower())
573 return long(round(number * multiplier))
575 def add_info_extractor(self, ie):
576 """Add an InfoExtractor object to the end of the list."""
578 ie.set_downloader(self)
580 def add_post_processor(self, pp):
581 """Add a PostProcessor object to the end of the chain."""
583 pp.set_downloader(self)
585 def to_screen(self, message, skip_eol=False):
586 """Print message to stdout if not in quiet mode."""
587 assert type(message) == type(u'')
588 if not self.params.get('quiet', False):
589 terminator = [u'\n', u''][skip_eol]
590 output = message + terminator
592 if 'b' not in self._screen_file.mode or sys.version_info[0] < 3: # Python 2 lies about the mode of sys.stdout/sys.stderr
593 output = output.encode(preferredencoding(), 'ignore')
594 self._screen_file.write(output)
595 self._screen_file.flush()
597 def to_stderr(self, message):
598 """Print message to stderr."""
599 print >>sys.stderr, message.encode(preferredencoding())
601 def to_cons_title(self, message):
602 """Set console/terminal window title to message."""
603 if not self.params.get('consoletitle', False):
605 if os.name == 'nt' and ctypes.windll.kernel32.GetConsoleWindow():
606 # c_wchar_p() might not be necessary if `message` is
607 # already of type unicode()
608 ctypes.windll.kernel32.SetConsoleTitleW(ctypes.c_wchar_p(message))
609 elif 'TERM' in os.environ:
610 sys.stderr.write('\033]0;%s\007' % message.encode(preferredencoding()))
612 def fixed_template(self):
613 """Checks if the output template is fixed."""
614 return (re.search(ur'(?u)%\(.+?\)s', self.params['outtmpl']) is None)
616 def trouble(self, message=None):
617 """Determine action to take when a download problem appears.
619 Depending on if the downloader has been configured to ignore
620 download errors or not, this method may throw an exception or
621 not when errors are found, after printing the message.
623 if message is not None:
624 self.to_stderr(message)
625 if not self.params.get('ignoreerrors', False):
626 raise DownloadError(message)
627 self._download_retcode = 1
629 def slow_down(self, start_time, byte_counter):
630 """Sleep if the download speed is over the rate limit."""
631 rate_limit = self.params.get('ratelimit', None)
632 if rate_limit is None or byte_counter == 0:
635 elapsed = now - start_time
638 speed = float(byte_counter) / elapsed
639 if speed > rate_limit:
640 time.sleep((byte_counter - rate_limit * (now - start_time)) / rate_limit)
642 def temp_name(self, filename):
643 """Returns a temporary filename for the given filename."""
644 if self.params.get('nopart', False) or filename == u'-' or \
645 (os.path.exists(_encodeFilename(filename)) and not os.path.isfile(_encodeFilename(filename))):
647 return filename + u'.part'
649 def undo_temp_name(self, filename):
650 if filename.endswith(u'.part'):
651 return filename[:-len(u'.part')]
654 def try_rename(self, old_filename, new_filename):
656 if old_filename == new_filename:
658 os.rename(_encodeFilename(old_filename), _encodeFilename(new_filename))
659 except (IOError, OSError), err:
660 self.trouble(u'ERROR: unable to rename file')
662 def try_utime(self, filename, last_modified_hdr):
663 """Try to set the last-modified time of the given file."""
664 if last_modified_hdr is None:
666 if not os.path.isfile(_encodeFilename(filename)):
668 timestr = last_modified_hdr
671 filetime = timeconvert(timestr)
675 os.utime(filename, (time.time(), filetime))
680 def report_writedescription(self, descfn):
681 """ Report that the description file is being written """
682 self.to_screen(u'[info] Writing video description to: ' + descfn)
684 def report_writeinfojson(self, infofn):
685 """ Report that the metadata file has been written """
686 self.to_screen(u'[info] Video description metadata as JSON to: ' + infofn)
688 def report_destination(self, filename):
689 """Report destination filename."""
690 self.to_screen(u'[download] Destination: ' + filename)
692 def report_progress(self, percent_str, data_len_str, speed_str, eta_str):
693 """Report download progress."""
694 if self.params.get('noprogress', False):
696 self.to_screen(u'\r[download] %s of %s at %s ETA %s' %
697 (percent_str, data_len_str, speed_str, eta_str), skip_eol=True)
698 self.to_cons_title(u'youtube-dl - %s of %s at %s ETA %s' %
699 (percent_str.strip(), data_len_str.strip(), speed_str.strip(), eta_str.strip()))
701 def report_resuming_byte(self, resume_len):
702 """Report attempt to resume at given byte."""
703 self.to_screen(u'[download] Resuming download at byte %s' % resume_len)
705 def report_retry(self, count, retries):
706 """Report retry in case of HTTP error 5xx"""
707 self.to_screen(u'[download] Got server HTTP error. Retrying (attempt %d of %d)...' % (count, retries))
709 def report_file_already_downloaded(self, file_name):
710 """Report file has already been fully downloaded."""
712 self.to_screen(u'[download] %s has already been downloaded' % file_name)
713 except (UnicodeEncodeError), err:
714 self.to_screen(u'[download] The file has already been downloaded')
716 def report_unable_to_resume(self):
717 """Report it was impossible to resume download."""
718 self.to_screen(u'[download] Unable to resume')
720 def report_finish(self):
721 """Report download finished."""
722 if self.params.get('noprogress', False):
723 self.to_screen(u'[download] Download completed')
727 def increment_downloads(self):
728 """Increment the ordinal that assigns a number to each file."""
729 self._num_downloads += 1
731 def prepare_filename(self, info_dict):
732 """Generate the output filename."""
734 template_dict = dict(info_dict)
735 template_dict['epoch'] = unicode(long(time.time()))
736 template_dict['autonumber'] = unicode('%05d' % self._num_downloads)
737 filename = self.params['outtmpl'] % template_dict
739 except (ValueError, KeyError), err:
740 self.trouble(u'ERROR: invalid system charset or erroneous output template')
743 def _match_entry(self, info_dict):
744 """ Returns None iff the file should be downloaded """
746 title = info_dict['title']
747 matchtitle = self.params.get('matchtitle', False)
748 if matchtitle and not re.search(matchtitle, title, re.IGNORECASE):
749 return u'[download] "' + title + '" title did not match pattern "' + matchtitle + '"'
750 rejecttitle = self.params.get('rejecttitle', False)
751 if rejecttitle and re.search(rejecttitle, title, re.IGNORECASE):
752 return u'"' + title + '" title matched reject pattern "' + rejecttitle + '"'
755 def process_info(self, info_dict):
756 """Process a single dictionary returned by an InfoExtractor."""
758 reason = self._match_entry(info_dict)
759 if reason is not None:
760 self.to_screen(u'[download] ' + reason)
763 max_downloads = self.params.get('max_downloads')
764 if max_downloads is not None:
765 if self._num_downloads > int(max_downloads):
766 raise MaxDownloadsReached()
768 filename = self.prepare_filename(info_dict)
771 if self.params.get('forcetitle', False):
772 print info_dict['title'].encode(preferredencoding(), 'xmlcharrefreplace')
773 if self.params.get('forceurl', False):
774 print info_dict['url'].encode(preferredencoding(), 'xmlcharrefreplace')
775 if self.params.get('forcethumbnail', False) and 'thumbnail' in info_dict:
776 print info_dict['thumbnail'].encode(preferredencoding(), 'xmlcharrefreplace')
777 if self.params.get('forcedescription', False) and 'description' in info_dict:
778 print info_dict['description'].encode(preferredencoding(), 'xmlcharrefreplace')
779 if self.params.get('forcefilename', False) and filename is not None:
780 print filename.encode(preferredencoding(), 'xmlcharrefreplace')
781 if self.params.get('forceformat', False):
782 print info_dict['format'].encode(preferredencoding(), 'xmlcharrefreplace')
784 # Do nothing else if in simulate mode
785 if self.params.get('simulate', False):
792 dn = os.path.dirname(_encodeFilename(filename))
793 if dn != '' and not os.path.exists(dn): # dn is already encoded
795 except (OSError, IOError), err:
796 self.trouble(u'ERROR: unable to create directory ' + unicode(err))
799 if self.params.get('writedescription', False):
801 descfn = filename + u'.description'
802 self.report_writedescription(descfn)
803 descfile = open(_encodeFilename(descfn), 'wb')
805 descfile.write(info_dict['description'].encode('utf-8'))
808 except (OSError, IOError):
809 self.trouble(u'ERROR: Cannot write description file ' + descfn)
812 if self.params.get('writeinfojson', False):
813 infofn = filename + u'.info.json'
814 self.report_writeinfojson(infofn)
817 except (NameError,AttributeError):
818 self.trouble(u'ERROR: No JSON encoder found. Update to Python 2.6+, setup a json module, or leave out --write-info-json.')
821 infof = open(_encodeFilename(infofn), 'wb')
823 json_info_dict = dict((k,v) for k,v in info_dict.iteritems() if not k in ('urlhandle',))
824 json.dump(json_info_dict, infof)
827 except (OSError, IOError):
828 self.trouble(u'ERROR: Cannot write metadata to JSON file ' + infofn)
831 if not self.params.get('skip_download', False):
832 if self.params.get('nooverwrites', False) and os.path.exists(_encodeFilename(filename)):
836 success = self._do_download(filename, info_dict)
837 except (OSError, IOError), err:
838 raise UnavailableVideoError
839 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
840 self.trouble(u'ERROR: unable to download video data: %s' % str(err))
842 except (ContentTooShortError, ), err:
843 self.trouble(u'ERROR: content too short (expected %s bytes and served %s)' % (err.expected, err.downloaded))
848 self.post_process(filename, info_dict)
849 except (PostProcessingError), err:
850 self.trouble(u'ERROR: postprocessing: %s' % str(err))
853 def download(self, url_list):
854 """Download a given list of URLs."""
855 if len(url_list) > 1 and self.fixed_template():
856 raise SameFileError(self.params['outtmpl'])
859 suitable_found = False
861 # Go to next InfoExtractor if not suitable
862 if not ie.suitable(url):
865 # Suitable InfoExtractor found
866 suitable_found = True
868 # Extract information from URL and process it
871 # Suitable InfoExtractor had been found; go to next URL
874 if not suitable_found:
875 self.trouble(u'ERROR: no suitable InfoExtractor: %s' % url)
877 return self._download_retcode
879 def post_process(self, filename, ie_info):
880 """Run the postprocessing chain on the given file."""
882 info['filepath'] = filename
888 def _download_with_rtmpdump(self, filename, url, player_url):
889 self.report_destination(filename)
890 tmpfilename = self.temp_name(filename)
892 # Check for rtmpdump first
894 subprocess.call(['rtmpdump', '-h'], stdout=(file(os.path.devnull, 'w')), stderr=subprocess.STDOUT)
895 except (OSError, IOError):
896 self.trouble(u'ERROR: RTMP download detected but "rtmpdump" could not be run')
899 # Download using rtmpdump. rtmpdump returns exit code 2 when
900 # the connection was interrumpted and resuming appears to be
901 # possible. This is part of rtmpdump's normal usage, AFAIK.
902 basic_args = ['rtmpdump', '-q'] + [[], ['-W', player_url]][player_url is not None] + ['-r', url, '-o', tmpfilename]
903 args = basic_args + [[], ['-e', '-k', '1']][self.params.get('continuedl', False)]
904 if self.params.get('verbose', False):
907 shell_quote = lambda args: ' '.join(map(pipes.quote, args))
910 self.to_screen(u'[debug] rtmpdump command line: ' + shell_quote(args))
911 retval = subprocess.call(args)
912 while retval == 2 or retval == 1:
913 prevsize = os.path.getsize(_encodeFilename(tmpfilename))
914 self.to_screen(u'\r[rtmpdump] %s bytes' % prevsize, skip_eol=True)
915 time.sleep(5.0) # This seems to be needed
916 retval = subprocess.call(basic_args + ['-e'] + [[], ['-k', '1']][retval == 1])
917 cursize = os.path.getsize(_encodeFilename(tmpfilename))
918 if prevsize == cursize and retval == 1:
920 # Some rtmp streams seem abort after ~ 99.8%. Don't complain for those
921 if prevsize == cursize and retval == 2 and cursize > 1024:
922 self.to_screen(u'\r[rtmpdump] Could not download the whole video. This can happen for some advertisements.')
926 self.to_screen(u'\r[rtmpdump] %s bytes' % os.path.getsize(_encodeFilename(tmpfilename)))
927 self.try_rename(tmpfilename, filename)
930 self.trouble(u'\nERROR: rtmpdump exited with code %d' % retval)
933 def _do_download(self, filename, info_dict):
934 url = info_dict['url']
935 player_url = info_dict.get('player_url', None)
937 # Check file already present
938 if self.params.get('continuedl', False) and os.path.isfile(_encodeFilename(filename)) and not self.params.get('nopart', False):
939 self.report_file_already_downloaded(filename)
942 # Attempt to download using rtmpdump
943 if url.startswith('rtmp'):
944 return self._download_with_rtmpdump(filename, url, player_url)
946 tmpfilename = self.temp_name(filename)
949 # Do not include the Accept-Encoding header
950 headers = {'Youtubedl-no-compression': 'True'}
951 basic_request = urllib2.Request(url, None, headers)
952 request = urllib2.Request(url, None, headers)
954 # Establish possible resume length
955 if os.path.isfile(_encodeFilename(tmpfilename)):
956 resume_len = os.path.getsize(_encodeFilename(tmpfilename))
962 if self.params.get('continuedl', False):
963 self.report_resuming_byte(resume_len)
964 request.add_header('Range','bytes=%d-' % resume_len)
970 retries = self.params.get('retries', 0)
971 while count <= retries:
972 # Establish connection
974 if count == 0 and 'urlhandle' in info_dict:
975 data = info_dict['urlhandle']
976 data = urllib2.urlopen(request)
978 except (urllib2.HTTPError, ), err:
979 if (err.code < 500 or err.code >= 600) and err.code != 416:
980 # Unexpected HTTP error
982 elif err.code == 416:
983 # Unable to resume (requested range not satisfiable)
985 # Open the connection again without the range header
986 data = urllib2.urlopen(basic_request)
987 content_length = data.info()['Content-Length']
988 except (urllib2.HTTPError, ), err:
989 if err.code < 500 or err.code >= 600:
992 # Examine the reported length
993 if (content_length is not None and
994 (resume_len - 100 < long(content_length) < resume_len + 100)):
995 # The file had already been fully downloaded.
996 # Explanation to the above condition: in issue #175 it was revealed that
997 # YouTube sometimes adds or removes a few bytes from the end of the file,
998 # changing the file size slightly and causing problems for some users. So
999 # I decided to implement a suggested change and consider the file
1000 # completely downloaded if the file size differs less than 100 bytes from
1001 # the one in the hard drive.
1002 self.report_file_already_downloaded(filename)
1003 self.try_rename(tmpfilename, filename)
1006 # The length does not match, we start the download over
1007 self.report_unable_to_resume()
1012 if count <= retries:
1013 self.report_retry(count, retries)
1016 self.trouble(u'ERROR: giving up after %s retries' % retries)
1019 data_len = data.info().get('Content-length', None)
1020 if data_len is not None:
1021 data_len = long(data_len) + resume_len
1022 data_len_str = self.format_bytes(data_len)
1023 byte_counter = 0 + resume_len
1027 # Download and write
1028 before = time.time()
1029 data_block = data.read(block_size)
1031 if len(data_block) == 0:
1033 byte_counter += len(data_block)
1035 # Open file just in time
1038 (stream, tmpfilename) = sanitize_open(tmpfilename, open_mode)
1039 assert stream is not None
1040 filename = self.undo_temp_name(tmpfilename)
1041 self.report_destination(filename)
1042 except (OSError, IOError), err:
1043 self.trouble(u'ERROR: unable to open for writing: %s' % str(err))
1046 stream.write(data_block)
1047 except (IOError, OSError), err:
1048 self.trouble(u'\nERROR: unable to write data: %s' % str(err))
1050 block_size = self.best_block_size(after - before, len(data_block))
1053 speed_str = self.calc_speed(start, time.time(), byte_counter - resume_len)
1054 if data_len is None:
1055 self.report_progress('Unknown %', data_len_str, speed_str, 'Unknown ETA')
1057 percent_str = self.calc_percent(byte_counter, data_len)
1058 eta_str = self.calc_eta(start, time.time(), data_len - resume_len, byte_counter - resume_len)
1059 self.report_progress(percent_str, data_len_str, speed_str, eta_str)
1062 self.slow_down(start, byte_counter - resume_len)
1065 self.trouble(u'\nERROR: Did not get any data blocks')
1068 self.report_finish()
1069 if data_len is not None and byte_counter != data_len:
1070 raise ContentTooShortError(byte_counter, long(data_len))
1071 self.try_rename(tmpfilename, filename)
1073 # Update file modification time
1074 if self.params.get('updatetime', True):
1075 info_dict['filetime'] = self.try_utime(filename, data.info().get('last-modified', None))
1080 class InfoExtractor(object):
1081 """Information Extractor class.
1083 Information extractors are the classes that, given a URL, extract
1084 information from the video (or videos) the URL refers to. This
1085 information includes the real video URL, the video title and simplified
1086 title, author and others. The information is stored in a dictionary
1087 which is then passed to the FileDownloader. The FileDownloader
1088 processes this information possibly downloading the video to the file
1089 system, among other possible outcomes. The dictionaries must include
1090 the following fields:
1092 id: Video identifier.
1093 url: Final video URL.
1094 uploader: Nickname of the video uploader.
1095 title: Literal title.
1096 stitle: Simplified title.
1097 ext: Video filename extension.
1098 format: Video format.
1099 player_url: SWF Player URL (may be None).
1101 The following fields are optional. Their primary purpose is to allow
1102 youtube-dl to serve as the backend for a video search function, such
1103 as the one in youtube2mp3. They are only used when their respective
1104 forced printing functions are called:
1106 thumbnail: Full URL to a video thumbnail image.
1107 description: One-line video description.
1109 Subclasses of this one should re-define the _real_initialize() and
1110 _real_extract() methods and define a _VALID_URL regexp.
1111 Probably, they should also be added to the list of extractors.
1117 def __init__(self, downloader=None):
1118 """Constructor. Receives an optional downloader."""
1120 self.set_downloader(downloader)
1122 def suitable(self, url):
1123 """Receives a URL and returns True if suitable for this IE."""
1124 return re.match(self._VALID_URL, url) is not None
1126 def initialize(self):
1127 """Initializes an instance (authentication, etc)."""
1129 self._real_initialize()
1132 def extract(self, url):
1133 """Extracts URL information and returns it in list of dicts."""
1135 return self._real_extract(url)
1137 def set_downloader(self, downloader):
1138 """Sets the downloader for this IE."""
1139 self._downloader = downloader
1141 def _real_initialize(self):
1142 """Real initialization process. Redefine in subclasses."""
1145 def _real_extract(self, url):
1146 """Real extraction process. Redefine in subclasses."""
1150 class YoutubeIE(InfoExtractor):
1151 """Information extractor for youtube.com."""
1153 _VALID_URL = r'^((?:https?://)?(?:youtu\.be/|(?:\w+\.)?youtube(?:-nocookie)?\.com/)(?!view_play_list|my_playlists|artist|playlist)(?:(?:(?:v|embed|e)/)|(?:(?:watch(?:_popup)?(?:\.php)?)?(?:\?|#!?)(?:.+&)?v=))?)?([0-9A-Za-z_-]+)(?(1).+)?$'
1154 _LANG_URL = r'http://www.youtube.com/?hl=en&persist_hl=1&gl=US&persist_gl=1&opt_out_ackd=1'
1155 _LOGIN_URL = 'https://www.youtube.com/signup?next=/&gl=US&hl=en'
1156 _AGE_URL = 'http://www.youtube.com/verify_age?next_url=/&gl=US&hl=en'
1157 _NETRC_MACHINE = 'youtube'
1158 # Listed in order of quality
1159 _available_formats = ['38', '37', '22', '45', '35', '44', '34', '18', '43', '6', '5', '17', '13']
1160 _available_formats_prefer_free = ['38', '37', '45', '22', '44', '35', '43', '34', '18', '6', '5', '17', '13']
1161 _video_extensions = {
1167 '38': 'video', # You actually don't know if this will be MOV, AVI or whatever
1172 _video_dimensions = {
1187 IE_NAME = u'youtube'
1189 def report_lang(self):
1190 """Report attempt to set language."""
1191 self._downloader.to_screen(u'[youtube] Setting language')
1193 def report_login(self):
1194 """Report attempt to log in."""
1195 self._downloader.to_screen(u'[youtube] Logging in')
1197 def report_age_confirmation(self):
1198 """Report attempt to confirm age."""
1199 self._downloader.to_screen(u'[youtube] Confirming age')
1201 def report_video_webpage_download(self, video_id):
1202 """Report attempt to download video webpage."""
1203 self._downloader.to_screen(u'[youtube] %s: Downloading video webpage' % video_id)
1205 def report_video_info_webpage_download(self, video_id):
1206 """Report attempt to download video info webpage."""
1207 self._downloader.to_screen(u'[youtube] %s: Downloading video info webpage' % video_id)
1209 def report_information_extraction(self, video_id):
1210 """Report attempt to extract video information."""
1211 self._downloader.to_screen(u'[youtube] %s: Extracting video information' % video_id)
1213 def report_unavailable_format(self, video_id, format):
1214 """Report extracted video URL."""
1215 self._downloader.to_screen(u'[youtube] %s: Format %s not available' % (video_id, format))
1217 def report_rtmp_download(self):
1218 """Indicate the download will use the RTMP protocol."""
1219 self._downloader.to_screen(u'[youtube] RTMP download detected')
1221 def _print_formats(self, formats):
1222 print 'Available formats:'
1224 print '%s\t:\t%s\t[%s]' %(x, self._video_extensions.get(x, 'flv'), self._video_dimensions.get(x, '???'))
1226 def _real_initialize(self):
1227 if self._downloader is None:
1232 downloader_params = self._downloader.params
1234 # Attempt to use provided username and password or .netrc data
1235 if downloader_params.get('username', None) is not None:
1236 username = downloader_params['username']
1237 password = downloader_params['password']
1238 elif downloader_params.get('usenetrc', False):
1240 info = netrc.netrc().authenticators(self._NETRC_MACHINE)
1241 if info is not None:
1245 raise netrc.NetrcParseError('No authenticators for %s' % self._NETRC_MACHINE)
1246 except (IOError, netrc.NetrcParseError), err:
1247 self._downloader.to_stderr(u'WARNING: parsing .netrc: %s' % str(err))
1251 request = urllib2.Request(self._LANG_URL)
1254 urllib2.urlopen(request).read()
1255 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1256 self._downloader.to_stderr(u'WARNING: unable to set language: %s' % str(err))
1259 # No authentication to be performed
1260 if username is None:
1265 'current_form': 'loginForm',
1267 'action_login': 'Log In',
1268 'username': username,
1269 'password': password,
1271 request = urllib2.Request(self._LOGIN_URL, urllib.urlencode(login_form))
1274 login_results = urllib2.urlopen(request).read()
1275 if re.search(r'(?i)<form[^>]* name="loginForm"', login_results) is not None:
1276 self._downloader.to_stderr(u'WARNING: unable to log in: bad username or password')
1278 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1279 self._downloader.to_stderr(u'WARNING: unable to log in: %s' % str(err))
1285 'action_confirm': 'Confirm',
1287 request = urllib2.Request(self._AGE_URL, urllib.urlencode(age_form))
1289 self.report_age_confirmation()
1290 age_results = urllib2.urlopen(request).read()
1291 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1292 self._downloader.trouble(u'ERROR: unable to confirm age: %s' % str(err))
1295 def _real_extract(self, url):
1296 # Extract video id from URL
1297 mobj = re.match(self._VALID_URL, url)
1299 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
1301 video_id = mobj.group(2)
1304 self.report_video_webpage_download(video_id)
1305 request = urllib2.Request('http://www.youtube.com/watch?v=%s&gl=US&hl=en&has_verified=1' % video_id)
1307 video_webpage = urllib2.urlopen(request).read()
1308 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1309 self._downloader.trouble(u'ERROR: unable to download video webpage: %s' % str(err))
1312 # Attempt to extract SWF player URL
1313 mobj = re.search(r'swfConfig.*?"(http:\\/\\/.*?watch.*?-.*?\.swf)"', video_webpage)
1314 if mobj is not None:
1315 player_url = re.sub(r'\\(.)', r'\1', mobj.group(1))
1320 self.report_video_info_webpage_download(video_id)
1321 for el_type in ['&el=embedded', '&el=detailpage', '&el=vevo', '']:
1322 video_info_url = ('http://www.youtube.com/get_video_info?&video_id=%s%s&ps=default&eurl=&gl=US&hl=en'
1323 % (video_id, el_type))
1324 request = urllib2.Request(video_info_url)
1326 video_info_webpage = urllib2.urlopen(request).read()
1327 video_info = parse_qs(video_info_webpage)
1328 if 'token' in video_info:
1330 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1331 self._downloader.trouble(u'ERROR: unable to download video info webpage: %s' % str(err))
1333 if 'token' not in video_info:
1334 if 'reason' in video_info:
1335 self._downloader.trouble(u'ERROR: YouTube said: %s' % video_info['reason'][0].decode('utf-8'))
1337 self._downloader.trouble(u'ERROR: "token" parameter not in video info for unknown reason')
1340 # Start extracting information
1341 self.report_information_extraction(video_id)
1344 if 'author' not in video_info:
1345 self._downloader.trouble(u'ERROR: unable to extract uploader nickname')
1347 video_uploader = urllib.unquote_plus(video_info['author'][0])
1350 if 'title' not in video_info:
1351 self._downloader.trouble(u'ERROR: unable to extract video title')
1353 video_title = urllib.unquote_plus(video_info['title'][0])
1354 video_title = video_title.decode('utf-8')
1355 video_title = sanitize_title(video_title)
1358 simple_title = _simplify_title(video_title)
1361 if 'thumbnail_url' not in video_info:
1362 self._downloader.trouble(u'WARNING: unable to extract video thumbnail')
1363 video_thumbnail = ''
1364 else: # don't panic if we can't find it
1365 video_thumbnail = urllib.unquote_plus(video_info['thumbnail_url'][0])
1369 mobj = re.search(r'id="eow-date.*?>(.*?)</span>', video_webpage, re.DOTALL)
1370 if mobj is not None:
1371 upload_date = ' '.join(re.sub(r'[/,-]', r' ', mobj.group(1)).split())
1372 format_expressions = ['%d %B %Y', '%B %d %Y', '%b %d %Y']
1373 for expression in format_expressions:
1375 upload_date = datetime.datetime.strptime(upload_date, expression).strftime('%Y%m%d')
1383 video_description = u'No description available.'
1384 mobj = re.search(r'<meta name="description" content="(.*?)">', video_webpage)
1385 if mobj is not None:
1386 video_description = mobj.group(1).decode('utf-8')
1388 html_parser = lxml.etree.HTMLParser(encoding='utf-8')
1389 vwebpage_doc = lxml.etree.parse(StringIO.StringIO(video_webpage), html_parser)
1390 video_description = u''.join(vwebpage_doc.xpath('id("eow-description")//text()'))
1391 # TODO use another parser
1394 video_token = urllib.unquote_plus(video_info['token'][0])
1396 # Decide which formats to download
1397 req_format = self._downloader.params.get('format', None)
1399 if 'conn' in video_info and video_info['conn'][0].startswith('rtmp'):
1400 self.report_rtmp_download()
1401 video_url_list = [(None, video_info['conn'][0])]
1402 elif 'url_encoded_fmt_stream_map' in video_info and len(video_info['url_encoded_fmt_stream_map']) >= 1:
1403 url_data_strs = video_info['url_encoded_fmt_stream_map'][0].split(',')
1404 url_data = [parse_qs(uds) for uds in url_data_strs]
1405 url_data = filter(lambda ud: 'itag' in ud and 'url' in ud, url_data)
1406 url_map = dict((ud['itag'][0], ud['url'][0]) for ud in url_data)
1408 format_limit = self._downloader.params.get('format_limit', None)
1409 available_formats = self._available_formats_prefer_free if self._downloader.params.get('prefer_free_formats', False) else self._available_formats
1410 if format_limit is not None and format_limit in available_formats:
1411 format_list = available_formats[available_formats.index(format_limit):]
1413 format_list = available_formats
1414 existing_formats = [x for x in format_list if x in url_map]
1415 if len(existing_formats) == 0:
1416 self._downloader.trouble(u'ERROR: no known formats available for video')
1418 if self._downloader.params.get('listformats', None):
1419 self._print_formats(existing_formats)
1421 if req_format is None or req_format == 'best':
1422 video_url_list = [(existing_formats[0], url_map[existing_formats[0]])] # Best quality
1423 elif req_format == 'worst':
1424 video_url_list = [(existing_formats[len(existing_formats)-1], url_map[existing_formats[len(existing_formats)-1]])] # worst quality
1425 elif req_format in ('-1', 'all'):
1426 video_url_list = [(f, url_map[f]) for f in existing_formats] # All formats
1428 # Specific formats. We pick the first in a slash-delimeted sequence.
1429 # For example, if '1/2/3/4' is requested and '2' and '4' are available, we pick '2'.
1430 req_formats = req_format.split('/')
1431 video_url_list = None
1432 for rf in req_formats:
1434 video_url_list = [(rf, url_map[rf])]
1436 if video_url_list is None:
1437 self._downloader.trouble(u'ERROR: requested format not available')
1440 self._downloader.trouble(u'ERROR: no conn or url_encoded_fmt_stream_map information found in video info')
1443 for format_param, video_real_url in video_url_list:
1444 # At this point we have a new video
1445 self._downloader.increment_downloads()
1448 video_extension = self._video_extensions.get(format_param, 'flv')
1451 # Process video information
1452 self._downloader.process_info({
1453 'id': video_id.decode('utf-8'),
1454 'url': video_real_url.decode('utf-8'),
1455 'uploader': video_uploader.decode('utf-8'),
1456 'upload_date': upload_date,
1457 'title': video_title,
1458 'stitle': simple_title,
1459 'ext': video_extension.decode('utf-8'),
1460 'format': (format_param is None and u'NA' or format_param.decode('utf-8')),
1461 'thumbnail': video_thumbnail.decode('utf-8'),
1462 'description': video_description,
1463 'player_url': player_url,
1465 except UnavailableVideoError, err:
1466 self._downloader.trouble(u'\nERROR: unable to download video')
1469 class MetacafeIE(InfoExtractor):
1470 """Information Extractor for metacafe.com."""
1472 _VALID_URL = r'(?:http://)?(?:www\.)?metacafe\.com/watch/([^/]+)/([^/]+)/.*'
1473 _DISCLAIMER = 'http://www.metacafe.com/family_filter/'
1474 _FILTER_POST = 'http://www.metacafe.com/f/index.php?inputType=filter&controllerGroup=user'
1476 IE_NAME = u'metacafe'
1478 def __init__(self, youtube_ie, downloader=None):
1479 InfoExtractor.__init__(self, downloader)
1480 self._youtube_ie = youtube_ie
1482 def report_disclaimer(self):
1483 """Report disclaimer retrieval."""
1484 self._downloader.to_screen(u'[metacafe] Retrieving disclaimer')
1486 def report_age_confirmation(self):
1487 """Report attempt to confirm age."""
1488 self._downloader.to_screen(u'[metacafe] Confirming age')
1490 def report_download_webpage(self, video_id):
1491 """Report webpage download."""
1492 self._downloader.to_screen(u'[metacafe] %s: Downloading webpage' % video_id)
1494 def report_extraction(self, video_id):
1495 """Report information extraction."""
1496 self._downloader.to_screen(u'[metacafe] %s: Extracting information' % video_id)
1498 def _real_initialize(self):
1499 # Retrieve disclaimer
1500 request = urllib2.Request(self._DISCLAIMER)
1502 self.report_disclaimer()
1503 disclaimer = urllib2.urlopen(request).read()
1504 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1505 self._downloader.trouble(u'ERROR: unable to retrieve disclaimer: %s' % str(err))
1511 'submit': "Continue - I'm over 18",
1513 request = urllib2.Request(self._FILTER_POST, urllib.urlencode(disclaimer_form))
1515 self.report_age_confirmation()
1516 disclaimer = urllib2.urlopen(request).read()
1517 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1518 self._downloader.trouble(u'ERROR: unable to confirm age: %s' % str(err))
1521 def _real_extract(self, url):
1522 # Extract id and simplified title from URL
1523 mobj = re.match(self._VALID_URL, url)
1525 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
1528 video_id = mobj.group(1)
1530 # Check if video comes from YouTube
1531 mobj2 = re.match(r'^yt-(.*)$', video_id)
1532 if mobj2 is not None:
1533 self._youtube_ie.extract('http://www.youtube.com/watch?v=%s' % mobj2.group(1))
1536 # At this point we have a new video
1537 self._downloader.increment_downloads()
1539 simple_title = mobj.group(2).decode('utf-8')
1541 # Retrieve video webpage to extract further information
1542 request = urllib2.Request('http://www.metacafe.com/watch/%s/' % video_id)
1544 self.report_download_webpage(video_id)
1545 webpage = urllib2.urlopen(request).read()
1546 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1547 self._downloader.trouble(u'ERROR: unable retrieve video webpage: %s' % str(err))
1550 # Extract URL, uploader and title from webpage
1551 self.report_extraction(video_id)
1552 mobj = re.search(r'(?m)&mediaURL=([^&]+)', webpage)
1553 if mobj is not None:
1554 mediaURL = urllib.unquote(mobj.group(1))
1555 video_extension = mediaURL[-3:]
1557 # Extract gdaKey if available
1558 mobj = re.search(r'(?m)&gdaKey=(.*?)&', webpage)
1560 video_url = mediaURL
1562 gdaKey = mobj.group(1)
1563 video_url = '%s?__gda__=%s' % (mediaURL, gdaKey)
1565 mobj = re.search(r' name="flashvars" value="(.*?)"', webpage)
1567 self._downloader.trouble(u'ERROR: unable to extract media URL')
1569 vardict = parse_qs(mobj.group(1))
1570 if 'mediaData' not in vardict:
1571 self._downloader.trouble(u'ERROR: unable to extract media URL')
1573 mobj = re.search(r'"mediaURL":"(http.*?)","key":"(.*?)"', vardict['mediaData'][0])
1575 self._downloader.trouble(u'ERROR: unable to extract media URL')
1577 mediaURL = mobj.group(1).replace('\\/', '/')
1578 video_extension = mediaURL[-3:]
1579 video_url = '%s?__gda__=%s' % (mediaURL, mobj.group(2))
1581 mobj = re.search(r'(?im)<title>(.*) - Video</title>', webpage)
1583 self._downloader.trouble(u'ERROR: unable to extract title')
1585 video_title = mobj.group(1).decode('utf-8')
1586 video_title = sanitize_title(video_title)
1588 mobj = re.search(r'(?ms)By:\s*<a .*?>(.+?)<', webpage)
1590 self._downloader.trouble(u'ERROR: unable to extract uploader nickname')
1592 video_uploader = mobj.group(1)
1595 # Process video information
1596 self._downloader.process_info({
1597 'id': video_id.decode('utf-8'),
1598 'url': video_url.decode('utf-8'),
1599 'uploader': video_uploader.decode('utf-8'),
1600 'upload_date': u'NA',
1601 'title': video_title,
1602 'stitle': simple_title,
1603 'ext': video_extension.decode('utf-8'),
1607 except UnavailableVideoError:
1608 self._downloader.trouble(u'\nERROR: unable to download video')
1611 class DailymotionIE(InfoExtractor):
1612 """Information Extractor for Dailymotion"""
1614 _VALID_URL = r'(?i)(?:https?://)?(?:www\.)?dailymotion\.[a-z]{2,3}/video/([^_/]+)_([^/]+)'
1615 IE_NAME = u'dailymotion'
1617 def __init__(self, downloader=None):
1618 InfoExtractor.__init__(self, downloader)
1620 def report_download_webpage(self, video_id):
1621 """Report webpage download."""
1622 self._downloader.to_screen(u'[dailymotion] %s: Downloading webpage' % video_id)
1624 def report_extraction(self, video_id):
1625 """Report information extraction."""
1626 self._downloader.to_screen(u'[dailymotion] %s: Extracting information' % video_id)
1628 def _real_extract(self, url):
1629 # Extract id and simplified title from URL
1630 mobj = re.match(self._VALID_URL, url)
1632 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
1635 # At this point we have a new video
1636 self._downloader.increment_downloads()
1637 video_id = mobj.group(1)
1639 video_extension = 'flv'
1641 # Retrieve video webpage to extract further information
1642 request = urllib2.Request(url)
1643 request.add_header('Cookie', 'family_filter=off')
1645 self.report_download_webpage(video_id)
1646 webpage = urllib2.urlopen(request).read()
1647 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1648 self._downloader.trouble(u'ERROR: unable retrieve video webpage: %s' % str(err))
1651 # Extract URL, uploader and title from webpage
1652 self.report_extraction(video_id)
1653 mobj = re.search(r'(?i)addVariable\(\"sequence\"\s*,\s*\"([^\"]+?)\"\)', webpage)
1655 self._downloader.trouble(u'ERROR: unable to extract media URL')
1657 sequence = urllib.unquote(mobj.group(1))
1658 mobj = re.search(r',\"sdURL\"\:\"([^\"]+?)\",', sequence)
1660 self._downloader.trouble(u'ERROR: unable to extract media URL')
1662 mediaURL = urllib.unquote(mobj.group(1)).replace('\\', '')
1664 # if needed add http://www.dailymotion.com/ if relative URL
1666 video_url = mediaURL
1668 mobj = re.search(r'<meta property="og:title" content="(?P<title>[^"]*)" />', webpage)
1670 self._downloader.trouble(u'ERROR: unable to extract title')
1672 video_title = _unescapeHTML(mobj.group('title').decode('utf-8'))
1673 video_title = sanitize_title(video_title)
1674 simple_title = _simplify_title(video_title)
1676 mobj = re.search(r'(?im)<span class="owner[^\"]+?">[^<]+?<a [^>]+?>([^<]+?)</a></span>', webpage)
1678 self._downloader.trouble(u'ERROR: unable to extract uploader nickname')
1680 video_uploader = mobj.group(1)
1683 # Process video information
1684 self._downloader.process_info({
1685 'id': video_id.decode('utf-8'),
1686 'url': video_url.decode('utf-8'),
1687 'uploader': video_uploader.decode('utf-8'),
1688 'upload_date': u'NA',
1689 'title': video_title,
1690 'stitle': simple_title,
1691 'ext': video_extension.decode('utf-8'),
1695 except UnavailableVideoError:
1696 self._downloader.trouble(u'\nERROR: unable to download video')
1699 class GoogleIE(InfoExtractor):
1700 """Information extractor for video.google.com."""
1702 _VALID_URL = r'(?:http://)?video\.google\.(?:com(?:\.au)?|co\.(?:uk|jp|kr|cr)|ca|de|es|fr|it|nl|pl)/videoplay\?docid=([^\&]+).*'
1703 IE_NAME = u'video.google'
1705 def __init__(self, downloader=None):
1706 InfoExtractor.__init__(self, downloader)
1708 def report_download_webpage(self, video_id):
1709 """Report webpage download."""
1710 self._downloader.to_screen(u'[video.google] %s: Downloading webpage' % video_id)
1712 def report_extraction(self, video_id):
1713 """Report information extraction."""
1714 self._downloader.to_screen(u'[video.google] %s: Extracting information' % video_id)
1716 def _real_extract(self, url):
1717 # Extract id from URL
1718 mobj = re.match(self._VALID_URL, url)
1720 self._downloader.trouble(u'ERROR: Invalid URL: %s' % url)
1723 # At this point we have a new video
1724 self._downloader.increment_downloads()
1725 video_id = mobj.group(1)
1727 video_extension = 'mp4'
1729 # Retrieve video webpage to extract further information
1730 request = urllib2.Request('http://video.google.com/videoplay?docid=%s&hl=en&oe=utf-8' % video_id)
1732 self.report_download_webpage(video_id)
1733 webpage = urllib2.urlopen(request).read()
1734 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1735 self._downloader.trouble(u'ERROR: Unable to retrieve video webpage: %s' % str(err))
1738 # Extract URL, uploader, and title from webpage
1739 self.report_extraction(video_id)
1740 mobj = re.search(r"download_url:'([^']+)'", webpage)
1742 video_extension = 'flv'
1743 mobj = re.search(r"(?i)videoUrl\\x3d(.+?)\\x26", webpage)
1745 self._downloader.trouble(u'ERROR: unable to extract media URL')
1747 mediaURL = urllib.unquote(mobj.group(1))
1748 mediaURL = mediaURL.replace('\\x3d', '\x3d')
1749 mediaURL = mediaURL.replace('\\x26', '\x26')
1751 video_url = mediaURL
1753 mobj = re.search(r'<title>(.*)</title>', webpage)
1755 self._downloader.trouble(u'ERROR: unable to extract title')
1757 video_title = mobj.group(1).decode('utf-8')
1758 video_title = sanitize_title(video_title)
1759 simple_title = _simplify_title(video_title)
1761 # Extract video description
1762 mobj = re.search(r'<span id=short-desc-content>([^<]*)</span>', webpage)
1764 self._downloader.trouble(u'ERROR: unable to extract video description')
1766 video_description = mobj.group(1).decode('utf-8')
1767 if not video_description:
1768 video_description = 'No description available.'
1770 # Extract video thumbnail
1771 if self._downloader.params.get('forcethumbnail', False):
1772 request = urllib2.Request('http://video.google.com/videosearch?q=%s+site:video.google.com&hl=en' % abs(int(video_id)))
1774 webpage = urllib2.urlopen(request).read()
1775 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1776 self._downloader.trouble(u'ERROR: Unable to retrieve video webpage: %s' % str(err))
1778 mobj = re.search(r'<img class=thumbnail-img (?:.* )?src=(http.*)>', webpage)
1780 self._downloader.trouble(u'ERROR: unable to extract video thumbnail')
1782 video_thumbnail = mobj.group(1)
1783 else: # we need something to pass to process_info
1784 video_thumbnail = ''
1787 # Process video information
1788 self._downloader.process_info({
1789 'id': video_id.decode('utf-8'),
1790 'url': video_url.decode('utf-8'),
1792 'upload_date': u'NA',
1793 'title': video_title,
1794 'stitle': simple_title,
1795 'ext': video_extension.decode('utf-8'),
1799 except UnavailableVideoError:
1800 self._downloader.trouble(u'\nERROR: unable to download video')
1803 class PhotobucketIE(InfoExtractor):
1804 """Information extractor for photobucket.com."""
1806 _VALID_URL = r'(?:http://)?(?:[a-z0-9]+\.)?photobucket\.com/.*[\?\&]current=(.*\.flv)'
1807 IE_NAME = u'photobucket'
1809 def __init__(self, downloader=None):
1810 InfoExtractor.__init__(self, downloader)
1812 def report_download_webpage(self, video_id):
1813 """Report webpage download."""
1814 self._downloader.to_screen(u'[photobucket] %s: Downloading webpage' % video_id)
1816 def report_extraction(self, video_id):
1817 """Report information extraction."""
1818 self._downloader.to_screen(u'[photobucket] %s: Extracting information' % video_id)
1820 def _real_extract(self, url):
1821 # Extract id from URL
1822 mobj = re.match(self._VALID_URL, url)
1824 self._downloader.trouble(u'ERROR: Invalid URL: %s' % url)
1827 # At this point we have a new video
1828 self._downloader.increment_downloads()
1829 video_id = mobj.group(1)
1831 video_extension = 'flv'
1833 # Retrieve video webpage to extract further information
1834 request = urllib2.Request(url)
1836 self.report_download_webpage(video_id)
1837 webpage = urllib2.urlopen(request).read()
1838 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1839 self._downloader.trouble(u'ERROR: Unable to retrieve video webpage: %s' % str(err))
1842 # Extract URL, uploader, and title from webpage
1843 self.report_extraction(video_id)
1844 mobj = re.search(r'<link rel="video_src" href=".*\?file=([^"]+)" />', webpage)
1846 self._downloader.trouble(u'ERROR: unable to extract media URL')
1848 mediaURL = urllib.unquote(mobj.group(1))
1850 video_url = mediaURL
1852 mobj = re.search(r'<title>(.*) video by (.*) - Photobucket</title>', webpage)
1854 self._downloader.trouble(u'ERROR: unable to extract title')
1856 video_title = mobj.group(1).decode('utf-8')
1857 video_title = sanitize_title(video_title)
1858 simple_title = _simplify_title(vide_title)
1860 video_uploader = mobj.group(2).decode('utf-8')
1863 # Process video information
1864 self._downloader.process_info({
1865 'id': video_id.decode('utf-8'),
1866 'url': video_url.decode('utf-8'),
1867 'uploader': video_uploader,
1868 'upload_date': u'NA',
1869 'title': video_title,
1870 'stitle': simple_title,
1871 'ext': video_extension.decode('utf-8'),
1875 except UnavailableVideoError:
1876 self._downloader.trouble(u'\nERROR: unable to download video')
1879 class YahooIE(InfoExtractor):
1880 """Information extractor for video.yahoo.com."""
1882 # _VALID_URL matches all Yahoo! Video URLs
1883 # _VPAGE_URL matches only the extractable '/watch/' URLs
1884 _VALID_URL = r'(?:http://)?(?:[a-z]+\.)?video\.yahoo\.com/(?:watch|network)/([0-9]+)(?:/|\?v=)([0-9]+)(?:[#\?].*)?'
1885 _VPAGE_URL = r'(?:http://)?video\.yahoo\.com/watch/([0-9]+)/([0-9]+)(?:[#\?].*)?'
1886 IE_NAME = u'video.yahoo'
1888 def __init__(self, downloader=None):
1889 InfoExtractor.__init__(self, downloader)
1891 def report_download_webpage(self, video_id):
1892 """Report webpage download."""
1893 self._downloader.to_screen(u'[video.yahoo] %s: Downloading webpage' % video_id)
1895 def report_extraction(self, video_id):
1896 """Report information extraction."""
1897 self._downloader.to_screen(u'[video.yahoo] %s: Extracting information' % video_id)
1899 def _real_extract(self, url, new_video=True):
1900 # Extract ID from URL
1901 mobj = re.match(self._VALID_URL, url)
1903 self._downloader.trouble(u'ERROR: Invalid URL: %s' % url)
1906 # At this point we have a new video
1907 self._downloader.increment_downloads()
1908 video_id = mobj.group(2)
1909 video_extension = 'flv'
1911 # Rewrite valid but non-extractable URLs as
1912 # extractable English language /watch/ URLs
1913 if re.match(self._VPAGE_URL, url) is None:
1914 request = urllib2.Request(url)
1916 webpage = urllib2.urlopen(request).read()
1917 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1918 self._downloader.trouble(u'ERROR: Unable to retrieve video webpage: %s' % str(err))
1921 mobj = re.search(r'\("id", "([0-9]+)"\);', webpage)
1923 self._downloader.trouble(u'ERROR: Unable to extract id field')
1925 yahoo_id = mobj.group(1)
1927 mobj = re.search(r'\("vid", "([0-9]+)"\);', webpage)
1929 self._downloader.trouble(u'ERROR: Unable to extract vid field')
1931 yahoo_vid = mobj.group(1)
1933 url = 'http://video.yahoo.com/watch/%s/%s' % (yahoo_vid, yahoo_id)
1934 return self._real_extract(url, new_video=False)
1936 # Retrieve video webpage to extract further information
1937 request = urllib2.Request(url)
1939 self.report_download_webpage(video_id)
1940 webpage = urllib2.urlopen(request).read()
1941 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
1942 self._downloader.trouble(u'ERROR: Unable to retrieve video webpage: %s' % str(err))
1945 # Extract uploader and title from webpage
1946 self.report_extraction(video_id)
1947 mobj = re.search(r'<meta name="title" content="(.*)" />', webpage)
1949 self._downloader.trouble(u'ERROR: unable to extract video title')
1951 video_title = mobj.group(1).decode('utf-8')
1952 simple_title = _simplify_title(video_title)
1954 mobj = re.search(r'<h2 class="ti-5"><a href="http://video\.yahoo\.com/(people|profile)/[0-9]+" beacon=".*">(.*)</a></h2>', webpage)
1956 self._downloader.trouble(u'ERROR: unable to extract video uploader')
1958 video_uploader = mobj.group(1).decode('utf-8')
1960 # Extract video thumbnail
1961 mobj = re.search(r'<link rel="image_src" href="(.*)" />', webpage)
1963 self._downloader.trouble(u'ERROR: unable to extract video thumbnail')
1965 video_thumbnail = mobj.group(1).decode('utf-8')
1967 # Extract video description
1968 mobj = re.search(r'<meta name="description" content="(.*)" />', webpage)
1970 self._downloader.trouble(u'ERROR: unable to extract video description')
1972 video_description = mobj.group(1).decode('utf-8')
1973 if not video_description:
1974 video_description = 'No description available.'
1976 # Extract video height and width
1977 mobj = re.search(r'<meta name="video_height" content="([0-9]+)" />', webpage)
1979 self._downloader.trouble(u'ERROR: unable to extract video height')
1981 yv_video_height = mobj.group(1)
1983 mobj = re.search(r'<meta name="video_width" content="([0-9]+)" />', webpage)
1985 self._downloader.trouble(u'ERROR: unable to extract video width')
1987 yv_video_width = mobj.group(1)
1989 # Retrieve video playlist to extract media URL
1990 # I'm not completely sure what all these options are, but we
1991 # seem to need most of them, otherwise the server sends a 401.
1992 yv_lg = 'R0xx6idZnW2zlrKP8xxAIR' # not sure what this represents
1993 yv_bitrate = '700' # according to Wikipedia this is hard-coded
1994 request = urllib2.Request('http://cosmos.bcst.yahoo.com/up/yep/process/getPlaylistFOP.php?node_id=' + video_id +
1995 '&tech=flash&mode=playlist&lg=' + yv_lg + '&bitrate=' + yv_bitrate + '&vidH=' + yv_video_height +
1996 '&vidW=' + yv_video_width + '&swf=as3&rd=video.yahoo.com&tk=null&adsupported=v1,v2,&eventid=1301797')
1998 self.report_download_webpage(video_id)
1999 webpage = urllib2.urlopen(request).read()
2000 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2001 self._downloader.trouble(u'ERROR: Unable to retrieve video webpage: %s' % str(err))
2004 # Extract media URL from playlist XML
2005 mobj = re.search(r'<STREAM APP="(http://.*)" FULLPATH="/?(/.*\.flv\?[^"]*)"', webpage)
2007 self._downloader.trouble(u'ERROR: Unable to extract media URL')
2009 video_url = urllib.unquote(mobj.group(1) + mobj.group(2)).decode('utf-8')
2010 video_url = re.sub(r'(?u)&(.+?);', htmlentity_transform, video_url)
2013 # Process video information
2014 self._downloader.process_info({
2015 'id': video_id.decode('utf-8'),
2017 'uploader': video_uploader,
2018 'upload_date': u'NA',
2019 'title': video_title,
2020 'stitle': simple_title,
2021 'ext': video_extension.decode('utf-8'),
2022 'thumbnail': video_thumbnail.decode('utf-8'),
2023 'description': video_description,
2024 'thumbnail': video_thumbnail,
2027 except UnavailableVideoError:
2028 self._downloader.trouble(u'\nERROR: unable to download video')
2031 class VimeoIE(InfoExtractor):
2032 """Information extractor for vimeo.com."""
2034 # _VALID_URL matches Vimeo URLs
2035 _VALID_URL = r'(?:https?://)?(?:(?:www|player).)?vimeo\.com/(?:groups/[^/]+/)?(?:videos?/)?([0-9]+)'
2038 def __init__(self, downloader=None):
2039 InfoExtractor.__init__(self, downloader)
2041 def report_download_webpage(self, video_id):
2042 """Report webpage download."""
2043 self._downloader.to_screen(u'[vimeo] %s: Downloading webpage' % video_id)
2045 def report_extraction(self, video_id):
2046 """Report information extraction."""
2047 self._downloader.to_screen(u'[vimeo] %s: Extracting information' % video_id)
2049 def _real_extract(self, url, new_video=True):
2050 # Extract ID from URL
2051 mobj = re.match(self._VALID_URL, url)
2053 self._downloader.trouble(u'ERROR: Invalid URL: %s' % url)
2056 # At this point we have a new video
2057 self._downloader.increment_downloads()
2058 video_id = mobj.group(1)
2060 # Retrieve video webpage to extract further information
2061 request = urllib2.Request(url, None, std_headers)
2063 self.report_download_webpage(video_id)
2064 webpage = urllib2.urlopen(request).read()
2065 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2066 self._downloader.trouble(u'ERROR: Unable to retrieve video webpage: %s' % str(err))
2069 # Now we begin extracting as much information as we can from what we
2070 # retrieved. First we extract the information common to all extractors,
2071 # and latter we extract those that are Vimeo specific.
2072 self.report_extraction(video_id)
2074 # Extract the config JSON
2075 config = webpage.split(' = {config:')[1].split(',assets:')[0]
2077 config = json.loads(config)
2079 self._downloader.trouble(u'ERROR: unable to extract info section')
2083 video_title = config["video"]["title"]
2084 simple_title = _simplify_title(video_title)
2087 video_uploader = config["video"]["owner"]["name"]
2089 # Extract video thumbnail
2090 video_thumbnail = config["video"]["thumbnail"]
2092 # Extract video description
2096 video_description = u'No description available.'
2097 mobj = re.search(r'<meta name="description" content="(.*?)" />', webpage, re.MULTILINE)
2098 if mobj is not None:
2099 video_description = mobj.group(1)
2101 html_parser = lxml.etree.HTMLParser()
2102 vwebpage_doc = lxml.etree.parse(StringIO.StringIO(webpage), html_parser)
2103 video_description = u''.join(vwebpage_doc.xpath('id("description")//text()')).strip()
2104 # TODO use another parser
2106 # Extract upload date
2107 video_upload_date = u'NA'
2108 mobj = re.search(r'<span id="clip-date" style="display:none">[^:]*: (.*?)( \([^\(]*\))?</span>', webpage)
2109 if mobj is not None:
2110 video_upload_date = mobj.group(1)
2112 # Vimeo specific: extract request signature and timestamp
2113 sig = config['request']['signature']
2114 timestamp = config['request']['timestamp']
2116 # Vimeo specific: extract video codec and quality information
2117 # TODO bind to format param
2118 codecs = [('h264', 'mp4'), ('vp8', 'flv'), ('vp6', 'flv')]
2119 for codec in codecs:
2120 if codec[0] in config["video"]["files"]:
2121 video_codec = codec[0]
2122 video_extension = codec[1]
2123 if 'hd' in config["video"]["files"][codec[0]]: quality = 'hd'
2124 else: quality = 'sd'
2127 self._downloader.trouble(u'ERROR: no known codec found')
2130 video_url = "http://player.vimeo.com/play_redirect?clip_id=%s&sig=%s&time=%s&quality=%s&codecs=%s&type=moogaloop_local&embed_location=" \
2131 %(video_id, sig, timestamp, quality, video_codec.upper())
2134 # Process video information
2135 self._downloader.process_info({
2138 'uploader': video_uploader,
2139 'upload_date': video_upload_date,
2140 'title': video_title,
2141 'stitle': simple_title,
2142 'ext': video_extension,
2143 'thumbnail': video_thumbnail,
2144 'description': video_description,
2147 except UnavailableVideoError:
2148 self._downloader.trouble(u'ERROR: unable to download video')
2151 class GenericIE(InfoExtractor):
2152 """Generic last-resort information extractor."""
2155 IE_NAME = u'generic'
2157 def __init__(self, downloader=None):
2158 InfoExtractor.__init__(self, downloader)
2160 def report_download_webpage(self, video_id):
2161 """Report webpage download."""
2162 self._downloader.to_screen(u'WARNING: Falling back on generic information extractor.')
2163 self._downloader.to_screen(u'[generic] %s: Downloading webpage' % video_id)
2165 def report_extraction(self, video_id):
2166 """Report information extraction."""
2167 self._downloader.to_screen(u'[generic] %s: Extracting information' % video_id)
2169 def _real_extract(self, url):
2170 # At this point we have a new video
2171 self._downloader.increment_downloads()
2173 video_id = url.split('/')[-1]
2174 request = urllib2.Request(url)
2176 self.report_download_webpage(video_id)
2177 webpage = urllib2.urlopen(request).read()
2178 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2179 self._downloader.trouble(u'ERROR: Unable to retrieve video webpage: %s' % str(err))
2181 except ValueError, err:
2182 # since this is the last-resort InfoExtractor, if
2183 # this error is thrown, it'll be thrown here
2184 self._downloader.trouble(u'ERROR: Invalid URL: %s' % url)
2187 self.report_extraction(video_id)
2188 # Start with something easy: JW Player in SWFObject
2189 mobj = re.search(r'flashvars: [\'"](?:.*&)?file=(http[^\'"&]*)', webpage)
2191 # Broaden the search a little bit
2192 mobj = re.search(r'[^A-Za-z0-9]?(?:file|source)=(http[^\'"&]*)', webpage)
2194 self._downloader.trouble(u'ERROR: Invalid URL: %s' % url)
2197 # It's possible that one of the regexes
2198 # matched, but returned an empty group:
2199 if mobj.group(1) is None:
2200 self._downloader.trouble(u'ERROR: Invalid URL: %s' % url)
2203 video_url = urllib.unquote(mobj.group(1))
2204 video_id = os.path.basename(video_url)
2206 # here's a fun little line of code for you:
2207 video_extension = os.path.splitext(video_id)[1][1:]
2208 video_id = os.path.splitext(video_id)[0]
2210 # it's tempting to parse this further, but you would
2211 # have to take into account all the variations like
2212 # Video Title - Site Name
2213 # Site Name | Video Title
2214 # Video Title - Tagline | Site Name
2215 # and so on and so forth; it's just not practical
2216 mobj = re.search(r'<title>(.*)</title>', webpage)
2218 self._downloader.trouble(u'ERROR: unable to extract title')
2220 video_title = mobj.group(1).decode('utf-8')
2221 video_title = sanitize_title(video_title)
2222 simple_title = _simplify_title(video_title)
2224 # video uploader is domain name
2225 mobj = re.match(r'(?:https?://)?([^/]*)/.*', url)
2227 self._downloader.trouble(u'ERROR: unable to extract title')
2229 video_uploader = mobj.group(1).decode('utf-8')
2232 # Process video information
2233 self._downloader.process_info({
2234 'id': video_id.decode('utf-8'),
2235 'url': video_url.decode('utf-8'),
2236 'uploader': video_uploader,
2237 'upload_date': u'NA',
2238 'title': video_title,
2239 'stitle': simple_title,
2240 'ext': video_extension.decode('utf-8'),
2244 except UnavailableVideoError, err:
2245 self._downloader.trouble(u'\nERROR: unable to download video')
2248 class YoutubeSearchIE(InfoExtractor):
2249 """Information Extractor for YouTube search queries."""
2250 _VALID_URL = r'ytsearch(\d+|all)?:[\s\S]+'
2251 _API_URL = 'https://gdata.youtube.com/feeds/api/videos?q=%s&start-index=%i&max-results=50&v=2&alt=jsonc'
2253 _max_youtube_results = 1000
2254 IE_NAME = u'youtube:search'
2256 def __init__(self, youtube_ie, downloader=None):
2257 InfoExtractor.__init__(self, downloader)
2258 self._youtube_ie = youtube_ie
2260 def report_download_page(self, query, pagenum):
2261 """Report attempt to download playlist page with given number."""
2262 query = query.decode(preferredencoding())
2263 self._downloader.to_screen(u'[youtube] query "%s": Downloading page %s' % (query, pagenum))
2265 def _real_initialize(self):
2266 self._youtube_ie.initialize()
2268 def _real_extract(self, query):
2269 mobj = re.match(self._VALID_URL, query)
2271 self._downloader.trouble(u'ERROR: invalid search query "%s"' % query)
2274 prefix, query = query.split(':')
2276 query = query.encode('utf-8')
2278 self._download_n_results(query, 1)
2280 elif prefix == 'all':
2281 self._download_n_results(query, self._max_youtube_results)
2287 self._downloader.trouble(u'ERROR: invalid download number %s for query "%s"' % (n, query))
2289 elif n > self._max_youtube_results:
2290 self._downloader.to_stderr(u'WARNING: ytsearch returns max %i results (you requested %i)' % (self._max_youtube_results, n))
2291 n = self._max_youtube_results
2292 self._download_n_results(query, n)
2294 except ValueError: # parsing prefix as integer fails
2295 self._download_n_results(query, 1)
2298 def _download_n_results(self, query, n):
2299 """Downloads a specified number of results for a query"""
2305 while (50 * pagenum) < limit:
2306 self.report_download_page(query, pagenum+1)
2307 result_url = self._API_URL % (urllib.quote_plus(query), (50*pagenum)+1)
2308 request = urllib2.Request(result_url)
2310 data = urllib2.urlopen(request).read()
2311 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2312 self._downloader.trouble(u'ERROR: unable to download API page: %s' % str(err))
2314 api_response = json.loads(data)['data']
2316 new_ids = list(video['id'] for video in api_response['items'])
2317 video_ids += new_ids
2319 limit = min(n, api_response['totalItems'])
2322 if len(video_ids) > n:
2323 video_ids = video_ids[:n]
2324 for id in video_ids:
2325 self._youtube_ie.extract('http://www.youtube.com/watch?v=%s' % id)
2329 class GoogleSearchIE(InfoExtractor):
2330 """Information Extractor for Google Video search queries."""
2331 _VALID_URL = r'gvsearch(\d+|all)?:[\s\S]+'
2332 _TEMPLATE_URL = 'http://video.google.com/videosearch?q=%s+site:video.google.com&start=%s&hl=en'
2333 _VIDEO_INDICATOR = r'<a href="http://video\.google\.com/videoplay\?docid=([^"\&]+)'
2334 _MORE_PAGES_INDICATOR = r'class="pn" id="pnnext"'
2336 _max_google_results = 1000
2337 IE_NAME = u'video.google:search'
2339 def __init__(self, google_ie, downloader=None):
2340 InfoExtractor.__init__(self, downloader)
2341 self._google_ie = google_ie
2343 def report_download_page(self, query, pagenum):
2344 """Report attempt to download playlist page with given number."""
2345 query = query.decode(preferredencoding())
2346 self._downloader.to_screen(u'[video.google] query "%s": Downloading page %s' % (query, pagenum))
2348 def _real_initialize(self):
2349 self._google_ie.initialize()
2351 def _real_extract(self, query):
2352 mobj = re.match(self._VALID_URL, query)
2354 self._downloader.trouble(u'ERROR: invalid search query "%s"' % query)
2357 prefix, query = query.split(':')
2359 query = query.encode('utf-8')
2361 self._download_n_results(query, 1)
2363 elif prefix == 'all':
2364 self._download_n_results(query, self._max_google_results)
2370 self._downloader.trouble(u'ERROR: invalid download number %s for query "%s"' % (n, query))
2372 elif n > self._max_google_results:
2373 self._downloader.to_stderr(u'WARNING: gvsearch returns max %i results (you requested %i)' % (self._max_google_results, n))
2374 n = self._max_google_results
2375 self._download_n_results(query, n)
2377 except ValueError: # parsing prefix as integer fails
2378 self._download_n_results(query, 1)
2381 def _download_n_results(self, query, n):
2382 """Downloads a specified number of results for a query"""
2388 self.report_download_page(query, pagenum)
2389 result_url = self._TEMPLATE_URL % (urllib.quote_plus(query), pagenum*10)
2390 request = urllib2.Request(result_url)
2392 page = urllib2.urlopen(request).read()
2393 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2394 self._downloader.trouble(u'ERROR: unable to download webpage: %s' % str(err))
2397 # Extract video identifiers
2398 for mobj in re.finditer(self._VIDEO_INDICATOR, page):
2399 video_id = mobj.group(1)
2400 if video_id not in video_ids:
2401 video_ids.append(video_id)
2402 if len(video_ids) == n:
2403 # Specified n videos reached
2404 for id in video_ids:
2405 self._google_ie.extract('http://video.google.com/videoplay?docid=%s' % id)
2408 if re.search(self._MORE_PAGES_INDICATOR, page) is None:
2409 for id in video_ids:
2410 self._google_ie.extract('http://video.google.com/videoplay?docid=%s' % id)
2413 pagenum = pagenum + 1
2416 class YahooSearchIE(InfoExtractor):
2417 """Information Extractor for Yahoo! Video search queries."""
2418 _VALID_URL = r'yvsearch(\d+|all)?:[\s\S]+'
2419 _TEMPLATE_URL = 'http://video.yahoo.com/search/?p=%s&o=%s'
2420 _VIDEO_INDICATOR = r'href="http://video\.yahoo\.com/watch/([0-9]+/[0-9]+)"'
2421 _MORE_PAGES_INDICATOR = r'\s*Next'
2423 _max_yahoo_results = 1000
2424 IE_NAME = u'video.yahoo:search'
2426 def __init__(self, yahoo_ie, downloader=None):
2427 InfoExtractor.__init__(self, downloader)
2428 self._yahoo_ie = yahoo_ie
2430 def report_download_page(self, query, pagenum):
2431 """Report attempt to download playlist page with given number."""
2432 query = query.decode(preferredencoding())
2433 self._downloader.to_screen(u'[video.yahoo] query "%s": Downloading page %s' % (query, pagenum))
2435 def _real_initialize(self):
2436 self._yahoo_ie.initialize()
2438 def _real_extract(self, query):
2439 mobj = re.match(self._VALID_URL, query)
2441 self._downloader.trouble(u'ERROR: invalid search query "%s"' % query)
2444 prefix, query = query.split(':')
2446 query = query.encode('utf-8')
2448 self._download_n_results(query, 1)
2450 elif prefix == 'all':
2451 self._download_n_results(query, self._max_yahoo_results)
2457 self._downloader.trouble(u'ERROR: invalid download number %s for query "%s"' % (n, query))
2459 elif n > self._max_yahoo_results:
2460 self._downloader.to_stderr(u'WARNING: yvsearch returns max %i results (you requested %i)' % (self._max_yahoo_results, n))
2461 n = self._max_yahoo_results
2462 self._download_n_results(query, n)
2464 except ValueError: # parsing prefix as integer fails
2465 self._download_n_results(query, 1)
2468 def _download_n_results(self, query, n):
2469 """Downloads a specified number of results for a query"""
2472 already_seen = set()
2476 self.report_download_page(query, pagenum)
2477 result_url = self._TEMPLATE_URL % (urllib.quote_plus(query), pagenum)
2478 request = urllib2.Request(result_url)
2480 page = urllib2.urlopen(request).read()
2481 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2482 self._downloader.trouble(u'ERROR: unable to download webpage: %s' % str(err))
2485 # Extract video identifiers
2486 for mobj in re.finditer(self._VIDEO_INDICATOR, page):
2487 video_id = mobj.group(1)
2488 if video_id not in already_seen:
2489 video_ids.append(video_id)
2490 already_seen.add(video_id)
2491 if len(video_ids) == n:
2492 # Specified n videos reached
2493 for id in video_ids:
2494 self._yahoo_ie.extract('http://video.yahoo.com/watch/%s' % id)
2497 if re.search(self._MORE_PAGES_INDICATOR, page) is None:
2498 for id in video_ids:
2499 self._yahoo_ie.extract('http://video.yahoo.com/watch/%s' % id)
2502 pagenum = pagenum + 1
2505 class YoutubePlaylistIE(InfoExtractor):
2506 """Information Extractor for YouTube playlists."""
2508 _VALID_URL = r'(?:https?://)?(?:\w+\.)?youtube\.com/(?:(?:course|view_play_list|my_playlists|artist|playlist)\?.*?(p|a|list)=|user/.*?/user/|p/|user/.*?#[pg]/c/)(?:PL)?([0-9A-Za-z-_]+)(?:/.*?/([0-9A-Za-z_-]+))?.*'
2509 _TEMPLATE_URL = 'http://www.youtube.com/%s?%s=%s&page=%s&gl=US&hl=en'
2510 _VIDEO_INDICATOR = r'/watch\?v=(.+?)&'
2511 _MORE_PAGES_INDICATOR = r'(?m)>\s*Next\s*</a>'
2513 IE_NAME = u'youtube:playlist'
2515 def __init__(self, youtube_ie, downloader=None):
2516 InfoExtractor.__init__(self, downloader)
2517 self._youtube_ie = youtube_ie
2519 def report_download_page(self, playlist_id, pagenum):
2520 """Report attempt to download playlist page with given number."""
2521 self._downloader.to_screen(u'[youtube] PL %s: Downloading page #%s' % (playlist_id, pagenum))
2523 def _real_initialize(self):
2524 self._youtube_ie.initialize()
2526 def _real_extract(self, url):
2527 # Extract playlist id
2528 mobj = re.match(self._VALID_URL, url)
2530 self._downloader.trouble(u'ERROR: invalid url: %s' % url)
2534 if mobj.group(3) is not None:
2535 self._youtube_ie.extract(mobj.group(3))
2538 # Download playlist pages
2539 # prefix is 'p' as default for playlists but there are other types that need extra care
2540 playlist_prefix = mobj.group(1)
2541 if playlist_prefix == 'a':
2542 playlist_access = 'artist'
2544 playlist_prefix = 'p'
2545 playlist_access = 'view_play_list'
2546 playlist_id = mobj.group(2)
2551 self.report_download_page(playlist_id, pagenum)
2552 url = self._TEMPLATE_URL % (playlist_access, playlist_prefix, playlist_id, pagenum)
2553 request = urllib2.Request(url)
2555 page = urllib2.urlopen(request).read()
2556 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2557 self._downloader.trouble(u'ERROR: unable to download webpage: %s' % str(err))
2560 # Extract video identifiers
2562 for mobj in re.finditer(self._VIDEO_INDICATOR, page):
2563 if mobj.group(1) not in ids_in_page:
2564 ids_in_page.append(mobj.group(1))
2565 video_ids.extend(ids_in_page)
2567 if re.search(self._MORE_PAGES_INDICATOR, page) is None:
2569 pagenum = pagenum + 1
2571 playliststart = self._downloader.params.get('playliststart', 1) - 1
2572 playlistend = self._downloader.params.get('playlistend', -1)
2573 video_ids = video_ids[playliststart:playlistend]
2575 for id in video_ids:
2576 self._youtube_ie.extract('http://www.youtube.com/watch?v=%s' % id)
2580 class YoutubeUserIE(InfoExtractor):
2581 """Information Extractor for YouTube users."""
2583 _VALID_URL = r'(?:(?:(?:https?://)?(?:\w+\.)?youtube\.com/user/)|ytuser:)([A-Za-z0-9_-]+)'
2584 _TEMPLATE_URL = 'http://gdata.youtube.com/feeds/api/users/%s'
2585 _GDATA_PAGE_SIZE = 50
2586 _GDATA_URL = 'http://gdata.youtube.com/feeds/api/users/%s/uploads?max-results=%d&start-index=%d'
2587 _VIDEO_INDICATOR = r'/watch\?v=(.+?)[\<&]'
2589 IE_NAME = u'youtube:user'
2591 def __init__(self, youtube_ie, downloader=None):
2592 InfoExtractor.__init__(self, downloader)
2593 self._youtube_ie = youtube_ie
2595 def report_download_page(self, username, start_index):
2596 """Report attempt to download user page."""
2597 self._downloader.to_screen(u'[youtube] user %s: Downloading video ids from %d to %d' %
2598 (username, start_index, start_index + self._GDATA_PAGE_SIZE))
2600 def _real_initialize(self):
2601 self._youtube_ie.initialize()
2603 def _real_extract(self, url):
2605 mobj = re.match(self._VALID_URL, url)
2607 self._downloader.trouble(u'ERROR: invalid url: %s' % url)
2610 username = mobj.group(1)
2612 # Download video ids using YouTube Data API. Result size per
2613 # query is limited (currently to 50 videos) so we need to query
2614 # page by page until there are no video ids - it means we got
2621 start_index = pagenum * self._GDATA_PAGE_SIZE + 1
2622 self.report_download_page(username, start_index)
2624 request = urllib2.Request(self._GDATA_URL % (username, self._GDATA_PAGE_SIZE, start_index))
2627 page = urllib2.urlopen(request).read()
2628 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2629 self._downloader.trouble(u'ERROR: unable to download webpage: %s' % str(err))
2632 # Extract video identifiers
2635 for mobj in re.finditer(self._VIDEO_INDICATOR, page):
2636 if mobj.group(1) not in ids_in_page:
2637 ids_in_page.append(mobj.group(1))
2639 video_ids.extend(ids_in_page)
2641 # A little optimization - if current page is not
2642 # "full", ie. does not contain PAGE_SIZE video ids then
2643 # we can assume that this page is the last one - there
2644 # are no more ids on further pages - no need to query
2647 if len(ids_in_page) < self._GDATA_PAGE_SIZE:
2652 all_ids_count = len(video_ids)
2653 playliststart = self._downloader.params.get('playliststart', 1) - 1
2654 playlistend = self._downloader.params.get('playlistend', -1)
2656 if playlistend == -1:
2657 video_ids = video_ids[playliststart:]
2659 video_ids = video_ids[playliststart:playlistend]
2661 self._downloader.to_screen(u"[youtube] user %s: Collected %d video ids (downloading %d of them)" %
2662 (username, all_ids_count, len(video_ids)))
2664 for video_id in video_ids:
2665 self._youtube_ie.extract('http://www.youtube.com/watch?v=%s' % video_id)
2668 class DepositFilesIE(InfoExtractor):
2669 """Information extractor for depositfiles.com"""
2671 _VALID_URL = r'(?:http://)?(?:\w+\.)?depositfiles\.com/(?:../(?#locale))?files/(.+)'
2672 IE_NAME = u'DepositFiles'
2674 def __init__(self, downloader=None):
2675 InfoExtractor.__init__(self, downloader)
2677 def report_download_webpage(self, file_id):
2678 """Report webpage download."""
2679 self._downloader.to_screen(u'[DepositFiles] %s: Downloading webpage' % file_id)
2681 def report_extraction(self, file_id):
2682 """Report information extraction."""
2683 self._downloader.to_screen(u'[DepositFiles] %s: Extracting information' % file_id)
2685 def _real_extract(self, url):
2686 # At this point we have a new file
2687 self._downloader.increment_downloads()
2689 file_id = url.split('/')[-1]
2690 # Rebuild url in english locale
2691 url = 'http://depositfiles.com/en/files/' + file_id
2693 # Retrieve file webpage with 'Free download' button pressed
2694 free_download_indication = { 'gateway_result' : '1' }
2695 request = urllib2.Request(url, urllib.urlencode(free_download_indication))
2697 self.report_download_webpage(file_id)
2698 webpage = urllib2.urlopen(request).read()
2699 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2700 self._downloader.trouble(u'ERROR: Unable to retrieve file webpage: %s' % str(err))
2703 # Search for the real file URL
2704 mobj = re.search(r'<form action="(http://fileshare.+?)"', webpage)
2705 if (mobj is None) or (mobj.group(1) is None):
2706 # Try to figure out reason of the error.
2707 mobj = re.search(r'<strong>(Attention.*?)</strong>', webpage, re.DOTALL)
2708 if (mobj is not None) and (mobj.group(1) is not None):
2709 restriction_message = re.sub('\s+', ' ', mobj.group(1)).strip()
2710 self._downloader.trouble(u'ERROR: %s' % restriction_message)
2712 self._downloader.trouble(u'ERROR: unable to extract download URL from: %s' % url)
2715 file_url = mobj.group(1)
2716 file_extension = os.path.splitext(file_url)[1][1:]
2718 # Search for file title
2719 mobj = re.search(r'<b title="(.*?)">', webpage)
2721 self._downloader.trouble(u'ERROR: unable to extract title')
2723 file_title = mobj.group(1).decode('utf-8')
2726 # Process file information
2727 self._downloader.process_info({
2728 'id': file_id.decode('utf-8'),
2729 'url': file_url.decode('utf-8'),
2731 'upload_date': u'NA',
2732 'title': file_title,
2733 'stitle': file_title,
2734 'ext': file_extension.decode('utf-8'),
2738 except UnavailableVideoError, err:
2739 self._downloader.trouble(u'ERROR: unable to download file')
2742 class FacebookIE(InfoExtractor):
2743 """Information Extractor for Facebook"""
2745 _VALID_URL = r'^(?:https?://)?(?:\w+\.)?facebook\.com/(?:video/video|photo)\.php\?(?:.*?)v=(?P<ID>\d+)(?:.*)'
2746 _LOGIN_URL = 'https://login.facebook.com/login.php?m&next=http%3A%2F%2Fm.facebook.com%2Fhome.php&'
2747 _NETRC_MACHINE = 'facebook'
2748 _available_formats = ['video', 'highqual', 'lowqual']
2749 _video_extensions = {
2754 IE_NAME = u'facebook'
2756 def __init__(self, downloader=None):
2757 InfoExtractor.__init__(self, downloader)
2759 def _reporter(self, message):
2760 """Add header and report message."""
2761 self._downloader.to_screen(u'[facebook] %s' % message)
2763 def report_login(self):
2764 """Report attempt to log in."""
2765 self._reporter(u'Logging in')
2767 def report_video_webpage_download(self, video_id):
2768 """Report attempt to download video webpage."""
2769 self._reporter(u'%s: Downloading video webpage' % video_id)
2771 def report_information_extraction(self, video_id):
2772 """Report attempt to extract video information."""
2773 self._reporter(u'%s: Extracting video information' % video_id)
2775 def _parse_page(self, video_webpage):
2776 """Extract video information from page"""
2778 data = {'title': r'\("video_title", "(.*?)"\)',
2779 'description': r'<div class="datawrap">(.*?)</div>',
2780 'owner': r'\("video_owner_name", "(.*?)"\)',
2781 'thumbnail': r'\("thumb_url", "(?P<THUMB>.*?)"\)',
2784 for piece in data.keys():
2785 mobj = re.search(data[piece], video_webpage)
2786 if mobj is not None:
2787 video_info[piece] = urllib.unquote_plus(mobj.group(1).decode("unicode_escape"))
2791 for fmt in self._available_formats:
2792 mobj = re.search(r'\("%s_src\", "(.+?)"\)' % fmt, video_webpage)
2793 if mobj is not None:
2794 # URL is in a Javascript segment inside an escaped Unicode format within
2795 # the generally utf-8 page
2796 video_urls[fmt] = urllib.unquote_plus(mobj.group(1).decode("unicode_escape"))
2797 video_info['video_urls'] = video_urls
2801 def _real_initialize(self):
2802 if self._downloader is None:
2807 downloader_params = self._downloader.params
2809 # Attempt to use provided username and password or .netrc data
2810 if downloader_params.get('username', None) is not None:
2811 useremail = downloader_params['username']
2812 password = downloader_params['password']
2813 elif downloader_params.get('usenetrc', False):
2815 info = netrc.netrc().authenticators(self._NETRC_MACHINE)
2816 if info is not None:
2820 raise netrc.NetrcParseError('No authenticators for %s' % self._NETRC_MACHINE)
2821 except (IOError, netrc.NetrcParseError), err:
2822 self._downloader.to_stderr(u'WARNING: parsing .netrc: %s' % str(err))
2825 if useremail is None:
2834 request = urllib2.Request(self._LOGIN_URL, urllib.urlencode(login_form))
2837 login_results = urllib2.urlopen(request).read()
2838 if re.search(r'<form(.*)name="login"(.*)</form>', login_results) is not None:
2839 self._downloader.to_stderr(u'WARNING: unable to log in: bad username/password, or exceded login rate limit (~3/min). Check credentials or wait.')
2841 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2842 self._downloader.to_stderr(u'WARNING: unable to log in: %s' % str(err))
2845 def _real_extract(self, url):
2846 mobj = re.match(self._VALID_URL, url)
2848 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
2850 video_id = mobj.group('ID')
2853 self.report_video_webpage_download(video_id)
2854 request = urllib2.Request('https://www.facebook.com/video/video.php?v=%s' % video_id)
2856 page = urllib2.urlopen(request)
2857 video_webpage = page.read()
2858 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
2859 self._downloader.trouble(u'ERROR: unable to download video webpage: %s' % str(err))
2862 # Start extracting information
2863 self.report_information_extraction(video_id)
2865 # Extract information
2866 video_info = self._parse_page(video_webpage)
2869 if 'owner' not in video_info:
2870 self._downloader.trouble(u'ERROR: unable to extract uploader nickname')
2872 video_uploader = video_info['owner']
2875 if 'title' not in video_info:
2876 self._downloader.trouble(u'ERROR: unable to extract video title')
2878 video_title = video_info['title']
2879 video_title = video_title.decode('utf-8')
2880 video_title = sanitize_title(video_title)
2882 simple_title = _simplify_title(video_title)
2885 if 'thumbnail' not in video_info:
2886 self._downloader.trouble(u'WARNING: unable to extract video thumbnail')
2887 video_thumbnail = ''
2889 video_thumbnail = video_info['thumbnail']
2893 if 'upload_date' in video_info:
2894 upload_time = video_info['upload_date']
2895 timetuple = email.utils.parsedate_tz(upload_time)
2896 if timetuple is not None:
2898 upload_date = time.strftime('%Y%m%d', timetuple[0:9])
2903 video_description = video_info.get('description', 'No description available.')
2905 url_map = video_info['video_urls']
2906 if len(url_map.keys()) > 0:
2907 # Decide which formats to download
2908 req_format = self._downloader.params.get('format', None)
2909 format_limit = self._downloader.params.get('format_limit', None)
2911 if format_limit is not None and format_limit in self._available_formats:
2912 format_list = self._available_formats[self._available_formats.index(format_limit):]
2914 format_list = self._available_formats
2915 existing_formats = [x for x in format_list if x in url_map]
2916 if len(existing_formats) == 0:
2917 self._downloader.trouble(u'ERROR: no known formats available for video')
2919 if req_format is None:
2920 video_url_list = [(existing_formats[0], url_map[existing_formats[0]])] # Best quality
2921 elif req_format == 'worst':
2922 video_url_list = [(existing_formats[len(existing_formats)-1], url_map[existing_formats[len(existing_formats)-1]])] # worst quality
2923 elif req_format == '-1':
2924 video_url_list = [(f, url_map[f]) for f in existing_formats] # All formats
2927 if req_format not in url_map:
2928 self._downloader.trouble(u'ERROR: requested format not available')
2930 video_url_list = [(req_format, url_map[req_format])] # Specific format
2932 for format_param, video_real_url in video_url_list:
2934 # At this point we have a new video
2935 self._downloader.increment_downloads()
2938 video_extension = self._video_extensions.get(format_param, 'mp4')
2941 # Process video information
2942 self._downloader.process_info({
2943 'id': video_id.decode('utf-8'),
2944 'url': video_real_url.decode('utf-8'),
2945 'uploader': video_uploader.decode('utf-8'),
2946 'upload_date': upload_date,
2947 'title': video_title,
2948 'stitle': simple_title,
2949 'ext': video_extension.decode('utf-8'),
2950 'format': (format_param is None and u'NA' or format_param.decode('utf-8')),
2951 'thumbnail': video_thumbnail.decode('utf-8'),
2952 'description': video_description.decode('utf-8'),
2955 except UnavailableVideoError, err:
2956 self._downloader.trouble(u'\nERROR: unable to download video')
2958 class BlipTVIE(InfoExtractor):
2959 """Information extractor for blip.tv"""
2961 _VALID_URL = r'^(?:https?://)?(?:\w+\.)?blip\.tv(/.+)$'
2962 _URL_EXT = r'^.*\.([a-z0-9]+)$'
2963 IE_NAME = u'blip.tv'
2965 def report_extraction(self, file_id):
2966 """Report information extraction."""
2967 self._downloader.to_screen(u'[%s] %s: Extracting information' % (self.IE_NAME, file_id))
2969 def report_direct_download(self, title):
2970 """Report information extraction."""
2971 self._downloader.to_screen(u'[%s] %s: Direct download detected' % (self.IE_NAME, title))
2973 def _real_extract(self, url):
2974 mobj = re.match(self._VALID_URL, url)
2976 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
2983 json_url = url + cchar + 'skin=json&version=2&no_wrap=1'
2984 request = urllib2.Request(json_url)
2985 self.report_extraction(mobj.group(1))
2988 urlh = urllib2.urlopen(request)
2989 if urlh.headers.get('Content-Type', '').startswith('video/'): # Direct download
2990 basename = url.split('/')[-1]
2991 title,ext = os.path.splitext(basename)
2992 title = title.decode('UTF-8')
2993 ext = ext.replace('.', '')
2994 self.report_direct_download(title)
2999 'stitle': _simplify_title(title),
3003 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3004 self._downloader.trouble(u'ERROR: unable to download video info webpage: %s' % str(err))
3006 if info is None: # Regular URL
3008 json_code = urlh.read()
3009 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3010 self._downloader.trouble(u'ERROR: unable to read video info webpage: %s' % str(err))
3014 json_data = json.loads(json_code)
3015 if 'Post' in json_data:
3016 data = json_data['Post']
3020 upload_date = datetime.datetime.strptime(data['datestamp'], '%m-%d-%y %H:%M%p').strftime('%Y%m%d')
3021 video_url = data['media']['url']
3022 umobj = re.match(self._URL_EXT, video_url)
3024 raise ValueError('Can not determine filename extension')
3025 ext = umobj.group(1)
3028 'id': data['item_id'],
3030 'uploader': data['display_name'],
3031 'upload_date': upload_date,
3032 'title': data['title'],
3033 'stitle': _simplify_title(data['title']),
3035 'format': data['media']['mimeType'],
3036 'thumbnail': data['thumbnailUrl'],
3037 'description': data['description'],
3038 'player_url': data['embedUrl']
3040 except (ValueError,KeyError), err:
3041 self._downloader.trouble(u'ERROR: unable to parse video information: %s' % repr(err))
3044 self._downloader.increment_downloads()
3047 self._downloader.process_info(info)
3048 except UnavailableVideoError, err:
3049 self._downloader.trouble(u'\nERROR: unable to download video')
3052 class MyVideoIE(InfoExtractor):
3053 """Information Extractor for myvideo.de."""
3055 _VALID_URL = r'(?:http://)?(?:www\.)?myvideo\.de/watch/([0-9]+)/([^?/]+).*'
3056 IE_NAME = u'myvideo'
3058 def __init__(self, downloader=None):
3059 InfoExtractor.__init__(self, downloader)
3061 def report_download_webpage(self, video_id):
3062 """Report webpage download."""
3063 self._downloader.to_screen(u'[myvideo] %s: Downloading webpage' % video_id)
3065 def report_extraction(self, video_id):
3066 """Report information extraction."""
3067 self._downloader.to_screen(u'[myvideo] %s: Extracting information' % video_id)
3069 def _real_extract(self,url):
3070 mobj = re.match(self._VALID_URL, url)
3072 self._download.trouble(u'ERROR: invalid URL: %s' % url)
3075 video_id = mobj.group(1)
3078 request = urllib2.Request('http://www.myvideo.de/watch/%s' % video_id)
3080 self.report_download_webpage(video_id)
3081 webpage = urllib2.urlopen(request).read()
3082 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3083 self._downloader.trouble(u'ERROR: Unable to retrieve video webpage: %s' % str(err))
3086 self.report_extraction(video_id)
3087 mobj = re.search(r'<link rel=\'image_src\' href=\'(http://is[0-9].myvideo\.de/de/movie[0-9]+/[a-f0-9]+)/thumbs/[^.]+\.jpg\' />',
3090 self._downloader.trouble(u'ERROR: unable to extract media URL')
3092 video_url = mobj.group(1) + ('/%s.flv' % video_id)
3094 mobj = re.search('<title>([^<]+)</title>', webpage)
3096 self._downloader.trouble(u'ERROR: unable to extract title')
3099 video_title = mobj.group(1)
3100 video_title = sanitize_title(video_title)
3102 simple_title = _simplify_title(video_title)
3105 self._downloader.process_info({
3109 'upload_date': u'NA',
3110 'title': video_title,
3111 'stitle': simple_title,
3116 except UnavailableVideoError:
3117 self._downloader.trouble(u'\nERROR: Unable to download video')
3119 class ComedyCentralIE(InfoExtractor):
3120 """Information extractor for The Daily Show and Colbert Report """
3122 _VALID_URL = r'^(:(?P<shortname>tds|thedailyshow|cr|colbert|colbertnation|colbertreport))|(https?://)?(www\.)?(?P<showname>thedailyshow|colbertnation)\.com/full-episodes/(?P<episode>.*)$'
3123 IE_NAME = u'comedycentral'
3125 def report_extraction(self, episode_id):
3126 self._downloader.to_screen(u'[comedycentral] %s: Extracting information' % episode_id)
3128 def report_config_download(self, episode_id):
3129 self._downloader.to_screen(u'[comedycentral] %s: Downloading configuration' % episode_id)
3131 def report_index_download(self, episode_id):
3132 self._downloader.to_screen(u'[comedycentral] %s: Downloading show index' % episode_id)
3134 def report_player_url(self, episode_id):
3135 self._downloader.to_screen(u'[comedycentral] %s: Determining player URL' % episode_id)
3137 def _real_extract(self, url):
3138 mobj = re.match(self._VALID_URL, url)
3140 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
3143 if mobj.group('shortname'):
3144 if mobj.group('shortname') in ('tds', 'thedailyshow'):
3145 url = u'http://www.thedailyshow.com/full-episodes/'
3147 url = u'http://www.colbertnation.com/full-episodes/'
3148 mobj = re.match(self._VALID_URL, url)
3149 assert mobj is not None
3151 dlNewest = not mobj.group('episode')
3153 epTitle = mobj.group('showname')
3155 epTitle = mobj.group('episode')
3157 req = urllib2.Request(url)
3158 self.report_extraction(epTitle)
3160 htmlHandle = urllib2.urlopen(req)
3161 html = htmlHandle.read()
3162 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3163 self._downloader.trouble(u'ERROR: unable to download webpage: %s' % unicode(err))
3166 url = htmlHandle.geturl()
3167 mobj = re.match(self._VALID_URL, url)
3169 self._downloader.trouble(u'ERROR: Invalid redirected URL: ' + url)
3171 if mobj.group('episode') == '':
3172 self._downloader.trouble(u'ERROR: Redirected URL is still not specific: ' + url)
3174 epTitle = mobj.group('episode')
3176 mMovieParams = re.findall('(?:<param name="movie" value="|var url = ")(http://media.mtvnservices.com/([^"]*episode.*?:.*?))"', html)
3177 if len(mMovieParams) == 0:
3178 self._downloader.trouble(u'ERROR: unable to find Flash URL in webpage ' + url)
3181 playerUrl_raw = mMovieParams[0][0]
3182 self.report_player_url(epTitle)
3184 urlHandle = urllib2.urlopen(playerUrl_raw)
3185 playerUrl = urlHandle.geturl()
3186 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3187 self._downloader.trouble(u'ERROR: unable to find out player URL: ' + unicode(err))
3190 uri = mMovieParams[0][1]
3191 indexUrl = 'http://shadow.comedycentral.com/feeds/video_player/mrss/?' + urllib.urlencode({'uri': uri})
3192 self.report_index_download(epTitle)
3194 indexXml = urllib2.urlopen(indexUrl).read()
3195 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3196 self._downloader.trouble(u'ERROR: unable to download episode index: ' + unicode(err))
3199 idoc = xml.etree.ElementTree.fromstring(indexXml)
3200 itemEls = idoc.findall('.//item')
3201 for itemEl in itemEls:
3202 mediaId = itemEl.findall('./guid')[0].text
3203 shortMediaId = mediaId.split(':')[-1]
3204 showId = mediaId.split(':')[-2].replace('.com', '')
3205 officialTitle = itemEl.findall('./title')[0].text
3206 officialDate = itemEl.findall('./pubDate')[0].text
3208 configUrl = ('http://www.comedycentral.com/global/feeds/entertainment/media/mediaGenEntertainment.jhtml?' +
3209 urllib.urlencode({'uri': mediaId}))
3210 configReq = urllib2.Request(configUrl)
3211 self.report_config_download(epTitle)
3213 configXml = urllib2.urlopen(configReq).read()
3214 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3215 self._downloader.trouble(u'ERROR: unable to download webpage: %s' % unicode(err))
3218 cdoc = xml.etree.ElementTree.fromstring(configXml)
3220 for rendition in cdoc.findall('.//rendition'):
3221 finfo = (rendition.attrib['bitrate'], rendition.findall('./src')[0].text)
3225 self._downloader.trouble(u'\nERROR: unable to download ' + mediaId + ': No videos found')
3228 # For now, just pick the highest bitrate
3229 format,video_url = turls[-1]
3231 self._downloader.increment_downloads()
3233 effTitle = showId + u'-' + epTitle
3238 'upload_date': officialDate,
3240 'stitle': _simplify_title(effTitle),
3244 'description': officialTitle,
3245 'player_url': playerUrl
3249 self._downloader.process_info(info)
3250 except UnavailableVideoError, err:
3251 self._downloader.trouble(u'\nERROR: unable to download ' + mediaId)
3255 class EscapistIE(InfoExtractor):
3256 """Information extractor for The Escapist """
3258 _VALID_URL = r'^(https?://)?(www\.)?escapistmagazine\.com/videos/view/(?P<showname>[^/]+)/(?P<episode>[^/?]+)[/?]?.*$'
3259 IE_NAME = u'escapist'
3261 def report_extraction(self, showName):
3262 self._downloader.to_screen(u'[escapist] %s: Extracting information' % showName)
3264 def report_config_download(self, showName):
3265 self._downloader.to_screen(u'[escapist] %s: Downloading configuration' % showName)
3267 def _real_extract(self, url):
3268 htmlParser = HTMLParser.HTMLParser()
3270 mobj = re.match(self._VALID_URL, url)
3272 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
3274 showName = mobj.group('showname')
3275 videoId = mobj.group('episode')
3277 self.report_extraction(showName)
3279 webPage = urllib2.urlopen(url).read()
3280 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3281 self._downloader.trouble(u'ERROR: unable to download webpage: ' + unicode(err))
3284 descMatch = re.search('<meta name="description" content="([^"]*)"', webPage)
3285 description = htmlParser.unescape(descMatch.group(1))
3286 imgMatch = re.search('<meta property="og:image" content="([^"]*)"', webPage)
3287 imgUrl = htmlParser.unescape(imgMatch.group(1))
3288 playerUrlMatch = re.search('<meta property="og:video" content="([^"]*)"', webPage)
3289 playerUrl = htmlParser.unescape(playerUrlMatch.group(1))
3290 configUrlMatch = re.search('config=(.*)$', playerUrl)
3291 configUrl = urllib2.unquote(configUrlMatch.group(1))
3293 self.report_config_download(showName)
3295 configJSON = urllib2.urlopen(configUrl).read()
3296 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3297 self._downloader.trouble(u'ERROR: unable to download configuration: ' + unicode(err))
3300 # Technically, it's JavaScript, not JSON
3301 configJSON = configJSON.replace("'", '"')
3304 config = json.loads(configJSON)
3305 except (ValueError,), err:
3306 self._downloader.trouble(u'ERROR: Invalid JSON in configuration file: ' + unicode(err))
3309 playlist = config['playlist']
3310 videoUrl = playlist[1]['url']
3312 self._downloader.increment_downloads()
3316 'uploader': showName,
3317 'upload_date': None,
3319 'stitle': _simplify_title(showName),
3322 'thumbnail': imgUrl,
3323 'description': description,
3324 'player_url': playerUrl,
3328 self._downloader.process_info(info)
3329 except UnavailableVideoError, err:
3330 self._downloader.trouble(u'\nERROR: unable to download ' + videoId)
3333 class CollegeHumorIE(InfoExtractor):
3334 """Information extractor for collegehumor.com"""
3336 _VALID_URL = r'^(?:https?://)?(?:www\.)?collegehumor\.com/video/(?P<videoid>[0-9]+)/(?P<shorttitle>.*)$'
3337 IE_NAME = u'collegehumor'
3339 def report_webpage(self, video_id):
3340 """Report information extraction."""
3341 self._downloader.to_screen(u'[%s] %s: Downloading webpage' % (self.IE_NAME, video_id))
3343 def report_extraction(self, video_id):
3344 """Report information extraction."""
3345 self._downloader.to_screen(u'[%s] %s: Extracting information' % (self.IE_NAME, video_id))
3347 def _real_extract(self, url):
3348 htmlParser = HTMLParser.HTMLParser()
3350 mobj = re.match(self._VALID_URL, url)
3352 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
3354 video_id = mobj.group('videoid')
3356 self.report_webpage(video_id)
3357 request = urllib2.Request(url)
3359 webpage = urllib2.urlopen(request).read()
3360 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3361 self._downloader.trouble(u'ERROR: unable to download video webpage: %s' % str(err))
3364 m = re.search(r'id="video:(?P<internalvideoid>[0-9]+)"', webpage)
3366 self._downloader.trouble(u'ERROR: Cannot extract internal video ID')
3368 internal_video_id = m.group('internalvideoid')
3372 'internal_id': internal_video_id,
3375 self.report_extraction(video_id)
3376 xmlUrl = 'http://www.collegehumor.com/moogaloop/video:' + internal_video_id
3378 metaXml = urllib2.urlopen(xmlUrl).read()
3379 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3380 self._downloader.trouble(u'ERROR: unable to download video info XML: %s' % str(err))
3383 mdoc = xml.etree.ElementTree.fromstring(metaXml)
3385 videoNode = mdoc.findall('./video')[0]
3386 info['description'] = videoNode.findall('./description')[0].text
3387 info['title'] = videoNode.findall('./caption')[0].text
3388 info['stitle'] = _simplify_title(info['title'])
3389 info['url'] = videoNode.findall('./file')[0].text
3390 info['thumbnail'] = videoNode.findall('./thumbnail')[0].text
3391 info['ext'] = info['url'].rpartition('.')[2]
3392 info['format'] = info['ext']
3394 self._downloader.trouble(u'\nERROR: Invalid metadata XML file')
3397 self._downloader.increment_downloads()
3400 self._downloader.process_info(info)
3401 except UnavailableVideoError, err:
3402 self._downloader.trouble(u'\nERROR: unable to download video')
3405 class XVideosIE(InfoExtractor):
3406 """Information extractor for xvideos.com"""
3408 _VALID_URL = r'^(?:https?://)?(?:www\.)?xvideos\.com/video([0-9]+)(?:.*)'
3409 IE_NAME = u'xvideos'
3411 def report_webpage(self, video_id):
3412 """Report information extraction."""
3413 self._downloader.to_screen(u'[%s] %s: Downloading webpage' % (self.IE_NAME, video_id))
3415 def report_extraction(self, video_id):
3416 """Report information extraction."""
3417 self._downloader.to_screen(u'[%s] %s: Extracting information' % (self.IE_NAME, video_id))
3419 def _real_extract(self, url):
3420 htmlParser = HTMLParser.HTMLParser()
3422 mobj = re.match(self._VALID_URL, url)
3424 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
3426 video_id = mobj.group(1).decode('utf-8')
3428 self.report_webpage(video_id)
3430 request = urllib2.Request(r'http://www.xvideos.com/video' + video_id)
3432 webpage = urllib2.urlopen(request).read()
3433 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3434 self._downloader.trouble(u'ERROR: unable to download video webpage: %s' % str(err))
3437 self.report_extraction(video_id)
3441 mobj = re.search(r'flv_url=(.+?)&', webpage)
3443 self._downloader.trouble(u'ERROR: unable to extract video url')
3445 video_url = urllib2.unquote(mobj.group(1).decode('utf-8'))
3449 mobj = re.search(r'<title>(.*?)\s+-\s+XVID', webpage)
3451 self._downloader.trouble(u'ERROR: unable to extract video title')
3453 video_title = mobj.group(1).decode('utf-8')
3456 # Extract video thumbnail
3457 mobj = re.search(r'http://(?:img.*?\.)xvideos.com/videos/thumbs/[a-fA-F0-9]/[a-fA-F0-9]/[a-fA-F0-9]/([a-fA-F0-9.]+jpg)', webpage)
3459 self._downloader.trouble(u'ERROR: unable to extract video thumbnail')
3461 video_thumbnail = mobj.group(1).decode('utf-8')
3465 self._downloader.increment_downloads()
3470 'upload_date': None,
3471 'title': video_title,
3472 'stitle': _simplify_title(video_title),
3475 'thumbnail': video_thumbnail,
3476 'description': None,
3481 self._downloader.process_info(info)
3482 except UnavailableVideoError, err:
3483 self._downloader.trouble(u'\nERROR: unable to download ' + video_id)
3486 class SoundcloudIE(InfoExtractor):
3487 """Information extractor for soundcloud.com
3488 To access the media, the uid of the song and a stream token
3489 must be extracted from the page source and the script must make
3490 a request to media.soundcloud.com/crossdomain.xml. Then
3491 the media can be grabbed by requesting from an url composed
3492 of the stream token and uid
3495 _VALID_URL = r'^(?:https?://)?(?:www\.)?soundcloud\.com/([\w\d-]+)/([\w\d-]+)'
3496 IE_NAME = u'soundcloud'
3498 def __init__(self, downloader=None):
3499 InfoExtractor.__init__(self, downloader)
3501 def report_webpage(self, video_id):
3502 """Report information extraction."""
3503 self._downloader.to_screen(u'[%s] %s: Downloading webpage' % (self.IE_NAME, video_id))
3505 def report_extraction(self, video_id):
3506 """Report information extraction."""
3507 self._downloader.to_screen(u'[%s] %s: Extracting information' % (self.IE_NAME, video_id))
3509 def _real_extract(self, url):
3510 htmlParser = HTMLParser.HTMLParser()
3512 mobj = re.match(self._VALID_URL, url)
3514 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
3517 # extract uploader (which is in the url)
3518 uploader = mobj.group(1).decode('utf-8')
3519 # extract simple title (uploader + slug of song title)
3520 slug_title = mobj.group(2).decode('utf-8')
3521 simple_title = uploader + '-' + slug_title
3523 self.report_webpage('%s/%s' % (uploader, slug_title))
3525 request = urllib2.Request('http://soundcloud.com/%s/%s' % (uploader, slug_title))
3527 webpage = urllib2.urlopen(request).read()
3528 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3529 self._downloader.trouble(u'ERROR: unable to download video webpage: %s' % str(err))
3532 self.report_extraction('%s/%s' % (uploader, slug_title))
3534 # extract uid and stream token that soundcloud hands out for access
3535 mobj = re.search('"uid":"([\w\d]+?)".*?stream_token=([\w\d]+)', webpage)
3537 video_id = mobj.group(1)
3538 stream_token = mobj.group(2)
3540 # extract unsimplified title
3541 mobj = re.search('"title":"(.*?)",', webpage)
3543 title = mobj.group(1)
3545 # construct media url (with uid/token)
3546 mediaURL = "http://media.soundcloud.com/stream/%s?stream_token=%s"
3547 mediaURL = mediaURL % (video_id, stream_token)
3550 description = u'No description available'
3551 mobj = re.search('track-description-value"><p>(.*?)</p>', webpage)
3553 description = mobj.group(1)
3557 mobj = re.search("pretty-date'>on ([\w]+ [\d]+, [\d]+ \d+:\d+)</abbr></h2>", webpage)
3560 upload_date = datetime.datetime.strptime(mobj.group(1), '%B %d, %Y %H:%M').strftime('%Y%m%d')
3561 except Exception, e:
3564 # for soundcloud, a request to a cross domain is required for cookies
3565 request = urllib2.Request('http://media.soundcloud.com/crossdomain.xml', std_headers)
3568 self._downloader.process_info({
3569 'id': video_id.decode('utf-8'),
3571 'uploader': uploader.decode('utf-8'),
3572 'upload_date': upload_date,
3573 'title': simple_title.decode('utf-8'),
3574 'stitle': simple_title.decode('utf-8'),
3578 'description': description.decode('utf-8')
3580 except UnavailableVideoError:
3581 self._downloader.trouble(u'\nERROR: unable to download video')
3584 class InfoQIE(InfoExtractor):
3585 """Information extractor for infoq.com"""
3587 _VALID_URL = r'^(?:https?://)?(?:www\.)?infoq\.com/[^/]+/[^/]+$'
3590 def report_webpage(self, video_id):
3591 """Report information extraction."""
3592 self._downloader.to_screen(u'[%s] %s: Downloading webpage' % (self.IE_NAME, video_id))
3594 def report_extraction(self, video_id):
3595 """Report information extraction."""
3596 self._downloader.to_screen(u'[%s] %s: Extracting information' % (self.IE_NAME, video_id))
3598 def _real_extract(self, url):
3599 htmlParser = HTMLParser.HTMLParser()
3601 mobj = re.match(self._VALID_URL, url)
3603 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
3606 self.report_webpage(url)
3608 request = urllib2.Request(url)
3610 webpage = urllib2.urlopen(request).read()
3611 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3612 self._downloader.trouble(u'ERROR: unable to download video webpage: %s' % str(err))
3615 self.report_extraction(url)
3619 mobj = re.search(r"jsclassref='([^']*)'", webpage)
3621 self._downloader.trouble(u'ERROR: unable to extract video url')
3623 video_url = 'rtmpe://video.infoq.com/cfx/st/' + urllib2.unquote(mobj.group(1).decode('base64'))
3627 mobj = re.search(r'contentTitle = "(.*?)";', webpage)
3629 self._downloader.trouble(u'ERROR: unable to extract video title')
3631 video_title = mobj.group(1).decode('utf-8')
3633 # Extract description
3634 video_description = u'No description available.'
3635 mobj = re.search(r'<meta name="description" content="(.*)"(?:\s*/)?>', webpage)
3636 if mobj is not None:
3637 video_description = mobj.group(1).decode('utf-8')
3639 video_filename = video_url.split('/')[-1]
3640 video_id, extension = video_filename.split('.')
3642 self._downloader.increment_downloads()
3647 'upload_date': None,
3648 'title': video_title,
3649 'stitle': _simplify_title(video_title),
3651 'format': extension, # Extension is always(?) mp4, but seems to be flv
3653 'description': video_description,
3658 self._downloader.process_info(info)
3659 except UnavailableVideoError, err:
3660 self._downloader.trouble(u'\nERROR: unable to download ' + video_url)
3662 class MixcloudIE(InfoExtractor):
3663 """Information extractor for www.mixcloud.com"""
3664 _VALID_URL = r'^(?:https?://)?(?:www\.)?mixcloud\.com/([\w\d-]+)/([\w\d-]+)'
3665 IE_NAME = u'mixcloud'
3667 def __init__(self, downloader=None):
3668 InfoExtractor.__init__(self, downloader)
3670 def report_download_json(self, file_id):
3671 """Report JSON download."""
3672 self._downloader.to_screen(u'[%s] Downloading json' % self.IE_NAME)
3674 def report_extraction(self, file_id):
3675 """Report information extraction."""
3676 self._downloader.to_screen(u'[%s] %s: Extracting information' % (self.IE_NAME, file_id))
3678 def get_urls(self, jsonData, fmt, bitrate='best'):
3679 """Get urls from 'audio_formats' section in json"""
3682 bitrate_list = jsonData[fmt]
3683 if bitrate is None or bitrate == 'best' or bitrate not in bitrate_list:
3684 bitrate = max(bitrate_list) # select highest
3686 url_list = jsonData[fmt][bitrate]
3687 except TypeError: # we have no bitrate info.
3688 url_list = jsonData[fmt]
3692 def check_urls(self, url_list):
3693 """Returns 1st active url from list"""
3694 for url in url_list:
3696 urllib2.urlopen(url)
3698 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3703 def _print_formats(self, formats):
3704 print 'Available formats:'
3705 for fmt in formats.keys():
3706 for b in formats[fmt]:
3708 ext = formats[fmt][b][0]
3709 print '%s\t%s\t[%s]' % (fmt, b, ext.split('.')[-1])
3710 except TypeError: # we have no bitrate info
3711 ext = formats[fmt][0]
3712 print '%s\t%s\t[%s]' % (fmt, '??', ext.split('.')[-1])
3715 def _real_extract(self, url):
3716 mobj = re.match(self._VALID_URL, url)
3718 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
3720 # extract uploader & filename from url
3721 uploader = mobj.group(1).decode('utf-8')
3722 file_id = uploader + "-" + mobj.group(2).decode('utf-8')
3724 # construct API request
3725 file_url = 'http://www.mixcloud.com/api/1/cloudcast/' + '/'.join(url.split('/')[-3:-1]) + '.json'
3726 # retrieve .json file with links to files
3727 request = urllib2.Request(file_url)
3729 self.report_download_json(file_url)
3730 jsonData = urllib2.urlopen(request).read()
3731 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3732 self._downloader.trouble(u'ERROR: Unable to retrieve file: %s' % str(err))
3736 json_data = json.loads(jsonData)
3737 player_url = json_data['player_swf_url']
3738 formats = dict(json_data['audio_formats'])
3740 req_format = self._downloader.params.get('format', None)
3743 if self._downloader.params.get('listformats', None):
3744 self._print_formats(formats)
3747 if req_format is None or req_format == 'best':
3748 for format_param in formats.keys():
3749 url_list = self.get_urls(formats, format_param)
3751 file_url = self.check_urls(url_list)
3752 if file_url is not None:
3755 if req_format not in formats.keys():
3756 self._downloader.trouble(u'ERROR: format is not available')
3759 url_list = self.get_urls(formats, req_format)
3760 file_url = self.check_urls(url_list)
3761 format_param = req_format
3764 self._downloader.increment_downloads()
3766 # Process file information
3767 self._downloader.process_info({
3768 'id': file_id.decode('utf-8'),
3769 'url': file_url.decode('utf-8'),
3770 'uploader': uploader.decode('utf-8'),
3771 'upload_date': u'NA',
3772 'title': json_data['name'],
3773 'stitle': _simplify_title(json_data['name']),
3774 'ext': file_url.split('.')[-1].decode('utf-8'),
3775 'format': (format_param is None and u'NA' or format_param.decode('utf-8')),
3776 'thumbnail': json_data['thumbnail_url'],
3777 'description': json_data['description'],
3778 'player_url': player_url.decode('utf-8'),
3780 except UnavailableVideoError, err:
3781 self._downloader.trouble(u'ERROR: unable to download file')
3783 class StanfordOpenClassroomIE(InfoExtractor):
3784 """Information extractor for Stanford's Open ClassRoom"""
3786 _VALID_URL = r'^(?:https?://)?openclassroom.stanford.edu(?P<path>/?|(/MainFolder/(?:HomePage|CoursePage|VideoPage)\.php([?]course=(?P<course>[^&]+)(&video=(?P<video>[^&]+))?(&.*)?)?))$'
3787 IE_NAME = u'stanfordoc'
3789 def report_download_webpage(self, objid):
3790 """Report information extraction."""
3791 self._downloader.to_screen(u'[%s] %s: Downloading webpage' % (self.IE_NAME, objid))
3793 def report_extraction(self, video_id):
3794 """Report information extraction."""
3795 self._downloader.to_screen(u'[%s] %s: Extracting information' % (self.IE_NAME, video_id))
3797 def _real_extract(self, url):
3798 mobj = re.match(self._VALID_URL, url)
3800 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
3803 if mobj.group('course') and mobj.group('video'): # A specific video
3804 course = mobj.group('course')
3805 video = mobj.group('video')
3807 'id': _simplify_title(course + '_' + video),
3810 self.report_extraction(info['id'])
3811 baseUrl = 'http://openclassroom.stanford.edu/MainFolder/courses/' + course + '/videos/'
3812 xmlUrl = baseUrl + video + '.xml'
3814 metaXml = urllib2.urlopen(xmlUrl).read()
3815 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3816 self._downloader.trouble(u'ERROR: unable to download video info XML: %s' % unicode(err))
3818 mdoc = xml.etree.ElementTree.fromstring(metaXml)
3820 info['title'] = mdoc.findall('./title')[0].text
3821 info['url'] = baseUrl + mdoc.findall('./videoFile')[0].text
3823 self._downloader.trouble(u'\nERROR: Invalid metadata XML file')
3825 info['stitle'] = _simplify_title(info['title'])
3826 info['ext'] = info['url'].rpartition('.')[2]
3827 info['format'] = info['ext']
3828 self._downloader.increment_downloads()
3830 self._downloader.process_info(info)
3831 except UnavailableVideoError, err:
3832 self._downloader.trouble(u'\nERROR: unable to download video')
3833 elif mobj.group('course'): # A course page
3834 unescapeHTML = HTMLParser.HTMLParser().unescape
3836 course = mobj.group('course')
3838 'id': _simplify_title(course),
3842 self.report_download_webpage(info['id'])
3844 coursepage = urllib2.urlopen(url).read()
3845 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3846 self._downloader.trouble(u'ERROR: unable to download course info page: ' + unicode(err))
3849 m = re.search('<h1>([^<]+)</h1>', coursepage)
3851 info['title'] = unescapeHTML(m.group(1))
3853 info['title'] = info['id']
3854 info['stitle'] = _simplify_title(info['title'])
3856 m = re.search('<description>([^<]+)</description>', coursepage)
3858 info['description'] = unescapeHTML(m.group(1))
3860 links = _orderedSet(re.findall('<a href="(VideoPage.php\?[^"]+)">', coursepage))
3863 'type': 'reference',
3864 'url': 'http://openclassroom.stanford.edu/MainFolder/' + unescapeHTML(vpage),
3868 for entry in info['list']:
3869 assert entry['type'] == 'reference'
3870 self.extract(entry['url'])
3872 unescapeHTML = HTMLParser.HTMLParser().unescape
3875 'id': 'Stanford OpenClassroom',
3879 self.report_download_webpage(info['id'])
3880 rootURL = 'http://openclassroom.stanford.edu/MainFolder/HomePage.php'
3882 rootpage = urllib2.urlopen(rootURL).read()
3883 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3884 self._downloader.trouble(u'ERROR: unable to download course info page: ' + unicode(err))
3887 info['title'] = info['id']
3888 info['stitle'] = _simplify_title(info['title'])
3890 links = _orderedSet(re.findall('<a href="(CoursePage.php\?[^"]+)">', rootpage))
3893 'type': 'reference',
3894 'url': 'http://openclassroom.stanford.edu/MainFolder/' + unescapeHTML(cpage),
3898 for entry in info['list']:
3899 assert entry['type'] == 'reference'
3900 self.extract(entry['url'])
3902 class MTVIE(InfoExtractor):
3903 """Information extractor for MTV.com"""
3905 _VALID_URL = r'^(?P<proto>https?://)?(?:www\.)?mtv\.com/videos/[^/]+/(?P<videoid>[0-9]+)/[^/]+$'
3908 def report_webpage(self, video_id):
3909 """Report information extraction."""
3910 self._downloader.to_screen(u'[%s] %s: Downloading webpage' % (self.IE_NAME, video_id))
3912 def report_extraction(self, video_id):
3913 """Report information extraction."""
3914 self._downloader.to_screen(u'[%s] %s: Extracting information' % (self.IE_NAME, video_id))
3916 def _real_extract(self, url):
3917 mobj = re.match(self._VALID_URL, url)
3919 self._downloader.trouble(u'ERROR: invalid URL: %s' % url)
3921 if not mobj.group('proto'):
3922 url = 'http://' + url
3923 video_id = mobj.group('videoid')
3924 self.report_webpage(video_id)
3926 request = urllib2.Request(url)
3928 webpage = urllib2.urlopen(request).read()
3929 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3930 self._downloader.trouble(u'ERROR: unable to download video webpage: %s' % str(err))
3933 mobj = re.search(r'<meta name="mtv_vt" content="([^"]+)"/>', webpage)
3935 self._downloader.trouble(u'ERROR: unable to extract song name')
3937 song_name = _unescapeHTML(mobj.group(1).decode('iso-8859-1'))
3938 mobj = re.search(r'<meta name="mtv_an" content="([^"]+)"/>', webpage)
3940 self._downloader.trouble(u'ERROR: unable to extract performer')
3942 performer = _unescapeHTML(mobj.group(1).decode('iso-8859-1'))
3943 video_title = performer + ' - ' + song_name
3945 mobj = re.search(r'<meta name="mtvn_uri" content="([^"]+)"/>', webpage)
3947 self._downloader.trouble(u'ERROR: unable to mtvn_uri')
3949 mtvn_uri = mobj.group(1)
3951 mobj = re.search(r'MTVN.Player.defaultPlaylistId = ([0-9]+);', webpage)
3953 self._downloader.trouble(u'ERROR: unable to extract content id')
3955 content_id = mobj.group(1)
3957 videogen_url = 'http://www.mtv.com/player/includes/mediaGen.jhtml?uri=' + mtvn_uri + '&id=' + content_id + '&vid=' + video_id + '&ref=www.mtvn.com&viewUri=' + mtvn_uri
3958 self.report_extraction(video_id)
3959 request = urllib2.Request(videogen_url)
3961 metadataXml = urllib2.urlopen(request).read()
3962 except (urllib2.URLError, httplib.HTTPException, socket.error), err:
3963 self._downloader.trouble(u'ERROR: unable to download video metadata: %s' % str(err))
3966 mdoc = xml.etree.ElementTree.fromstring(metadataXml)
3967 renditions = mdoc.findall('.//rendition')
3969 # For now, always pick the highest quality.
3970 rendition = renditions[-1]
3973 _,_,ext = rendition.attrib['type'].partition('/')
3974 format = ext + '-' + rendition.attrib['width'] + 'x' + rendition.attrib['height'] + '_' + rendition.attrib['bitrate']
3975 video_url = rendition.find('./src').text
3977 self._downloader.trouble('Invalid rendition field.')
3980 self._downloader.increment_downloads()
3984 'uploader': performer,
3985 'title': video_title,
3986 'stitle': _simplify_title(video_title),
3992 self._downloader.process_info(info)
3993 except UnavailableVideoError, err:
3994 self._downloader.trouble(u'\nERROR: unable to download ' + video_id)
3997 class PostProcessor(object):
3998 """Post Processor class.
4000 PostProcessor objects can be added to downloaders with their
4001 add_post_processor() method. When the downloader has finished a
4002 successful download, it will take its internal chain of PostProcessors
4003 and start calling the run() method on each one of them, first with
4004 an initial argument and then with the returned value of the previous
4007 The chain will be stopped if one of them ever returns None or the end
4008 of the chain is reached.
4010 PostProcessor objects follow a "mutual registration" process similar
4011 to InfoExtractor objects.
4016 def __init__(self, downloader=None):
4017 self._downloader = downloader
4019 def set_downloader(self, downloader):
4020 """Sets the downloader for this PP."""
4021 self._downloader = downloader
4023 def run(self, information):
4024 """Run the PostProcessor.
4026 The "information" argument is a dictionary like the ones
4027 composed by InfoExtractors. The only difference is that this
4028 one has an extra field called "filepath" that points to the
4031 When this method returns None, the postprocessing chain is
4032 stopped. However, this method may return an information
4033 dictionary that will be passed to the next postprocessing
4034 object in the chain. It can be the one it received after
4035 changing some fields.
4037 In addition, this method may raise a PostProcessingError
4038 exception that will be taken into account by the downloader
4041 return information # by default, do nothing
4043 class AudioConversionError(BaseException):
4044 def __init__(self, message):
4045 self.message = message
4047 class FFmpegExtractAudioPP(PostProcessor):
4049 def __init__(self, downloader=None, preferredcodec=None, preferredquality=None, keepvideo=False):
4050 PostProcessor.__init__(self, downloader)
4051 if preferredcodec is None:
4052 preferredcodec = 'best'
4053 self._preferredcodec = preferredcodec
4054 self._preferredquality = preferredquality
4055 self._keepvideo = keepvideo
4058 def get_audio_codec(path):
4060 cmd = ['ffprobe', '-show_streams', '--', _encodeFilename(path)]
4061 handle = subprocess.Popen(cmd, stderr=file(os.path.devnull, 'w'), stdout=subprocess.PIPE)
4062 output = handle.communicate()[0]
4063 if handle.wait() != 0:
4065 except (IOError, OSError):
4068 for line in output.split('\n'):
4069 if line.startswith('codec_name='):
4070 audio_codec = line.split('=')[1].strip()
4071 elif line.strip() == 'codec_type=audio' and audio_codec is not None:
4076 def run_ffmpeg(path, out_path, codec, more_opts):
4080 acodec_opts = ['-acodec', codec]
4081 cmd = ['ffmpeg', '-y', '-i', _encodeFilename(path), '-vn'] + acodec_opts + more_opts + ['--', _encodeFilename(out_path)]
4083 p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
4084 stdout,stderr = p.communicate()
4085 except (IOError, OSError):
4086 e = sys.exc_info()[1]
4087 if isinstance(e, OSError) and e.errno == 2:
4088 raise AudioConversionError('ffmpeg not found. Please install ffmpeg.')
4091 if p.returncode != 0:
4092 msg = stderr.strip().split('\n')[-1]
4093 raise AudioConversionError(msg)
4095 def run(self, information):
4096 path = information['filepath']
4098 filecodec = self.get_audio_codec(path)
4099 if filecodec is None:
4100 self._downloader.to_stderr(u'WARNING: unable to obtain file audio codec with ffprobe')
4104 if self._preferredcodec == 'best' or self._preferredcodec == filecodec or (self._preferredcodec == 'm4a' and filecodec == 'aac'):
4105 if self._preferredcodec == 'm4a' and filecodec == 'aac':
4106 # Lossless, but in another container
4108 extension = self._preferredcodec
4109 more_opts = ['-absf', 'aac_adtstoasc']
4110 elif filecodec in ['aac', 'mp3', 'vorbis']:
4111 # Lossless if possible
4113 extension = filecodec
4114 if filecodec == 'aac':
4115 more_opts = ['-f', 'adts']
4116 if filecodec == 'vorbis':
4120 acodec = 'libmp3lame'
4123 if self._preferredquality is not None:
4124 more_opts += ['-ab', self._preferredquality]
4126 # We convert the audio (lossy)
4127 acodec = {'mp3': 'libmp3lame', 'aac': 'aac', 'm4a': 'aac', 'vorbis': 'libvorbis', 'wav': None}[self._preferredcodec]
4128 extension = self._preferredcodec
4130 if self._preferredquality is not None:
4131 more_opts += ['-ab', self._preferredquality]
4132 if self._preferredcodec == 'aac':
4133 more_opts += ['-f', 'adts']
4134 if self._preferredcodec == 'm4a':
4135 more_opts += ['-absf', 'aac_adtstoasc']
4136 if self._preferredcodec == 'vorbis':
4138 if self._preferredcodec == 'wav':
4140 more_opts += ['-f', 'wav']
4142 prefix, sep, ext = path.rpartition(u'.') # not os.path.splitext, since the latter does not work on unicode in all setups
4143 new_path = prefix + sep + extension
4144 self._downloader.to_screen(u'[ffmpeg] Destination: ' + new_path)
4146 self.run_ffmpeg(path, new_path, acodec, more_opts)
4148 etype,e,tb = sys.exc_info()
4149 if isinstance(e, AudioConversionError):
4150 self._downloader.to_stderr(u'ERROR: audio conversion failed: ' + e.message)
4152 self._downloader.to_stderr(u'ERROR: error running ffmpeg')
4155 # Try to update the date time for extracted audio file.
4156 if information.get('filetime') is not None:
4158 os.utime(_encodeFilename(new_path), (time.time(), information['filetime']))
4160 self._downloader.to_stderr(u'WARNING: Cannot update utime of audio file')
4162 if not self._keepvideo:
4164 os.remove(_encodeFilename(path))
4165 except (IOError, OSError):
4166 self._downloader.to_stderr(u'WARNING: Unable to remove downloaded video file')
4169 information['filepath'] = new_path
4173 def updateSelf(downloader, filename):
4174 ''' Update the program file with the latest version from the repository '''
4175 # Note: downloader only used for options
4176 if not os.access(filename, os.W_OK):
4177 sys.exit('ERROR: no write permissions on %s' % filename)
4179 downloader.to_screen(u'Updating to latest version...')
4183 urlh = urllib.urlopen(UPDATE_URL)
4184 newcontent = urlh.read()
4186 vmatch = re.search("__version__ = '([^']+)'", newcontent)
4187 if vmatch is not None and vmatch.group(1) == __version__:
4188 downloader.to_screen(u'youtube-dl is up-to-date (' + __version__ + ')')
4192 except (IOError, OSError), err:
4193 sys.exit('ERROR: unable to download latest version')
4196 outf = open(filename, 'wb')
4198 outf.write(newcontent)
4201 except (IOError, OSError), err:
4202 sys.exit('ERROR: unable to overwrite current version')
4204 downloader.to_screen(u'Updated youtube-dl. Restart youtube-dl to use the new version.')
4207 def _readOptions(filename_bytes):
4209 optionf = open(filename_bytes)
4211 return [] # silently skip if file is not present
4215 res += shlex.split(l, comments=True)
4220 def _format_option_string(option):
4221 ''' ('-o', '--option') -> -o, --format METAVAR'''
4225 if option._short_opts: opts.append(option._short_opts[0])
4226 if option._long_opts: opts.append(option._long_opts[0])
4227 if len(opts) > 1: opts.insert(1, ', ')
4229 if option.takes_value(): opts.append(' %s' % option.metavar)
4231 return "".join(opts)
4233 def _find_term_columns():
4234 columns = os.environ.get('COLUMNS', None)
4239 sp = subprocess.Popen(['stty', 'size'], stdout=subprocess.PIPE, stderr=subprocess.PIPE)
4240 out,err = sp.communicate()
4241 return int(out.split()[1])
4247 max_help_position = 80
4249 # No need to wrap help messages if we're on a wide console
4250 columns = _find_term_columns()
4251 if columns: max_width = columns
4253 fmt = optparse.IndentedHelpFormatter(width=max_width, max_help_position=max_help_position)
4254 fmt.format_option_strings = _format_option_string
4257 'version' : __version__,
4259 'usage' : '%prog [options] url [url...]',
4260 'conflict_handler' : 'resolve',
4263 parser = optparse.OptionParser(**kw)
4266 general = optparse.OptionGroup(parser, 'General Options')
4267 selection = optparse.OptionGroup(parser, 'Video Selection')
4268 authentication = optparse.OptionGroup(parser, 'Authentication Options')
4269 video_format = optparse.OptionGroup(parser, 'Video Format Options')
4270 postproc = optparse.OptionGroup(parser, 'Post-processing Options')
4271 filesystem = optparse.OptionGroup(parser, 'Filesystem Options')
4272 verbosity = optparse.OptionGroup(parser, 'Verbosity / Simulation Options')
4274 general.add_option('-h', '--help',
4275 action='help', help='print this help text and exit')
4276 general.add_option('-v', '--version',
4277 action='version', help='print program version and exit')
4278 general.add_option('-U', '--update',
4279 action='store_true', dest='update_self', help='update this program to latest version')
4280 general.add_option('-i', '--ignore-errors',
4281 action='store_true', dest='ignoreerrors', help='continue on download errors', default=False)
4282 general.add_option('-r', '--rate-limit',
4283 dest='ratelimit', metavar='LIMIT', help='download rate limit (e.g. 50k or 44.6m)')
4284 general.add_option('-R', '--retries',
4285 dest='retries', metavar='RETRIES', help='number of retries (default is 10)', default=10)
4286 general.add_option('--dump-user-agent',
4287 action='store_true', dest='dump_user_agent',
4288 help='display the current browser identification', default=False)
4289 general.add_option('--list-extractors',
4290 action='store_true', dest='list_extractors',
4291 help='List all supported extractors and the URLs they would handle', default=False)
4293 selection.add_option('--playlist-start',
4294 dest='playliststart', metavar='NUMBER', help='playlist video to start at (default is 1)', default=1)
4295 selection.add_option('--playlist-end',
4296 dest='playlistend', metavar='NUMBER', help='playlist video to end at (default is last)', default=-1)
4297 selection.add_option('--match-title', dest='matchtitle', metavar='REGEX',help='download only matching titles (regex or caseless sub-string)')
4298 selection.add_option('--reject-title', dest='rejecttitle', metavar='REGEX',help='skip download for matching titles (regex or caseless sub-string)')
4299 selection.add_option('--max-downloads', metavar='NUMBER', dest='max_downloads', help='Abort after downloading NUMBER files', default=None)
4301 authentication.add_option('-u', '--username',
4302 dest='username', metavar='USERNAME', help='account username')
4303 authentication.add_option('-p', '--password',
4304 dest='password', metavar='PASSWORD', help='account password')
4305 authentication.add_option('-n', '--netrc',
4306 action='store_true', dest='usenetrc', help='use .netrc authentication data', default=False)
4309 video_format.add_option('-f', '--format',
4310 action='store', dest='format', metavar='FORMAT', help='video format code')
4311 video_format.add_option('--all-formats',
4312 action='store_const', dest='format', help='download all available video formats', const='all')
4313 video_format.add_option('--prefer-free-formats',
4314 action='store_true', dest='prefer_free_formats', default=False, help='prefer free video formats unless a specific one is requested')
4315 video_format.add_option('--max-quality',
4316 action='store', dest='format_limit', metavar='FORMAT', help='highest quality format to download')
4317 video_format.add_option('-F', '--list-formats',
4318 action='store_true', dest='listformats', help='list all available formats (currently youtube only)')
4321 verbosity.add_option('-q', '--quiet',
4322 action='store_true', dest='quiet', help='activates quiet mode', default=False)
4323 verbosity.add_option('-s', '--simulate',
4324 action='store_true', dest='simulate', help='do not download the video and do not write anything to disk', default=False)
4325 verbosity.add_option('--skip-download',
4326 action='store_true', dest='skip_download', help='do not download the video', default=False)
4327 verbosity.add_option('-g', '--get-url',
4328 action='store_true', dest='geturl', help='simulate, quiet but print URL', default=False)
4329 verbosity.add_option('-e', '--get-title',
4330 action='store_true', dest='gettitle', help='simulate, quiet but print title', default=False)
4331 verbosity.add_option('--get-thumbnail',
4332 action='store_true', dest='getthumbnail',
4333 help='simulate, quiet but print thumbnail URL', default=False)
4334 verbosity.add_option('--get-description',
4335 action='store_true', dest='getdescription',
4336 help='simulate, quiet but print video description', default=False)
4337 verbosity.add_option('--get-filename',
4338 action='store_true', dest='getfilename',
4339 help='simulate, quiet but print output filename', default=False)
4340 verbosity.add_option('--get-format',
4341 action='store_true', dest='getformat',
4342 help='simulate, quiet but print output format', default=False)
4343 verbosity.add_option('--no-progress',
4344 action='store_true', dest='noprogress', help='do not print progress bar', default=False)
4345 verbosity.add_option('--console-title',
4346 action='store_true', dest='consoletitle',
4347 help='display progress in console titlebar', default=False)
4348 verbosity.add_option('-v', '--verbose',
4349 action='store_true', dest='verbose', help='print various debugging information', default=False)
4352 filesystem.add_option('-t', '--title',
4353 action='store_true', dest='usetitle', help='use title in file name', default=False)
4354 filesystem.add_option('-l', '--literal',
4355 action='store_true', dest='useliteral', help='use literal title in file name', default=False)
4356 filesystem.add_option('-A', '--auto-number',
4357 action='store_true', dest='autonumber',
4358 help='number downloaded files starting from 00000', default=False)
4359 filesystem.add_option('-o', '--output',
4360 dest='outtmpl', metavar='TEMPLATE', help='output filename template. Use %(stitle)s to get the title, %(uploader)s for the uploader name, %(autonumber)s to get an automatically incremented number, %(ext)s for the filename extension, %(upload_date)s for the upload date (YYYYMMDD), and %% for a literal percent. Use - to output to stdout.')
4361 filesystem.add_option('-a', '--batch-file',
4362 dest='batchfile', metavar='FILE', help='file containing URLs to download (\'-\' for stdin)')
4363 filesystem.add_option('-w', '--no-overwrites',
4364 action='store_true', dest='nooverwrites', help='do not overwrite files', default=False)
4365 filesystem.add_option('-c', '--continue',
4366 action='store_true', dest='continue_dl', help='resume partially downloaded files', default=True)
4367 filesystem.add_option('--no-continue',
4368 action='store_false', dest='continue_dl',
4369 help='do not resume partially downloaded files (restart from beginning)')
4370 filesystem.add_option('--cookies',
4371 dest='cookiefile', metavar='FILE', help='file to read cookies from and dump cookie jar in')
4372 filesystem.add_option('--no-part',
4373 action='store_true', dest='nopart', help='do not use .part files', default=False)
4374 filesystem.add_option('--no-mtime',
4375 action='store_false', dest='updatetime',
4376 help='do not use the Last-modified header to set the file modification time', default=True)
4377 filesystem.add_option('--write-description',
4378 action='store_true', dest='writedescription',
4379 help='write video description to a .description file', default=False)
4380 filesystem.add_option('--write-info-json',
4381 action='store_true', dest='writeinfojson',
4382 help='write video metadata to a .info.json file', default=False)
4385 postproc.add_option('--extract-audio', action='store_true', dest='extractaudio', default=False,
4386 help='convert video files to audio-only files (requires ffmpeg and ffprobe)')
4387 postproc.add_option('--audio-format', metavar='FORMAT', dest='audioformat', default='best',
4388 help='"best", "aac", "vorbis", "mp3", "m4a", or "wav"; best by default')
4389 postproc.add_option('--audio-quality', metavar='QUALITY', dest='audioquality', default='128K',
4390 help='ffmpeg audio bitrate specification, 128k by default')
4391 postproc.add_option('-k', '--keep-video', action='store_true', dest='keepvideo', default=False,
4392 help='keeps the video file on disk after the post-processing; the video is erased by default')
4395 parser.add_option_group(general)
4396 parser.add_option_group(selection)
4397 parser.add_option_group(filesystem)
4398 parser.add_option_group(verbosity)
4399 parser.add_option_group(video_format)
4400 parser.add_option_group(authentication)
4401 parser.add_option_group(postproc)
4403 xdg_config_home = os.environ.get('XDG_CONFIG_HOME')
4405 userConf = os.path.join(xdg_config_home, 'youtube-dl.conf')
4407 userConf = os.path.join(os.path.expanduser('~'), '.config', 'youtube-dl.conf')
4408 argv = _readOptions('/etc/youtube-dl.conf') + _readOptions(userConf) + sys.argv[1:]
4409 opts, args = parser.parse_args(argv)
4411 return parser, opts, args
4413 def gen_extractors():
4414 """ Return a list of an instance of every supported extractor.
4415 The order does matter; the first extractor matched is the one handling the URL.
4417 youtube_ie = YoutubeIE()
4418 google_ie = GoogleIE()
4419 yahoo_ie = YahooIE()
4421 YoutubePlaylistIE(youtube_ie),
4422 YoutubeUserIE(youtube_ie),
4423 YoutubeSearchIE(youtube_ie),
4425 MetacafeIE(youtube_ie),
4428 GoogleSearchIE(google_ie),
4431 YahooSearchIE(yahoo_ie),
4444 StanfordOpenClassroomIE(),
4451 parser, opts, args = parseOpts()
4453 # Open appropriate CookieJar
4454 if opts.cookiefile is None:
4455 jar = cookielib.CookieJar()
4458 jar = cookielib.MozillaCookieJar(opts.cookiefile)
4459 if os.path.isfile(opts.cookiefile) and os.access(opts.cookiefile, os.R_OK):
4461 except (IOError, OSError), err:
4462 sys.exit(u'ERROR: unable to open cookie file')
4465 if opts.dump_user_agent:
4466 print std_headers['User-Agent']
4469 # Batch file verification
4471 if opts.batchfile is not None:
4473 if opts.batchfile == '-':
4476 batchfd = open(opts.batchfile, 'r')
4477 batchurls = batchfd.readlines()
4478 batchurls = [x.strip() for x in batchurls]
4479 batchurls = [x for x in batchurls if len(x) > 0 and not re.search(r'^[#/;]', x)]
4481 sys.exit(u'ERROR: batch file could not be read')
4482 all_urls = batchurls + args
4484 # General configuration
4485 cookie_processor = urllib2.HTTPCookieProcessor(jar)
4486 proxy_handler = urllib2.ProxyHandler()
4487 opener = urllib2.build_opener(proxy_handler, cookie_processor, YoutubeDLHandler())
4488 urllib2.install_opener(opener)
4489 socket.setdefaulttimeout(300) # 5 minutes should be enough (famous last words)
4492 print(u'[debug] Proxy map: ' + str(proxy_handler.proxies))
4494 extractors = gen_extractors()
4496 if opts.list_extractors:
4497 for ie in extractors:
4499 matchedUrls = filter(lambda url: ie.suitable(url), all_urls)
4500 all_urls = filter(lambda url: url not in matchedUrls, all_urls)
4501 for mu in matchedUrls:
4505 # Conflicting, missing and erroneous options
4506 if opts.usenetrc and (opts.username is not None or opts.password is not None):
4507 parser.error(u'using .netrc conflicts with giving username/password')
4508 if opts.password is not None and opts.username is None:
4509 parser.error(u'account username missing')
4510 if opts.outtmpl is not None and (opts.useliteral or opts.usetitle or opts.autonumber):
4511 parser.error(u'using output template conflicts with using title, literal title or auto number')
4512 if opts.usetitle and opts.useliteral:
4513 parser.error(u'using title conflicts with using literal title')
4514 if opts.username is not None and opts.password is None:
4515 opts.password = getpass.getpass(u'Type account password and press return:')
4516 if opts.ratelimit is not None:
4517 numeric_limit = FileDownloader.parse_bytes(opts.ratelimit)
4518 if numeric_limit is None:
4519 parser.error(u'invalid rate limit specified')
4520 opts.ratelimit = numeric_limit
4521 if opts.retries is not None:
4523 opts.retries = long(opts.retries)
4524 except (TypeError, ValueError), err:
4525 parser.error(u'invalid retry count specified')
4527 opts.playliststart = int(opts.playliststart)
4528 if opts.playliststart <= 0:
4529 raise ValueError(u'Playlist start must be positive')
4530 except (TypeError, ValueError), err:
4531 parser.error(u'invalid playlist start number specified')
4533 opts.playlistend = int(opts.playlistend)
4534 if opts.playlistend != -1 and (opts.playlistend <= 0 or opts.playlistend < opts.playliststart):
4535 raise ValueError(u'Playlist end must be greater than playlist start')
4536 except (TypeError, ValueError), err:
4537 parser.error(u'invalid playlist end number specified')
4538 if opts.extractaudio:
4539 if opts.audioformat not in ['best', 'aac', 'mp3', 'vorbis', 'm4a', 'wav']:
4540 parser.error(u'invalid audio format specified')
4543 fd = FileDownloader({
4544 'usenetrc': opts.usenetrc,
4545 'username': opts.username,
4546 'password': opts.password,
4547 'quiet': (opts.quiet or opts.geturl or opts.gettitle or opts.getthumbnail or opts.getdescription or opts.getfilename or opts.getformat),
4548 'forceurl': opts.geturl,
4549 'forcetitle': opts.gettitle,
4550 'forcethumbnail': opts.getthumbnail,
4551 'forcedescription': opts.getdescription,
4552 'forcefilename': opts.getfilename,
4553 'forceformat': opts.getformat,
4554 'simulate': opts.simulate,
4555 'skip_download': (opts.skip_download or opts.simulate or opts.geturl or opts.gettitle or opts.getthumbnail or opts.getdescription or opts.getfilename or opts.getformat),
4556 'format': opts.format,
4557 'format_limit': opts.format_limit,
4558 'listformats': opts.listformats,
4559 'outtmpl': ((opts.outtmpl is not None and opts.outtmpl.decode(preferredencoding()))
4560 or (opts.format == '-1' and opts.usetitle and u'%(stitle)s-%(id)s-%(format)s.%(ext)s')
4561 or (opts.format == '-1' and opts.useliteral and u'%(title)s-%(id)s-%(format)s.%(ext)s')
4562 or (opts.format == '-1' and u'%(id)s-%(format)s.%(ext)s')
4563 or (opts.usetitle and opts.autonumber and u'%(autonumber)s-%(stitle)s-%(id)s.%(ext)s')
4564 or (opts.useliteral and opts.autonumber and u'%(autonumber)s-%(title)s-%(id)s.%(ext)s')
4565 or (opts.usetitle and u'%(stitle)s-%(id)s.%(ext)s')
4566 or (opts.useliteral and u'%(title)s-%(id)s.%(ext)s')
4567 or (opts.autonumber and u'%(autonumber)s-%(id)s.%(ext)s')
4568 or u'%(id)s.%(ext)s'),
4569 'ignoreerrors': opts.ignoreerrors,
4570 'ratelimit': opts.ratelimit,
4571 'nooverwrites': opts.nooverwrites,
4572 'retries': opts.retries,
4573 'continuedl': opts.continue_dl,
4574 'noprogress': opts.noprogress,
4575 'playliststart': opts.playliststart,
4576 'playlistend': opts.playlistend,
4577 'logtostderr': opts.outtmpl == '-',
4578 'consoletitle': opts.consoletitle,
4579 'nopart': opts.nopart,
4580 'updatetime': opts.updatetime,
4581 'writedescription': opts.writedescription,
4582 'writeinfojson': opts.writeinfojson,
4583 'matchtitle': opts.matchtitle,
4584 'rejecttitle': opts.rejecttitle,
4585 'max_downloads': opts.max_downloads,
4586 'prefer_free_formats': opts.prefer_free_formats,
4587 'verbose': opts.verbose,
4589 for extractor in extractors:
4590 fd.add_info_extractor(extractor)
4593 if opts.extractaudio:
4594 fd.add_post_processor(FFmpegExtractAudioPP(preferredcodec=opts.audioformat, preferredquality=opts.audioquality, keepvideo=opts.keepvideo))
4597 if opts.update_self:
4598 updateSelf(fd, sys.argv[0])
4601 if len(all_urls) < 1:
4602 if not opts.update_self:
4603 parser.error(u'you must provide at least one URL')
4608 retcode = fd.download(all_urls)
4609 except MaxDownloadsReached:
4610 fd.to_screen(u'--max-download limit reached, aborting.')
4613 # Dump cookie jar if requested
4614 if opts.cookiefile is not None:
4617 except (IOError, OSError), err:
4618 sys.exit(u'ERROR: unable to save cookie jar')
4625 except DownloadError:
4627 except SameFileError:
4628 sys.exit(u'ERROR: fixed output name but more than one file to download')
4629 except KeyboardInterrupt:
4630 sys.exit(u'\nERROR: Interrupted by user')
4632 if __name__ == '__main__':
4635 # vim: set ts=4 sw=4 sts=4 noet ai si filetype=python: