From f807dc157e1215c3dbaf82333f6e86a8f98ea76b Mon Sep 17 00:00:00 2001
From: Ricardo Garcia
Date: Fri, 25 Jul 2008 23:42:02 +0200
Subject: [PATCH] Update webpage to reflect changes
---
index.html.in | 65 ++++++++++++++++++++++++++++++++++++++++-----------
1 file changed, 52 insertions(+), 13 deletions(-)
diff --git a/index.html.in b/index.html.in
index 999c8e9bcd..40f8fd3260 100644
--- a/index.html.in
+++ b/index.html.in
@@ -31,7 +31,7 @@
li {
margin-bottom: 0.5ex;
}
- #copyright {
+ .smallnote {
font-size: x-small;
text-align: center;
}
@@ -40,15 +40,16 @@
youtube-dl: Download videos from YouTube.com
+(and more...)
+
What is it?
youtube-dl is a small command-line program to download videos
from YouTube.com. It requires the Python
interpreter, version 2.4 or later, and it's not platform specific.
It should work in your Unix box, in Windows or in Mac OS X. The latest version
-is @PROGRAM_VERSION@. It's licensed under the MIT License, which
-means you can modify it, redistribute it or use it however you like
-complying with a few simple conditions.
+is @PROGRAM_VERSION@. It's released to the public domain,
+which means you can modify it, redistribute it or use it however you like.
I'll try to keep it updated if YouTube.com changes the way you access
their videos. After all, it's a simple and short program. However, I can't
@@ -62,11 +63,6 @@ at freshmeat.net.
Thanks for all the feedback received so far. I'm glad people find my
program useful.
-Related projects:
-metacafe-dl
-pornotube-dl
-
-
Usage instructions
In Windows, once you have installed the Python interpreter, save the
@@ -99,7 +95,8 @@ is too old.
- You can change the file name of the video using the -o option, like in
-youtube-dl -o vid.flv "http://www.youtube.com/watch?v=foobar".
+youtube-dl -o vid.flv "http://www.youtube.com/watch?v=foobar".
+Read the Output template section for more details on this.
- Some videos require an account to be downloaded, mostly because they're
flagged as mature content. You can pass the program a username and password
@@ -122,8 +119,8 @@ in order to pipe it to another program without interferences.
- The program can be told to simply print the final video URL to standard
output using the -g or --get-url option.
-- Combined with the above option, the -2 or --title-too option tells the
-program to print the video title too.
+- In a similar line, the -e or --get-title option tells the program to print
+the video title.
- The default filename is video_id.flv. But you can also use the
video title in the filename with the -t or --title option, or preserve the
@@ -136,6 +133,12 @@ quality versions of the videos when available.
- youtube-dl can attempt to download the best quality version of
a video by using the -b or --best-quality option.
+- youtube-dl can attempt to download the mobile quality version of
+a video by using the -m or --mobile-version option.
+
+- Normally, the program will stop on the first error, but you can tell it
+to attempt to download every video with the -i or --ignore-errors option.
+
- youtube-dl honors the http_proxy environment variable
if you want to use a proxy. Set it to something like
http://proxy.example.com:8080, and do not leave the http://
@@ -168,6 +171,42 @@ are using.
- SHA256: @PROGRAM_SHA256SUM@
-Copyright © 2006-2007 Ricardo Garcia Gonzalez
+Output template
+
+The -o option allows users to indicate a template for the output file names.
+The basic usage is not to set any template arguments when downloading a single
+file, like in youtube-dl -o funny_video.flv 'http://some/video'.
+However, it may contain special sequences that will be replaced when
+downloading each video. The special sequences have the format
+%(NAME)s. To clarify, that's a percent symbol followed by a
+name in parenthesis, followed by a lowercase S. Allowed names are:
+
+
+- id: The sequence will be replaced by the video identifier.
+- url: The sequence will be replaced by the video URL.
+- uploader: The sequence will be replaced by the nickname of the
+person who uploaded the video.
+- title: The sequence will be replaced by the literal video
+title.
+- stitle: The sequence will be replaced by a simplified video
+title.
+- ext: The sequence will be replaced by the appropriate
+extension.
+
+
+As you may have guessed, the default template is %(id)s.%(ext)s.
+When some command line options are used, it's replaced by other templates like
+%(title)s-%(id)s.%(ext)s. You can specify your own.
+
+Authors
+
+
+- Ricardo Garcia Gonzalez: program core, YouTube.com InfoExtractor,
+metacafe.com InfoExtractor and YouTube playlist InfoExtractor.
+- Many other people contributing patches, code, ideas and kind messages. Too
+many to be listed here. You know who you are. Thank you very much.
+
+
+Copyright © 2006-2007 Ricardo Garcia Gonzalez