X-Git-Url: http://git.cielonegro.org/gitweb.cgi?a=blobdiff_plain;f=index.html.in;h=c503df7df3f18f236caa928b77fb99a5ad7950a1;hb=5121ef207112040fdf58e889393071aeb51cf4f2;hp=999c8e9bcd2b8d2b3b4e7d86f7797f541772be18;hpb=3e1cabc338803c398a0c6f02bd0310819ba5f91c;p=youtube-dl.git
diff --git a/index.html.in b/index.html.in
index 999c8e9bc..c503df7df 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,9 @@ 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 +120,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
@@ -133,8 +131,29 @@ literal title in the filename with the -l or --literal option.
by using the -f or --format option. This makes it possible to download high
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.
+- The -b or --best-quality option is an alias for -f 18.
+
+- The -m or --mobile-version option is an alias for -f 17.
+
+- 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.
+
+- The -a or --batch-file option lets you specify a file to read URLs from.
+The file must contain one URL per line.
+
+- The program can be told not to overwrite existing files using the -w or
+--no-overwrites option.
+
+- For YouTube, you can also use the URL of a playlist, and it will download
+all the videos in that playlist.
+
+- For YouTube, you can also use the special word ytsearch to
+download search results. With ytsearch it will download the
+first search result. With ytsearchN, where N is a number, it
+will download the first N results. With ytsearchall it will
+download every result for that search. In most systems you'll need to
+use quotes for multiple words. Example: youtube-dl "ytsearch3:cute
+kittens".
- youtube-dl honors the http_proxy environment variable
if you want to use a proxy. Set it to something like
@@ -168,6 +187,43 @@ 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, restricted to alphanumeric characters and dashes.
+- ext: The sequence will be replaced by the appropriate
+extension (like flv or mp4).
+
+
+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.
+- Danny Colligan: YouTube search InfoExtractor, ideas and patches.
+- 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