#!/usr/bin/env python
#
-# Copyright (c) 2006 Ricardo Garcia Gonzalez
+# Copyright (c) 2006-2008 Ricardo Garcia Gonzalez
#
# Permission is hereby granted, free of charge, to any person obtaining a
# copy of this software and associated documentation files (the "Software"),
import urllib2
# Global constants
+const_1k = 1024
+const_initial_block_size = 10 * const_1k
+const_epsilon = 0.0001
+const_timeout = 120
+
const_video_url_str = 'http://www.youtube.com/watch?v=%s'
-const_video_url_re = re.compile(r'(?:http://)?(?:www\d*\.)?youtube\.com/(?:v/|(?:watch(?:\.php)?)?\?(?:.+&)?v=)([^&]+).*')
+const_video_url_re = re.compile(r'^((?:http://)?(?:\w+\.)?youtube\.com/(?:v/|(?:watch(?:\.php)?)?\?(?:.+&)?v=))?([0-9A-Za-z_-]+)(?(1)[&/].*)?$')
+const_video_url_best_quality_suffix='&fmt=18'
const_login_url_str = 'http://www.youtube.com/login?next=/watch%%3Fv%%3D%s'
const_login_post_str = 'current_form=loginForm&next=%%2Fwatch%%3Fv%%3D%s&username=%s&password=%s&action_login=Log+In'
const_age_url_str = 'http://www.youtube.com/verify_age?next_url=/watch%%3Fv%%3D%s'
const_age_post_str = 'next_url=%%2Fwatch%%3Fv%%3D%s&action_confirm=Confirm'
-const_video_url_params_re = re.compile(r'player2\.swf\?([^"]+)"', re.M)
-const_video_url_real_str = 'http://www.youtube.com/get_video?%s'
+const_url_t_param_re = re.compile(r', "t": "([^"]+)"')
+const_video_url_real_str = 'http://www.youtube.com/get_video?video_id=%s&t=%s'
const_video_title_re = re.compile(r'<title>YouTube - ([^<]*)</title>', re.M | re.I)
-const_1k = 1024
-const_initial_block_size = 10 * const_1k
# Print error message, followed by standard advice information, and then exit
def error_advice_exit(error_text):
sys.exit('\n')
# Wrapper to create custom requests with typical headers
-def request_create(url, data=None):
+def request_create(url, extra_headers, post_data):
retval = urllib2.Request(url)
- if data is not None:
- retval.add_data(data)
+ if post_data is not None:
+ retval.add_data(post_data)
# Try to mimic Firefox, at least a little bit
- retval.add_header('User-Agent', 'Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1) Gecko/20061010 Firefox/2.0')
+ retval.add_header('User-Agent', 'Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.11) Gecko/20071127 Firefox/2.0.0.11')
retval.add_header('Accept-Charset', 'ISO-8859-1,utf-8;q=0.7,*;q=0.7')
retval.add_header('Accept', 'text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5')
retval.add_header('Accept-Language', 'en-us,en;q=0.5')
+ if extra_headers is not None:
+ for header in extra_headers:
+ retval.add_header(header[0], header[1])
return retval
# Perform a request, process headers and return response
-def perform_request(url, data=None):
- request = request_create(url, data)
+def perform_request(url, headers=None, data=None):
+ request = request_create(url, headers, data)
response = urllib2.urlopen(request)
return response
title = title.lower()
return title
-# Title string minimal transformation
-def title_string_touch(title):
- return title.replace(os.sep, '%')
-
# Generic download step
def download_step(return_data_flag, step_title, step_error, url, post_data=None):
try:
cond_print('%s... ' % step_title)
- data = perform_request(url, post_data).read()
+ data = perform_request(url, data=post_data).read()
cond_print('done.\n')
if return_data_flag:
return data
new_min = max(bytes / 2.0, 1.0)
new_max = max(bytes * 2.0, 1.0)
dif = after - before
- if dif < 0.0001:
+ if dif < const_epsilon:
return int(new_max)
rate = bytes / dif
if rate > new_max:
# Calculate ETA and return it in string format as MM:SS
def calc_eta(start, now, total, current):
- if current == 0:
+ dif = now - start
+ if current == 0 or dif < const_epsilon:
return '--:--'
- rate = float(current) / (now - start)
+ rate = float(current) / dif
eta = long((total - current) / rate)
- eta_mins = eta / 60
- eta_secs = eta % 60
+ (eta_mins, eta_secs) = divmod(eta, 60)
if eta_mins > 99:
return '--:--'
return '%02d:%02d' % (eta_mins, eta_secs)
# Calculate speed and return it in string format
def calc_speed(start, now, bytes):
- if bytes == 0:
+ dif = now - start
+ if bytes == 0 or dif < const_epsilon:
return 'N/A b'
- return format_bytes(float(bytes) / (now - start))
+ return format_bytes(float(bytes) / dif)
+
+
+# Title string minimal transformation
+def title_string_touch(title):
+ return title.replace(os.sep, '%')
# Create the command line options parser and parse command line
cmdl_usage = 'usage: %prog [options] video_url'
-cmdl_version = '2007.03.27'
+cmdl_version = '2008.03.08'
cmdl_parser = optparse.OptionParser(usage=cmdl_usage, version=cmdl_version, conflict_handler='resolve')
cmdl_parser.add_option('-h', '--help', action='help', help='print this help text and exit')
cmdl_parser.add_option('-v', '--version', action='version', help='print program version and exit')
cmdl_parser.add_option('-l', '--literal', action='store_true', dest='use_literal', help='use literal title in file name')
cmdl_parser.add_option('-n', '--netrc', action='store_true', dest='use_netrc', help='use .netrc authentication data')
cmdl_parser.add_option('-g', '--get-url', action='store_true', dest='get_url', help='print final video URL only')
+cmdl_parser.add_option('-2', '--title-too', action='store_true', dest='get_title', help='used with -g, print title too')
+cmdl_parser.add_option('-b', '--best-quality', action='store_true', dest='best_quality', help='try to download the best quality version')
(cmdl_opts, cmdl_args) = cmdl_parser.parse_args()
+# Set socket timeout
+socket.setdefaulttimeout(const_timeout)
+
# Get video URL
if len(cmdl_args) != 1:
cmdl_parser.print_help()
video_url_mo = const_video_url_re.match(video_url_cmdl)
if video_url_mo is None:
sys.exit('Error: URL does not seem to be a youtube video URL. If it is, report a bug.')
-video_url_id = video_url_mo.group(1)
+video_url_id = video_url_mo.group(2)
video_url = const_video_url_str % video_url_id
+if cmdl_opts.best_quality:
+ video_url = '%s%s' % (video_url, const_video_url_best_quality_suffix)
+ video_extension = '.mp4'
+else:
+ video_extension = '.flv'
# Check conflicting options
if cmdl_opts.outfile is not None and (cmdl_opts.simulate or cmdl_opts.get_url):
if cmdl_opts.outfile is not None and (cmdl_opts.use_title or cmdl_opts.use_literal):
sys.exit('Error: using the video title conflicts with using a given file name.')
-if cmdl_opts.use_netrc and cmdl_opts.password is not None:
- sys.exit('Error: using netrc conflicts with giving command line password.')
-
if cmdl_opts.use_title and cmdl_opts.use_literal:
sys.exit('Error: cannot use title and literal title at the same time.')
if cmdl_opts.username is None and cmdl_opts.password is not None:
sys.exit('Error: password give but username is missing.')
+if cmdl_opts.use_netrc and (cmdl_opts.username is not None or cmdl_opts.password is not None):
+ sys.exit('Error: cannot use netrc and username/password at the same time.')
+
+if cmdl_opts.get_url is None and cmdl_opts.get_title is not None:
+ sys.exit('Error: getting title requires getting URL.')
+
# Get account information if any
account_username = None
account_password = None
info = netrc.netrc().authenticators('youtube')
if info is None:
sys.exit('Error: no authenticators for machine youtube.')
- netrc_username = info[0]
- netrc_password = info[2]
+ account_username = info[0]
+ account_password = info[2]
except IOError:
sys.exit('Error: unable to read .netrc file.')
except netrc.NetrcParseError:
sys.exit('Error: unable to parse .netrc file.')
-
-if cmdl_opts.password is not None:
- account_username = cmdl_opts.username
- account_password = cmdl_opts.password
else:
- if cmdl_opts.username is not None and cmdl_opts.use_netrc:
- if cmdl_opts.username != netrc_username:
- sys.exit('Error: conflicting username from .netrc and command line options.')
- account_username = cmdl_opts.username
- account_password = netrc_password
- elif cmdl_opts.username is not None:
- account_username = cmdl_opts.username
- account_password = getpass.getpass('Type YouTube password and press return: ')
- elif cmdl_opts.use_netrc:
- if len(netrc_username) == 0:
- sys.exit('Error: empty username in .netrc file.')
- account_username = netrc_username
- account_password = netrc_password
+ account_username = cmdl_opts.username
+ if account_username is not None:
+ if cmdl_opts.password is None:
+ account_password = getpass.getpass('Type YouTube password and press return: ')
+ else:
+ account_password = cmdl_opts.password
# Get output file name
if cmdl_opts.outfile is None:
- video_filename = '%s.flv' % video_url_id
+ video_filename = '%s%s' % (video_url_id, video_extension)
else:
video_filename = cmdl_opts.outfile
-# Check name
-if not video_filename.lower().endswith('.flv'):
- sys.stderr.write('Warning: video file name does not end in .flv\n')
-
-# Test writable file
-if not (cmdl_opts.simulate or cmdl_opts.get_url):
- try:
- disk_test = open(video_filename, 'wb')
- disk_test.close()
-
- except (OSError, IOError):
- sys.exit('Error: unable to open %s for writing.' % video_filename)
-
# Install cookie and proxy handlers
urllib2.install_opener(urllib2.build_opener(urllib2.ProxyHandler()))
urllib2.install_opener(urllib2.build_opener(urllib2.HTTPCookieProcessor()))
video_webpage = download_step(True, 'Retrieving video webpage', 'unable to retrieve video webpage', video_url)
# Extract video title if needed
-if cmdl_opts.use_title or cmdl_opts.use_literal:
+if cmdl_opts.use_title or cmdl_opts.use_literal or cmdl_opts.get_title:
video_title = extract_step('Extracting video title', 'unable to extract video title', const_video_title_re, video_webpage)
# Extract needed video URL parameters
-video_url_params = extract_step('Extracting video URL parameters', 'unable to extract URL parameters', const_video_url_params_re, video_webpage)
-video_url_real = const_video_url_real_str % video_url_params
+video_url_t_param = extract_step('Extracting URL "t" parameter', 'unable to extract URL "t" parameter', const_url_t_param_re, video_webpage)
+video_url_real = const_video_url_real_str % (video_url_id, video_url_t_param)
+if cmdl_opts.best_quality:
+ video_url_real = '%s%s' % (video_url_real, const_video_url_best_quality_suffix)
+
+# Rebuild filename if needed
+if cmdl_opts.use_title or cmdl_opts.use_literal:
+ if cmdl_opts.use_title:
+ prefix = title_string_norm(video_title)
+ else:
+ prefix = title_string_touch(video_title)
+ video_filename = '%s-%s%s' % (prefix, video_url_id, video_extension)
+
+# Check name
+if not video_filename.lower().endswith(video_extension):
+ sys.stderr.write('Warning: video file name does not end in %s\n' % video_extension)
# Retrieve video data
try:
+ cond_print('Requesting video file... ')
video_data = perform_request(video_url_real)
+ cond_print('done.\n')
cond_print('Video data found at %s\n' % video_data.geturl())
+ if cmdl_opts.get_title:
+ print video_title
+
if cmdl_opts.get_url:
print video_data.geturl()
if cmdl_opts.simulate or cmdl_opts.get_url:
sys.exit()
- video_file = open(video_filename, 'wb')
+ try:
+ video_file = open(video_filename, 'wb')
+ except (IOError, OSError):
+ sys.exit('Error: unable to open "%s" for writing.' % video_filename)
try:
video_len = long(video_data.info()['Content-length'])
video_len_str = format_bytes(video_len)
block_size = new_block_size(before, after, dl_bytes)
if video_len is not None and byte_counter != video_len:
- error_advice_exit('server did not send the expected ammount of data')
+ error_advice_exit('server did not send the expected amount of data')
video_file.close()
cond_print('done.\n')
except KeyboardInterrupt:
sys.exit('\n')
-# Rename video file if needed
-if cmdl_opts.use_title or cmdl_opts.use_literal:
- try:
- if cmdl_opts.use_title:
- prefix = title_string_norm(video_title)
- else:
- prefix = title_string_touch(video_title)
- final_filename = '%s-%s.flv' % (prefix, video_url_id)
- os.rename(video_filename, final_filename)
- cond_print('Video file renamed to %s\n' % final_filename)
-
- except OSError:
- sys.stderr.write('Warning: unable to rename file.\n')
-
- except KeyboardInterrupt:
- sys.exit('\n')
-
# Finish
sys.exit()