<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
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>
<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
<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>.
<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>