]> gitweb @ CieloNegro.org - youtube-dl.git/blobdiff - index.html.in
Put Danny Colligan as an author in the script itself
[youtube-dl.git] / index.html.in
index 40f8fd3260252563104d9d449bafc1ec21b50dc8..ddcebcdf55bbbc8e643dc789b39581ce27715686 100644 (file)
@@ -96,7 +96,8 @@ is too old.</p>
 
 <li>You can change the file name of the video using the -o option, like in
 <em>youtube-dl -o vid.flv "http://www.youtube.com/watch?v=foobar"</em>.
-Read the <em>Output template</em> section for more details on this.</li>
+Read the <a href="#otpl">Output template</a> section for more details on
+this.</li>
 
 <li>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
@@ -130,15 +131,27 @@ literal title in the filename with the -l or --literal option.</li>
 by using the -f or --format option. This makes it possible to download high
 quality versions of the videos when available.</li>
 
-<li><em>youtube-dl</em> can attempt to download the best quality version of
-a video by using the -b or --best-quality option.</li>
+<li>The -b or --best-quality option is an alias for -f 18.</li>
 
-<li><em>youtube-dl</em> can attempt to download the mobile quality version of
-a video by using the -m or --mobile-version option.</li>
+<li>The -m or --mobile-version option is an alias for -f 17.</li>
 
 <li>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.</li>
 
+<li>The -a or --batch-file option lets you specify a file to read URLs from.
+The file must contain one URL per line.</li>
+
+<li>For YouTube, you can also use the URL of a playlist, and it will download
+all the videos in that playlist.</li>
+
+<li>For YouTube, you can also use the special word <em>ytsearch</em> to
+download search results. With <em>ytsearch</em> it will download the
+first search result. With <em>ytsearchN</em>, where N is a number, it
+will download the first N results. With <em>ytsearchall</em> it will
+download every result for that search. In most systems you'll need to
+use quotes for multiple words. Example: <em>youtube-dl "ytsearch3:cute
+kittens"</em>.
+
 <li><em>youtube-dl</em> honors the <em>http_proxy</em> environment variable
 if you want to use a proxy. Set it to something like
 <em>http://proxy.example.com:8080</em>, and do not leave the <em>http://</em>
@@ -171,7 +184,7 @@ are using.</p>
         <li><strong>SHA256</strong>: @PROGRAM_SHA256SUM@</li>
 </ul>
 
-<h2>Output template</h2>
+<h2 id="otpl">Output template</h2>
 
 <p>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
@@ -189,9 +202,9 @@ person who uploaded the video.</li>
 <li><em>title</em>: The sequence will be replaced by the literal video
 title.</li>
 <li><em>stitle</em>: The sequence will be replaced by a simplified video
-title.</li>
+title, restricted to alphanumeric characters and dashes.</li>
 <li><em>ext</em>: The sequence will be replaced by the appropriate
-extension.</li>
+extension (like <em>flv</em> or <em>mp4</em>).</li>
 </ul>
 
 <p>As you may have guessed, the default template is <em>%(id)s.%(ext)s</em>.
@@ -203,6 +216,7 @@ When some command line options are used, it's replaced by other templates like
 <ul>
 <li>Ricardo Garcia Gonzalez: program core, YouTube.com InfoExtractor,
 metacafe.com InfoExtractor and YouTube playlist InfoExtractor.</li>
+<li>Danny Colligan: YouTube search InfoExtractor, ideas and patches.</li>
 <li>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.</li>
 </ul>