doc: Remove generated docs from the repository.

Commit diffs end up too long and annoying for simple changes. Building after pulling will now be required.
This commit is contained in:
Bradley Sepos 2016-03-25 21:40:10 -04:00
parent 230685e5e6
commit f404352d67
31 changed files with 7 additions and 1417 deletions

4
.gitignore vendored
View File

@ -1,2 +1,6 @@
# Prevent overwriting user config
config.yaml
# Ignore generated documents but keep the docs directory
docs/*
!docs/.gitkeep

View File

@ -141,8 +141,9 @@ TEMPLATE_Document="${TEMPLATE_DIR}/document.html"
TEMPLATE_Header="${TEMPLATE_DIR}/header.html"
TEMPLATE_Footer="${TEMPLATE_DIR}/footer.html"
# clean
rm -rf "${DOCS_DIR}"/*
# clean docs dir
mkdir -p "${DOCS_DIR}"
$(GLOBIGNORE='*.gitkeep'; rm -rf "${DOCS_DIR}"/*)
# build
cp -R "${TEMPLATE_DIR}"/fonts "${TEMPLATE_DIR}"/style "${SOURCE_DIR}"/* "${DOCS_DIR}"/

0
docs/.gitkeep Normal file
View File

View File

@ -1,38 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Checking for updates</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Checking for updates</div>
</header>
<h1>Checking for updates</h1>
<p>HandBrake can let you know when a newer version is available, and even automatically download and install available updates.</p>
<p>Before updating, make sure there are pending encodes in the <code>Queue</code> and make note of any custom presets you have created, as they may not be compatible with the newer version.</p>
<p>From the main menu, navigate to <code>HandBrake</code> and select <code>Check for Updates...</code>.</p>
<p><img src="../images/check-for-updates-menu-item.png" alt="Check for Updates menu item" /></p>
<p>If an update is available, you will be given the opportunity to install it right away. To enable automatic updates, select the appropriate checkbox labeled <code>Automatically download and install updates in the future</code>.</p>
<p><img src="../images/check-for-updates.png" alt="Check for Updates dialog" /></p>
<h2>Next steps</h2>
<p>Continue to <a href="../workflow/open-video.html">Opening a video</a>.</p>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,76 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Downloading and installing HandBrake</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Downloading and installing HandBrake</div>
</header>
<h1>Downloading and installing HandBrake</h1>
<p>HandBrake is available for Linux, OS X, and Windows, at the <a href="https://handbrake.fr/">official HandBrake website</a>.</p>
<h2>Downloading</h2>
<p>To download HandBrake to your computer, click the download button on the HandBrake website&rsquo;s <a href="https://handbrake.fr/">Home page</a>. You can also choose a version for a specific operating system from the <a href="https://handbrake.fr/downloads.php">Downloads page</a>.</p>
<p>Experienced users may wish to try HandBrake&rsquo;s <a href="https://handbrake.fr/nightly.php">nightly builds</a><sup id="fnref:1"><a href="#fn:1" rel="footnote">1</a></sup>.</p>
<h2>Installing</h2>
<p>Once you&rsquo;ve downloaded HandBrake for OS X, open the DMG file in your Downloads folder (your web browser, e.g. Safari/Chrome/Firefox, may do this for you automatically). Drag the HandBrake application to your Applications folder.</p>
<p><img src="../images/install-osx.png" alt="Installing HandBrake on OS X" /></p>
<p>HandBrake is now installed. You may eject the disk image and move it to the Trash.</p>
<h2>About OS X Gatekeeper</h2>
<p>The first time you attempt to launch HandBrake, OS X may present this warning to you:</p>
<p><img src="../images/gatekeeper-warning.png" alt="Gatekeeper warning" /></p>
<p>HandBrake is not &ldquo;signed&rdquo; by Apple. This message doesn&rsquo;t mean anything is wrong; rather, it indicates that HandBrake is not part of Apple&rsquo;s paid program to validate OS X applications. Click OK to dismiss the dialog.</p>
<p>To instruct Gatekeeper to allow HandBrake to run, press the Control key, then click the HandBrake icon, and then select Open from the shortcut menu. Gatekeeper will ask whether you are certain you wish to open HandBrake, and you may confirm that you are by clicking Open<sup id="fnref:2"><a href="#fn:2" rel="footnote">2</a></sup>.</p>
<p><img src="../images/gatekeeper-bypass.png" alt="Gatekeeper bypass" /></p>
<p><img src="../images/gatekeeper-confirm.png" alt="Gatekeeper confirmation" /></p>
<p>Now HandBrake is up and running. You should not have to repeat the Gatekeeper process until you update HandBrake.</p>
<h2>Launching HandBrake</h2>
<p>You may launch HandBrake by quickly clicking twice (double-clicking) on the cocktail &amp; pineapple icon.</p>
<p><img src="../images/icon.png" alt="HandBrake icon" /></p>
<p>Read about the icon and more at HandBrake lore (TODO: link).</p>
<h2>Next steps</h2>
<p>Continue to <a href="check-for-updates.html">Checking for updates</a>.</p>
<div class="footnotes">
<hr/>
<ol>
<li id="fn:1">
<p>Nightly builds are based on HandBrake&rsquo;s latest development code, including new and experimental features that may be unstable or significantly different than the latest release version. Although everyone is welcome to try them, nightly builds are best suited for experienced users and developers.<a href="#fnref:1" rev="footnote">&#8617;</a></p></li>
<li id="fn:2">
<p>These instructions are taken directly from Apple&rsquo;s OS X Gatekeeper support documents. You can learn more about Gatekeeper <a href="https://support.apple.com/kb/PH21769?locale=en_US">here</a> and <a href="https://support.apple.com/en-us/HT202491">here</a>.<a href="#fnref:2" rev="footnote">&#8617;</a></p></li>
</ol>
</div>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,52 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Where to get HandBrake</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Where to get HandBrake</div>
</header>
<h1>Where to get HandBrake</h1>
<h2>HandBrake releases and nightly builds</h2>
<p>Official <a href="https://handbrake.fr/downloads.php">HandBrake releases</a> and <a href="https://handbrake.fr/nightly.php">nightly builds</a> are available for Linux, OS X, and Windows.</p>
<p>Ubuntu Linux users should install the <a href="https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases">official release PPA</a> or the <a href="https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-git-snapshots">official snapshots PPA</a>. The PPA may work, but is not tested, on other Debian-compatible distributions. Users of other BSD- and *nix-like distributions may compile from source.</p>
<p>HandBrake source code is available at the official <a href="https://github.com/HandBrake/HandBrake">HandBrake repository on GitHub</a>.</p>
<p>Other versions obtained via third parties are not supported.</p>
<h2>Warning about broken third-party builds</h2>
<p>Certain Linux distributions and package repositories create their own versions of HandBrake. These modified versions are often crippled (features removed for political reasons) and broken (bugs due to modifications), and should be avoided.</p>
<p>Broken third-party packages/builds include but are not limited to:</p>
<ul>
<li>Ubuntu Universe: <code>handbrake</code>, <code>handbrake-cli</code>, <code>handbrake-dbg</code></li>
<li>Debian Multimedia: <code>handbrake</code>, <code>handbrake-cli</code>, <code>handbrake-gtk</code></li>
</ul>
<p>Please <strong>do not</strong> request support for these or any other unofficial versions. The HandBrake Team has zero control over them and therefore cannot provide meaningful support.</p>
<p>Linux users should install the <a href="https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases">official release PPA</a>, install the <a href="https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases">official snapshots PPA</a>, or compile from the <a href="https://github.com/HandBrake/HandBrake">official source code</a>.</p>
<h2>Next steps</h2>
<p>Continue to <a href="download-and-install.html">Downloading and installing HandBrake</a>.</p>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,50 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Community support</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Community support</div>
</header>
<h1>Community support</h1>
<p>If you run into problems using HandBrake, first take a look at this documentation&rsquo;s <a href="../table-of-contents.html">Table of contents</a>—the information you need may be just a click away.</p>
<p>Didn&rsquo;t find it? Keep reading.</p>
<h2>Activity Logs</h2>
<p>Activity logs explain a lot and are <strong>required</strong> for all support requests. More information about [Activity Logs] (TODO: link).</p>
<h2>Community Forums</h2>
<p>The <a href="https://forum.handbrake.fr/">HandBrake Community Forums</a> are available 24/7. Whether you have a support request or simply want to connect with other HandBrake users, this is the place. Registration is free. Please read and abide by our <a href="https://forum.handbrake.fr/viewtopic.php?f=6&amp;t=6702">Community Rules</a>.</p>
<p>If you need help or have encountered an error while using HandBrake, first take a look at our <a href="https://forum.handbrake.fr/viewforum.php?f=16">Support Forums</a> or <a href="https://forum.handbrake.fr/search.php">Search</a> using some words related to your questions. Doing this saves everyone from repeating answers to common questions. If you still haven&rsquo;t found an answer, feel free to start a new support request. Make sure to read <a href="https://forum.handbrake.fr/viewtopic.php?f=6&amp;t=31236">How To Request Support</a> before posting.</p>
<p>Developers and keen users may report reproducible bugs on the <a href="https://forum.handbrake.fr/viewforum.php?f=12">Bugs Forum</a>. Please read the <a href="https://forum.handbrake.fr/viewtopic.php?f=12&amp;t=18906">bug reporting readme</a> before posting.</p>
<h2>IRC discussion channels</h2>
<p>Real-time chat is available on our <a href="http://freenode.net/irc_servers.shtml">Freenode</a> IRC channel, <a href="irc://irc.freenode.net/#handbrake">#handbrake</a>. Make sure to provide an [Activity Log] (TODO: link) when requesting support.</p>
<p>Note that HandBrake&rsquo;s developers are located in various timezones around the world, and have lives and jobs outside of HandBrake and its community. It&rsquo;s possible that nobody will be able to answer your support request on IRC right away. Be patient for awhile or ask on the forums.</p>
<p>Developer discussion happens on <a href="irc://irc.freenode.net/#handbrake-dev">#handbrake-dev</a>, which is moderated for the team&rsquo;s sanity. If you&rsquo;ve a developer and would like to speak on <a href="irc://irc.freenode.net/#handbrake-dev">#handbrake-dev</a>, you may ask politely on <a href="irc://irc.freenode.net/#handbrake">#handbrake</a>.</p>
<h2>Next steps</h2>
<p>Continue to (TODO: link).</p>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,72 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - About HandBrake</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > About HandBrake</div>
</header>
<h1>About HandBrake</h1>
<h2>What HandBrake is</h2>
<p>HandBrake is an open-source video transcoder available for Linux, OS X, and Windows, licensed under the GNU General Public License (GPL) Version 2 (TODO: license link).</p>
<p>Everyone can use HandBrake to make videos <em>for free</em>.</p>
<h2>What HandBrake does</h2>
<p>HandBrake takes videos you already have and makes new ones that work on your mobile phone, tablet, TV media player, game console, computer, or web browser—nearly anything that supports modern video formats.</p>
<p>HandBrake works with most common video files and formats, including ones created by consumer and professional video cameras, mobile devices such as phones and tablets, game and computer screen recordings, and DVD and Blu-ray discs. HandBrake leverages tools such as Libav, x264, and x265 to create new MP4 or MKV video files from these <code>Sources</code>.</p>
<p>HandBrake <strong>does</strong>:</p>
<ul>
<li>Convert nearly any video to MP4 or MKV</li>
<li>Crop and resize video</li>
<li>Restore old and low-quality video</li>
<li>Remove combing artifacts caused by interlacing and telecine</li>
<li>Pass-through audio without conversion for certain audio types</li>
<li>Downmix discrete surround sound to matrixed surround or stereo</li>
<li>Adjust audio volume levels, and dynamic range for certain audio types</li>
<li>Preserve existing subtitles, and add or remove soft subtitles (subtitles stored as text)</li>
</ul>
<p>HandBrake can also make videos that are smaller—taking up less storage space on your device—than the originals.</p>
<h2>What HandBrake does not do</h2>
<p>HandBrake <strong>does not</strong>:</p>
<ul>
<li>Combine multiple video clips into one</li>
<li>Pass-through video without conversion (video is <em>always</em> converted)</li>
<li>Create Blu-ray, AVCHD, or DVD discs</li>
<li>Make cocktails (yet)</li>
</ul>
<p>HandBrake also does not defeat or circumvent <a href="https://en.wikipedia.org/wiki/Copy_protection">copy protection</a> of any kind. It does not work with video files employing <a href="https://en.wikipedia.org/wiki/Digital_rights_management">Digital Rights Management</a> (DRM). This includes but is not limited to, copy protected content from iTunes, Amazon Video, Netflix, or other online providers, and many commercial DVD and Blu-ray discs.</p>
<p>Applications such as <a href="https://en.wikipedia.org/wiki/AnyDVD">AnyDVD HD</a> for Windows and MakeMKV (TODO: link) for Linux, OS X, and Windows create DRM-free copies of DVD and Blu-ray discs that HandBrake can open; however, the HandBrake Team has no affiliation with these third parties and as such can neither recommend nor support these applications or their usage.</p>
<p>Do not use HandBrake to copy materials you do not own or have the right to copy. If you are uncertain about your right to copy any material, you should contact your legal advisor.</p>
<h2>Next steps</h2>
<p>Continue to <a href="../get-handbrake/where-to-get-handbrake.html">Where to get HandBrake</a>.</p>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,90 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Quick start</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Quick start</div>
</header>
<h1>Quick start</h1>
<p>HandBrake takes videos you already have and makes new ones that work on your mobile phone, tablet, TV media player, game console, computer, or web browser—nearly anything that supports modern video formats.</p>
<p>This quick start guide assumes you have already downloaded and installed HandBrake. If you do not already have HandBrake, please see <a href="../get-handbrake/download-and-install.html">Downloading and installing HandBrake</a>.</p>
<p>Let&rsquo;s get started.</p>
<h2>Launch HandBrake</h2>
<p>Typically, you can launch HandBrake by quickly clicking twice (double-clicking) on the cocktail &amp; pineapple icon.</p>
<p><img src="../images/icon.png" alt="HandBrake icon" /></p>
<p>Read about the icon and more at HandBrake lore (TODO: link).</p>
<h2>Open your original video</h2>
<p>HandBrake calls the video you already have the <code>Source</code>.</p>
<p>Drag your <code>Source</code> video onto HandBrake to open it. You may also select the <code>Open Source</code> button on the toolbar and browse for it.</p>
<p><img src="../images/open-source-dialog.png" alt="Open Source dialog" /></p>
<p><img src="../images/drag-and-drop-source.png" alt="Opening a video source via drag and drop" /></p>
<h2>Select a title</h2>
<p>Some types of <code>Sources</code> contain more than one video clip, or a collection of <code>Titles</code>. Use HandBrake&rsquo;s <code>Title</code> control to select which video clip you want to use. Many <code>Sources</code> have only one <code>Title</code>.</p>
<p><img src="../images/titles.png" alt="Selecting a title" /></p>
<h2>Select a preset</h2>
<p>HandBrake provides a number of settings <code>Presets</code> to make your new video work well with your playback devices and software. For instance, if you have a third generation Apple TV, you may wish to select the <code>AppleTV 3</code> preset. The default <code>Normal</code> preset is fast and relatively compatible.</p>
<p><img src="../images/preset-selection.png" alt="Selecting a preset" /></p>
<p><code>Presets</code> can affect compatibility (whether your video will work with your devices and software) and encoding time. Learn more: <a href="../workflow/select-preset.html">Selecting a preset</a></p>
<h2>Select a destination</h2>
<p><code>Destination</code> is where your new video will go. You can select the <code>Browse...</code> button to choose a new location and name, or type it directly in the box.</p>
<p><img src="../images/destination.png" alt="Selecting a destination" /></p>
<p>Please take special care to <em>note your destination</em>. Otherwise, you won&rsquo;t be able to find your new video. You can move it later if you desire.</p>
<h2>Start the encode</h2>
<p>Select the <code>Start</code> button on the toolbar to make your new video.</p>
<p><img src="../images/toolbar.png" alt="Main window toolbar" /></p>
<p><img src="../images/start-button.png" alt="Starting an encode" /></p>
<p>HandBrake will report its progress while it&rsquo;s working and alert you when it&rsquo;s finished. Then you will have a new video file at the <code>Destination</code> you specified.</p>
<p><img src="../images/encode-complete.png" alt="Encoding complete alert" /></p>
<p><img src="../images/destination-file-icon.png" alt="Destination video file icon" /></p>
<p>Congratulations! You just encoded your first video using HandBrake. It&rsquo;s now ready to watch on your devices.</p>
<h2>Next steps</h2>
<p>If you didn&rsquo;t get a video file as expected, encountered an error, or had some other trouble, you can continue reading to learn more about how HandBrake works or jump right to <a href="../help/index.html">Getting help</a>.</p>
<p>Continue to <a href="about.html">About HandBrake</a>.</p>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,297 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Table of contents</title>
<link rel="stylesheet" type="text/css" href="../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Table of contents</div>
</header>
<h1>Table of contents</h1>
<h2>Introduction</h2>
<!-- TODO: link to contributing guide -->
<ul>
<li><a href="introduction/quick-start.html">Quick start</a> - Learn how to make your first video in minutes</li>
<li><a href="introduction/about.html">About HandBrake</a> - What HandBrake is, does, and does not do</li>
</ul>
<h2>Getting HandBrake</h2>
<ul>
<li><a href="get-handbrake/where-to-get-handbrake.html">Where to get HandBrake</a> - The officially supported version</li>
<li><a href="get-handbrake/download-and-install.html">Downloading and installing HandBrake</a> - How to get HandBrake onto your computer</li>
<li><a href="get-handbrake/check-for-updates.html">Checking for updates</a> - Staying up to date with the latest version is easy</li>
</ul>
<h2>Making videos</h2>
<ul>
<li><a href="workflow/open-video.html">Opening a video</a> - How to get your videos into HandBrake</li>
<li><a href="workflow/select-preset.html">Selecting a preset</a> - Tailored settings for instant compatibility with many devices</li>
<li><a href="workflow/adjust-quality.html">Adjusting quality</a> - Easily increase visual quality or reduce file size
<!-- TODO: To clean up a poor-looking source video, see restoration --></li>
<li><a href="workflow/preview-settings.html">Previewing your settings</a> - See what your new video will look like, without waiting
<!-- TODO: To clean up a poor-looking source video, see restoration --></li>
<li><a href="workflow/start-encoding.html">Starting encoding</a> - Start encoding your new video with one click</li>
</ul>
<h2>Advanced features</h2>
<ul>
<li>Multiple jobs using the queue</li>
<li>Custom presets
<ul>
<li>Modifying audio and subtitle defaults</li>
</ul>
</li>
<li>Resizing video
<ul>
<li>Downscaling only</li>
</ul>
</li>
<li>Preserving surround sound
<ul>
<li>Formats: ac3, dts, etc.</li>
<li>Passthru: devices and compatiblity</li>
<li>Dynamic range control</li>
<li>Downmixing</li>
</ul>
</li>
<li>Adding subtitles
<ul>
<li>Language or forced</li>
<li>Burned-in or text (source dependent)</li>
<li>Adding external subtitles</li>
</ul>
</li>
<li>Chapter markers
<ul>
<li>Renaming chapters</li>
<li>Importing and exporting chapters</li>
</ul>
</li>
<li>Post-processing metadata with Subler, others?</li>
</ul>
<h2>Restoration and enhancement</h2>
<ul>
<li>Common video problems
<ul>
<li>Black bars at top/bottom or sides
<ul>
<li>Cropping</li>
</ul>
</li>
<li>Combing effects caused by interlacing or telecine
<ul>
<li>Detelecine filter</li>
<li>Decomb filter vs. Deinterlace filter</li>
<li>Bob mode and frame rates, motion
<ul>
<li>May affect compatibility</li>
</ul>
</li>
</ul>
</li>
<li>Noise (grainy appearance and/or color splotches)
<ul>
<li>Denoise filters: NLMeans and HQDN3D</li>
</ul>
</li>
<li>Blocky picture
<ul>
<li>Deblock filter</li>
</ul>
</li>
<li>Stretched picture (too wide or too tall)
<ul>
<li>Scaling and anamorphic</li>
<li>May affect compatibility</li>
</ul>
</li>
</ul>
</li>
<li>Common audio problems
<ul>
<li>Volume level too low</li>
<li>Dynamics too wide (soft whispers, loud booms)</li>
</ul>
</li>
<li>Example videos?</li>
</ul>
<h2>Advanced features part 2</h2>
<p>May affect compatiblity! Use a preset!</p>
<ul>
<li>Formats/containers</li>
<li>Video source type
<ul>
<li>x264 tune
<ul>
<li>May affect compatibility</li>
</ul>
</li>
</ul>
</li>
<li>Video encoding speed
<ul>
<li>Quality affects speed</li>
<li>x264 preset
<ul>
<li>May affect compatibility</li>
</ul>
</li>
</ul>
</li>
<li>Video angle</li>
<li>Point-to-point</li>
<li>Frame rate
<ul>
<li>Same as source VFR/CFR</li>
<li>Fixed VFR (peak) or CFR</li>
</ul>
</li>
<li>Audio quality (bitrate)
<ul>
<li>Affects file size, though not as much as video quality</li>
<li>Adjustments may impact compatibility (recommend to leave alone)</li>
</ul>
</li>
<li>Audio defaults</li>
<li>Subtitle defaults</li>
<li>Automatic file naming</li>
<li>Web optimized</li>
<li>iPod 5G support</li>
</ul>
<h2>Getting help</h2>
<ul>
<li>Troubleshooting common issues</li>
<li><a href="help/community-support.html">Community support</a> - Help from real people</li>
<li>Activity log
<ul>
<li>Required for support, see Getting help</li>
</ul>
</li>
</ul>
<h2>HandBrake lore</h2>
<ul>
<li>About the name HandBrake</li>
<li>About the cocktail and pineapple icon</li>
<li>Other esoteric information</li>
</ul>
<h2>CLI documentation</h2>
<ul>
<li>CLI documentation</li>
</ul>
<h2>Technical documentation</h2>
<ul>
<li>Introduction
<ul>
<li>Not for regular use</li>
</ul>
</li>
<li><a href="technical/source-formats.html">Source formats</a></li>
<li>Containers
<ul>
<li>Known issue: MP4 edit lists</li>
</ul>
</li>
<li>Video
<ul>
<li>Codecs</li>
<li>x264 presets, tunes, and custom settings</li>
<li>x264 profile and level</li>
<li>Constant quality versus average bit rate</li>
<li>VFR/PFR, CFR, custom frame rates</li>
</ul>
</li>
<li>Advanced picture and filters
<ul>
<li>Anamorphic modes</li>
<li>Modulus</li>
<li>Custom filter settings</li>
</ul>
</li>
<li>Audio
<ul>
<li>Codecs: autodetection, read/passthru
<ul>
<li>Known issue: Dolby Atmos</li>
</ul>
</li>
<li>Gain</li>
<li>DRC</li>
<li>Mixdown</li>
</ul>
</li>
<li>Subtitles
<ul>
<li>Formats</li>
</ul>
</li>
<li>Advanced preferences</li>
</ul>
<footer>
<p><span class="authorship">This article is part of the <a href="../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,74 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Source formats</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Source formats</div>
</header>
<h1>Source formats</h1>
<p>One of HandBrake&rsquo;s strengths is its ability to open a wide variety of video formats. HandBrake uses <a href="https://libav.org/">Libav</a> under the hood and generally can open whatever Libav will, in addition to disc-based formats like DVD and Blu-ray.</p>
<p><strong>Note:</strong> HandBrake does not defeat or circumvent <a href="https://en.wikipedia.org/wiki/Copy_protection">copy protection</a> of any kind. It does not work with video files employing <a href="https://en.wikipedia.org/wiki/Digital_rights_management">Digital Rights Management</a> (DRM). See <a href="../about.html">About HandBrake</a> for more information about what HandBrake <em>does</em> and <em>does not</em>.</p>
<h2>Videos made by mobile phones, tablets, and many video cameras and DSLRs</h2>
<p>Typically, each video will be a single file that you can copy to your computer, and later open using HandBrake. Common video file types are MP4 or M4V, MOV, MPG or MPEG, and AVI.</p>
<p>Some cameras store multiple videos in a folder structure with a playlist similar to Blu-ray discs, specifically cameras that record in AVCHD or AVCHD Lite. HandBrake may be able to open individual video files from the Stream folder inside the BDMV folder. In some cases this is not reliable, e.g. where a single video stream spans multiple files.</p>
<h2>Screen and game recordings, web videos, video editing projects, and other computer-related sources</h2>
<p>Some screen recording softwares can export or record directly to video files HandBrake can open. Common video file types are MP4 or M4V, MKV, MPG or MPEG, AVI, and WMV.</p>
<p>HandBrake can open web videos in FLV, WEBM, MP4, and many other formats.</p>
<p>Videos made using consumer video editing software such as <a href="https://www.apple.com/mac/imovie/">iMovie</a> must first be exported to a common video format for compatibility with HandBrake.</p>
<h2>Professional video production formats</h2>
<p>HandBrake can open a number of production formats produced by professional video cameras and <abbr title="Non-linear editing system">NLE</abbr>s, including <a href="https://en.wikipedia.org/wiki/Apple_ProRes">ProRes</a> and <a href="https://en.wikipedia.org/wiki/DNxHD_codec">DNxHD</a>.</p>
<h2>DVD, Blu-ray, AVCHD/AVCHD Lite<sup id="fnref:1"><a href="#fn:1" rel="footnote">1</a></sup>, and HD-DVD<sup id="fnref:2"><a href="#fn:2" rel="footnote">2</a></sup> discs or disc backups</h2>
<p>HandBrake can directly open DVD and Blu-ray discs. In most situations it is better to first copy the contents to your computer&rsquo;s hard drive<sup id="fnref:3"><a href="#fn:3" rel="footnote">3</a></sup>. Common folders are VIDEO_TS and BDMV. Common video file types are VOB, EVO, and MTS or M2TS.</p>
<p>Certain third-party disc copy tools such as MakeMKV (TODO: link) commonly make&hellip; wait for it&hellip; MKV video files. Other tools create ISO (sometimes labeled CDR) images of DVD and Blu-ray discs. HandBrake usually can open these directly.</p>
<p>BIN+CUE, MDF+MDS, and Toast images must first be mounted. Open the image using your operating system or appropriate software, and then open the virtual disc with HandBrake.</p>
<h2>Broadcast TV recordings</h2>
<p>HandBrake can open common video file types produced by TV recording hardware and software such as TS/MTS/M2TS, MP4 or M4V, and MPG or MPEG.</p>
<p>Recordings made by TV-to-DVD recorders are generally supported, but do note that some recorders are known for poorly making discs. Some discs may not work due to mastering errors.</p>
<h2>Digital recordings of VHS, Beta, Video8/Hi8, LaserDisc, and other analog sources</h2>
<p>First convert your analog video to digital using a computer-based hardware recording device such as the <a href="https://www.blackmagicdesign.com/products/intensity">Blackmagic Design Intensity</a>. It is important to choose a recording device and software that allows recording to or exporting to common video formats. HandBrake can open many common video files produced by recording software, including but not limited to TS/MTS/M2TS, MP4 or M4V, MOV, MKV, MPG or MPEG, and AVI.</p>
<div class="footnotes">
<hr/>
<ol>
<li id="fn:1">
<p>AVCHD and AVCHD Lite playlists are not fully supported. Individual files/streams may work.<a href="#fnref:1" rev="footnote">&#8617;</a></p></li>
<li id="fn:2">
<p>HD-DVD playlists are not fully supported. Individual files/streams may work.<a href="#fnref:2" rev="footnote">&#8617;</a></p></li>
<li id="fn:3">
<p>Without special software, it is not possible to directly copy VIDEO_TS and BDMV folders from copy-protected discs.<a href="#fnref:3" rev="footnote">&#8617;</a></p></li>
</ol>
</div>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,75 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Adjusting quality</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Adjusting quality</div>
</header>
<h1>Adjusting quality</h1>
<p>HandBrake&rsquo;s default settings and built-in <code>Presets</code> use a constant quality encoding method. This makes your new video look consistent from start to finish. Always use constant quality unless you have a specific reason not to.</p>
<p>You can use the default setting for the <code>Preset</code> you selected, or adjust the quality control higher or lower depending on your tastes. Increasing quality will make your new video take up more space on your computer or playback device, whereas reducing quality will typically make your new video take up less space.</p>
<h2>Using the quality control</h2>
<p>Most of HandBrake&rsquo;s built-in <code>Presets</code> use the x264 video encoder and a constant quality value of <abbr title="Rate Factor">RF</abbr> 20. A lower RF number means <em>higher</em> quality.</p>
<p>To increase video quality, adjust the quality control toward the right. To reduce video quality, adjust the quality control toward the left.</p>
<p><img src="../images/quality-control.png" alt="Quality control" /></p>
<p>Begin by making small adjustments (plus or minus 1-2 RF is usually noticeable).</p>
<h2>Recommended quality settings</h2>
<p>Recommended settings for x264 are:</p>
<ul>
<li>RF 18-22 for 480p Standard Definition<sup id="fnref:1"><a href="#fn:1" rel="footnote">1</a></sup></li>
<li>RF 19-23 for 720p High Definition<sup id="fnref:2"><a href="#fn:2" rel="footnote">2</a></sup></li>
<li>RF 20-24 for 1080p High Definition<sup id="fnref:3"><a href="#fn:3" rel="footnote">3</a></sup></li>
</ul>
<p>Lower quality settings may be used to produce smaller video files or for web videos where bandwidth is a concern. Drastically lower settings may show significant loss of detail.</p>
<p>Using higher than recommended quality settings (exceeding RF 18 or so) can lead to <em>extremely large files</em> that may not be compatible with your devices. When in doubt, stick to the recommended range or use the default setting for the <code>Preset</code> you selected.</p>
<h2>Display size and viewing distance</h2>
<p>Imperfections tend to be more noticeable at larger display sizes and closer viewing distances. This is especially true for lower resolution videos (less than 720p), which are typically scaled or &ldquo;blown up&rdquo; to fill your display, magnifying even minor imperfections in quality.</p>
<p>You may wish to slightly increase quality for viewing on larger displays (50 inches / 125 cm diagonal or greater), or where viewing from closer than average distances<sup id="fnref:4"><a href="#fn:4" rel="footnote">4</a></sup>. Reduced quality may be acceptable for viewing on smaller screens or where storage space is limited, e.g. mobile devices.</p>
<h2>Next steps</h2>
<p>Continue to <a href="preview-settings.html">Previewing your settings</a>.</p>
<div class="footnotes">
<hr/>
<ol>
<li id="fn:1">
<p><abbr title="Standard Definition">SD</abbr> video has a resolution of 720x480 or fewer pixels. DVDs, small web videos, and most analog sources are SD.<a href="#fnref:1" rev="footnote">&#8617;</a></p></li>
<li id="fn:2">
<p>720p <abbr title="High Definition">HD</abbr> video has a resolution of 1280x720 pixels. With three times the resolution of SD, and about half that of 1080p HD, 720p HD is commonly used by consumer video cameras, web videos, and broadcast TV sports.<a href="#fnref:2" rev="footnote">&#8617;</a></p></li>
<li id="fn:3">
<p>1080p <abbr title="High Definition">HD</abbr> video has a resolution of 1920x1080 pixels—twice the resolution of 720p and six times the resolution of 480p. 1080p HD video is commonly used by mobile phones and tablets, consumer and professional video cameras, and Blu-ray.<a href="#fnref:3" rev="footnote">&#8617;</a></p></li>
<li id="fn:4">
<p>Learn more about <a href="https://en.wikipedia.org/wiki/Optimum_HDTV_viewing_distance">optimum viewing distances for high definition TV displays</a>.<a href="#fnref:4" rev="footnote">&#8617;</a></p></li>
</ol>
</div>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,76 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Opening a video</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Opening a video</div>
</header>
<h1>Opening a video</h1>
<p>In HandBrake terms, the original video you already have is called the <code>Source</code>. One of HandBrake&rsquo;s strengths is its ability to open <code>Sources</code> in a wide variety of video formats, including but not limited to:</p>
<ul>
<li>Videos made by mobile phones, tablets, and many video cameras and DSLRs</li>
<li>Screen and game recordings, web videos, video editing projects<sup id="fnref:1"><a href="#fn:1" rel="footnote">1</a></sup>, and other computer-related sources</li>
<li>Professional video production formats including ProRes and DNxHD</li>
<li>DVD, Blu-ray, AVCHD/AVCHD Lite<sup id="fnref:2"><a href="#fn:2" rel="footnote">2</a></sup>, and HD-DVD<sup id="fnref:3"><a href="#fn:3" rel="footnote">3</a></sup> discs or disc backups</li>
<li>Broadcast TV recordings</li>
<li>Digital recordings of VHS, Beta, Video8/Hi8, LaserDisc, and other analog sources</li>
</ul>
<p>Learn more about <a href="../technical/source-formats.html">source formats</a>.</p>
<p><strong>Note:</strong> HandBrake does not defeat or circumvent <a href="https://en.wikipedia.org/wiki/Copy_protection">copy protection</a> of any kind. It does not work with video files employing <a href="https://en.wikipedia.org/wiki/Digital_rights_management">Digital Rights Management</a> (DRM). See <a href="../introduction/about.html">About HandBrake</a> for more information about what HandBrake <em>does</em> and <em>does not</em>.</p>
<h2>Using the Open Source dialog</h2>
<p>At the top of HandBrake&rsquo;s main window, you&rsquo;ll see a toolbar with various buttons.</p>
<p><img src="../images/toolbar.png" alt="Main window toolbar" /></p>
<p>Select the <code>Open Source</code> button to select the video you want to open.</p>
<p><img src="../images/open-source-button.png" alt="Open Source button" /></p>
<p><img src="../images/open-source-dialog.png" alt="Open Source dialog" /></p>
<h2>Dragging and dropping</h2>
<p>You can also drag and drop a video <code>Source</code> onto HandBrake&rsquo;s main window.</p>
<p><img src="../images/drag-and-drop-source.png" alt="Opening a video source via drag and drop" /></p>
<h2>Next steps</h2>
<p>Great! At this point, HandBrake knows which video you want to use.</p>
<p>If HandBrake didn&rsquo;t open your video as as expected or you had some other trouble, you can continue reading to learn more about how HandBrake works or jump right to <a href="../help/index.html">Getting help</a>.</p>
<p>Continue to <a href="select-preset.html">Selecting a preset</a>.</p>
<div class="footnotes">
<hr/>
<ol>
<li id="fn:1">
<p>Videos made using consumer video editing software such as <a href="https://www.apple.com/mac/imovie/">iMovie</a> must first be exported to a common video format for compatibility with HandBrake.<a href="#fnref:1" rev="footnote">&#8617;</a></p></li>
<li id="fn:2">
<p>AVCHD and AVCHD Lite playlists are not fully supported. Individual files/streams may work.<a href="#fnref:2" rev="footnote">&#8617;</a></p></li>
<li id="fn:3">
<p>HD-DVD playlists are not fully supported. Individual files/streams may work.<a href="#fnref:3" rev="footnote">&#8617;</a></p></li>
</ol>
</div>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,72 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Previewing your settings</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Previewing your settings</div>
</header>
<h1>Previewing your settings</h1>
<p>Video encoding requires a lot of computer resources and can take awhile to complete. Exactly how long depends on a number of factors, including the duration, resolution, and complexity of your <code>Source</code>, and the settings for making your new video.</p>
<p>Luckily, HandBrake has a <code>Preview</code> feature that allows you to do a test run on a few seconds or minutes of your <code>Source</code>, so you can see what your new video will look like without waiting for a complete encode to finish.</p>
<h2>Opening the Preview window</h2>
<p>At the top of HandBrake&rsquo;s main window, you&rsquo;ll see a toolbar with various buttons.</p>
<p><img src="../images/toolbar.png" alt="Main window toolbar" /></p>
<p>Select the <code>Preview</code> button to open the <code>Preview</code> window.</p>
<p><img src="../images/preview-button.png" alt="Preview button" /></p>
<p><img src="../images/preview-window.png" alt="Preview window" /></p>
<h2>Adjusting Preview settings</h2>
<p>Move your mouse cursor over the <code>Preview</code> window, and some controls will appear.</p>
<p><img src="../images/preview-controls.png" alt="Preview controls" /></p>
<p>Set the starting position by dragging the <code>Position</code> control left or right. Choose how many seconds of video you want to encode using the <code>Duration</code> control. Longer durations will take more time to encode.</p>
<p><img src="../images/preview-controls-position.png" alt="Preview position control" /></p>
<p><img src="../images/preview-controls-duration.png" alt="Preview duration control" /></p>
<h2>Starting a Preview encode</h2>
<p>When you&rsquo;re satisfied with your starting position and duration, select <code>Live Preview</code> and be patient. HandBrake will report its progress while it works. When your <code>Preview</code> is ready, it will play automatically. You can use the playback controls to pause, rewind, and replay your <code>Preview</code>.</p>
<p><img src="../images/preview-controls-start.png" alt="Preview start control" /></p>
<p><img src="../images/preview-playing.png" alt="Preview playing" /></p>
<h2>Finishing up</h2>
<p>To create a new <code>Preview</code>, select the <code>Still Previews</code> button to start over. When you&rsquo;re finished previewing your work, you may close the <code>Preview</code> window.</p>
<p><img src="../images/preview-controls-reset.png" alt="Preview reset control" /></p>
<p><img src="../images/preview-window-close.png" alt="Closing the preview window" /></p>
<h2>Next steps</h2>
<p>If the <code>Preview</code> you created was lacking in quality or otherwise not as expected, you may need to <a href="adjust-quality.html">adjust quality</a> or select a different <a href="select-preset.html">Preset</a>, after which you can create another <code>Preview</code> to see any changes.</p>
<p>Once you are satisfied, continue to <a href="start-encoding.html">Starting encoding</a>.</p>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,46 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Selecting a preset</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Selecting a preset</div>
</header>
<h1>Selecting a preset</h1>
<p><em>Presets, presets, presets.</em></p>
<p>Selecting a <code>Preset</code> can go a long way toward ensuring your video works where you want it to. A <code>Preset</code> is a group of settings specifically tailored for the software or device you want your videos to play on.</p>
<h2>Built-in presets</h2>
<p>HandBrake includes a number of built-in <code>Presets</code> for various devices and general use.</p>
<p><img src="../images/presets.png" alt="Presets" /></p>
<p>Once you&rsquo;ve opened a <code>Source</code>, select the <code>Preset</code> that most closely describes the device you want your videos to work on. For instance, if you want to play your videos on an iPad, choose the <code>iPad Preset</code>.</p>
<p><img src="../images/preset-selection.png" alt="Selecting a preset" /></p>
<p>If your device is not listed, or you wish to play your videos on a computer, choose the <code>Normal Preset</code> or <code>High Profile Preset</code>. The <code>Normal Preset</code> is fast and compatible across a wide range of softwares and devices. The <code>High Profile Preset</code> makes better quality videos that take up less space, leaving room for a second audio track in surround sound.</p>
<h2>Custom presets</h2>
<p>If you&rsquo;ve previously saved one of your own <code>Presets</code>, you may select it in the same way as the built-in <code>Presets</code>. Learn more about Custom presets (TODO: link).</p>
<h2>Next steps</h2>
<p>Continue to <a href="adjust-quality.html">Adjusting quality</a>.</p>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

View File

@ -1,54 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - Starting encoding</title>
<link rel="stylesheet" type="text/css" href="../../../style/style.css" />
</head>
<body>
<article class="docs">
<header>
<div class="breadcrumbs">English Docs > HandBrake Latest > Starting encoding</div>
</header>
<h1>Starting encoding</h1>
<p>Now that you&rsquo;ve got all your settings just right, it&rsquo;s time to make your new video!</p>
<h2>Selecting a destination</h2>
<p><code>Destination</code> is where your new video will go. You can select the <code>Browse...</code> button to choose a new location and name, or type it directly in the box.</p>
<p><img src="../images/destination.png" alt="Selecting a destination" /></p>
<p>Please take special care to <em>note your destination</em>. Otherwise, you won&rsquo;t be able to find your new video. You can move it later if you desire.</p>
<h2>Starting the encode</h2>
<p>Select the <code>Start</code> button on the toolbar to make your new video.</p>
<p><img src="../images/toolbar.png" alt="Main window toolbar" /></p>
<p><img src="../images/start-button.png" alt="Starting an encode" /></p>
<p>HandBrake will report its progress while it&rsquo;s working and alert you when it&rsquo;s finished. Then you will have a new video file at the <code>Destination</code> you specified.</p>
<p><img src="../images/encode-complete.png" alt="Encoding complete alert" /></p>
<p><img src="../images/destination-file-icon.png" alt="Destination video file icon" /></p>
<p>Congratulations! You just encoded your first video using HandBrake. It&rsquo;s now ready to watch on your devices.</p>
<h2>Next steps</h2>
<p>If you didn&rsquo;t get a video file as expected, encountered an error, or had some other trouble, you can continue reading to learn more about how HandBrake works or jump right to <a href="../help/index.html">Getting help</a>.</p>
<p>Continue to (TODO: add link).</p>
<footer>
<p><span class="authorship">This article is part of the <a href="../../../" title="HandBrake Documentation">HandBrake Documentation</a> and was written by Bradley Sepos.</span> <span class="contributing">Join us on GitHub to contribute your thoughts and ideas, and to suggest any necessary corrections.</span></p>
<small class="copyright">Copyright 2016 HandBrake Team. <a href="../../../license-summary.html" title="License Summary"><abbr title="Creative Commons Attribution-ShareAlike 4.0 International">CC BY-SA 4.0</abbr></a>.</small>
</footer>
</article>
</body>
</html>

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -1,51 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - License Summary</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
</head>
<body>
<article class="docs">
<h1>License Summary</h1>
<p>HandBrake Documentation (this work) is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License.</p>
<p>The following is a human-readable summary of the license, and is not a substitute for the <a href="license.html">full legal license</a>.</p>
<h2>You are free to:</h2>
<p><strong>Share</strong> — copy and distribute the material in any medium or format for any purpose, even commercially</p>
<p><strong>Adapt</strong> — remix, transform, and build upon the material for any purpose, even commercially</p>
<p>The licensor cannot revoke these freedoms as long as you follow the license terms.</p>
<h2>Under the following terms:</h2>
<p><strong>Attribution</strong> — You must give <strong>appropriate credit</strong><sup id="fnref:1"><a href="#fn:1" rel="footnote">1</a></sup>, provide a link to the license, and <strong>indicate if changes were made</strong><sup id="fnref:2"><a href="#fn:2" rel="footnote">2</a></sup>. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.</p>
<p><strong>ShareAlike</strong> — If you remix, transform, or build upon the material, you must distribute your contributions under the <strong>same license</strong><sup id="fnref:3"><a href="#fn:3" rel="footnote">3</a></sup> as the original.</p>
<p><strong>No additional restrictions</strong> — You may not apply legal terms or <strong>technological measures</strong><sup id="fnref:4"><a href="#fn:4" rel="footnote">4</a></sup> that legally restrice others from doing anything the license permits.</p>
<div class="footnotes">
<hr/>
<ol>
<li id="fn:1">
<p>If supplied, you must provide the name of the creator and attribution parties, a copyright notice, a license notice, a disclaimer notice, and a link to the material. <a href="https://wiki.creativecommons.org/wiki/Best_practices_for_attribution">More info on attribution</a>.<a href="#fnref:1" rev="footnote">&#8617;</a></p></li>
<li id="fn:2">
<p>You must indicate if you modified the material and retain an indication of previous modifications. <a href="https://wiki.creativecommons.org/wiki/Best_practices_for_attribution">More info on attribution</a>.<a href="#fnref:2" rev="footnote">&#8617;</a></p></li>
<li id="fn:3">
<p>You may also use a license listed as compatible at <a href="https://creativecommons.org/compatiblelicenses">creativecommons.org/compatiblelicenses</a>.<a href="#fnref:3" rev="footnote">&#8617;</a></p></li>
<li id="fn:4">
<p>The license prohibits application of effective technological measures, defined with reference to Article 11 of the WIPO Copyright Treaty. <a href="https://wiki.creativecommons.org/wiki/License_Versions#Application_of_effective_technological_measures_by_users_of_CC-licensed_works_prohibited">More info on application of effective technological measures</a>.<a href="#fnref:4" rev="footnote">&#8617;</a></p></li>
</ol>
</div>
</article>
</body>
</html>

View File

@ -1,166 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="author" content="Bradley Sepos" />
<title>HandBrake Documentation - License</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
</head>
<body>
<article class="docs">
<h1>Creative Commons Attribution-ShareAlike 4.0 International Public License</h1>
<p>By exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-ShareAlike 4.0 International Public License (&ldquo;Public License&rdquo;). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.</p>
<h2>Section 1 Definitions.</h2>
<ol type="a">
<li><strong>Adapted Material</strong> means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.</li>
<li><strong>Adapter&rsquo;s License</strong> means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.</li>
<li><strong>BY-SA Compatible License</strong> means a license listed at <a href="https://creativecommons.org/compatiblelicenses">creativecommons.org/compatiblelicenses</a>, approved by Creative Commons as essentially the equivalent of this Public License.</li>
<li><strong>Copyright and Similar Rights</strong> means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.</li>
<li><strong>Effective Technological Measures</strong> means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.</li>
<li><strong>Exceptions and Limitations</strong> means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.</li>
<li><strong>License Elements</strong> means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution and ShareAlike.</li>
<li><strong>Licensed Material</strong> means the artistic or literary work, database, or other material to which the Licensor applied this Public License.</li>
<li><strong>Licensed Rights</strong> means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.</li>
<li><strong>Licensor</strong> means the individual(s) or entity(ies) granting rights under this Public License.</li>
<li><strong>Share</strong> means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.</li>
<li><strong>Sui Generis Database Rights</strong> means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.</li>
<li><strong>You</strong> means the individual or entity exercising the Licensed Rights under this Public License. <strong>Your</strong> has a corresponding meaning.</li>
</ol>
<h2>Section 2 Scope.</h2>
<ol type="a">
<li><strong>License grant.</strong>
<ol>
<li>Subject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:
<ol type="A">
<li>reproduce and Share the Licensed Material, in whole or in part; and</li>
<li>produce, reproduce, and Share Adapted Material.</li>
</ol></li>
<li>Exceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.</li>
<li>Term. The term of this Public License is specified in Section 6(a).</li>
<li>Media and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.</li>
<li>Downstream recipients.
<ol type="A">
<li>Offer from the Licensor Licensed Material. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.</li>
<li>Additional offer from the Licensor Adapted Material. Every recipient of Adapted Material from You automatically receives an offer from the Licensor to exercise the Licensed Rights in the Adapted Material under the conditions of the Adapters License You apply.</li>
<li>No downstream restrictions. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.</li>
</ol></li>
<li>No endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).</li>
</ol>
</li>
<li><strong>Other rights.</strong>
<ol>
<li>Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.</li>
<li>Patent and trademark rights are not licensed under this Public License.</li>
<li>To the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties.</li>
</ol>
</li>
</ol>
<h2>Section 3 License Conditions.</h2>
<p>Your exercise of the Licensed Rights is expressly made subject to the following conditions.</p>
<ol type="a">
<li><strong>Attribution.</strong>
<ol>
<li>If You Share the Licensed Material (including in modified form), You must:
<ol type="A">
<li>retain the following if it is supplied by the Licensor with the Licensed Material:
<ol type="i">
<li>identification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);</li>
<li>a copyright notice;</li>
<li>a notice that refers to this Public License;</li>
<li>a notice that refers to the disclaimer of warranties;</li>
<li>a URI or hyperlink to the Licensed Material to the extent reasonably practicable;</li>
</ol>
</li>
<li>indicate if You modified the Licensed Material and retain an indication of any previous modifications; and</li>
<li>indicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.</li>
</ol></li>
<li>You may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.</li>
<li>If requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.</li>
</ol>
</li>
<li><strong>ShareAlike.</strong> <p>In addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply.</p>
<ol>
<li>The Adapters License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-SA Compatible License.</li>
<li>You must include the text of, or the URI or hyperlink to, the Adapter&rsquo;s License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material.</li>
<li>You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter&rsquo;s License You apply.</li>
</ol>
</li>
</ol>
<h2>Section 4 Sui Generis Database Rights.</h2>
<p>Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:</p>
<ol type="a">
<li>for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database;</li>
<li>if You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material, including for purposes of Section 3(b); and</li>
<li>You must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.</li>
</ol>
<p>For the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.</p>
<h2>Section 5 Disclaimer of Warranties and Limitation of Liability.</h2>
<ol type="a">
<li><strong>Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.</strong></li>
<li><strong>To the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.</strong></li>
<li>The disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.</li>
</ol>
<h2>Section 6 Term and Termination.</h2>
<ol type="a">
<li><p>This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.</p></li>
<li><p>Where Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:</p>
<ol>
<li>automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or</li>
<li>upon express reinstatement by the Licensor.
For the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.</li>
</ol>
</li>
<li>For the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.</li>
<li>Sections 1, 5, 6, 7, and 8 survive termination of this Public License.</li>
</ol>
<h2>Section 7 Other Terms and Conditions.</h2>
<ol type="a">
<li>The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.</li>
<li>Any arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.</li>
</ol>
<h2>Section 8 Interpretation.</h2>
<ol type="a">
<li>For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.</li>
<li>To the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.</li>
<li>No term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.</li>
<li>Nothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.</li>
</ol>
</article>
</body>
</html>

View File

@ -1,126 +0,0 @@
/**
* Ropa Sans
* Copyright 2011 Botjo Nikoltchev <nikoltchev@lettersoup.de>
* SIL Open Font License 1.1
* http://scripts.sil.org/OFL
*/
@font-face {
font-family: 'Ropa Sans';
font-style: normal;
font-weight: 400;
src: local('Ropa Sans'), local('RopaSans-Regular'), url('../fonts/ropasans-regular-1.002.woff2') format('woff2'), url('../fonts/ropasans-regular-1.002.woff') format('woff');
}
@font-face {
font-family: 'Ropa Sans';
font-style: italic;
font-weight: 400;
src: local('Ropa Sans Italic'), local('RopaSans-Italic'), url('../fonts/ropasans-italic-1.002.woff2') format('woff2'), url('../fonts/ropasans-italic-1.002.woff') format('woff');
}
/**
* Open Sans
* Digitized data copyright 2010-2011 Google Corporation
* Apache License 2.0
* http://www.apache.org/licenses/LICENSE-2.0.html
*/
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
src: local('Open Sans'), local('OpenSans-Regular'), url('../fonts/opensans-regular-1.10.woff2') format('woff2'), url('../fonts/opensans-regular-1.10.woff') format('woff');
}
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
src: local('Open Sans'), local('OpenSans-Bold'), url('../fonts/opensans-bold-1.10.woff2') format('woff2'), url('../fonts/opensans-bold-1.10.woff') format('woff');
}
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
src: local('Open Sans Italic'), local('OpenSans-Italic'), url('../fonts/opensans-italic-1.10.woff2') format('woff2'), url('../fonts/opensans-italic-1.10.woff') format('woff');
}
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
src: local('Open Sans Bold Italic'), local('OpenSans-BoldItalic'), url('../fonts/opensans-bolditalic-1.10.woff2') format('woff2'), url('../fonts/opensans-bolditalic-1.10.woff') format('woff');
}
article.docs {
margin: 0 auto;
padding: 40px 150px;
max-width: 650px;
font-family: 'Open Sans';
font-size: 15px;
line-height: 25px;
}
article.docs h1,
article.docs h2,
article.docs h3,
article.docs h4,
article.docs h5,
article.docs h6 {
font-family: 'Ropa Sans';
font-weight: 400;
text-rendering: geometricPrecision;
color: rgb(60,60,60);
}
article.docs h1 {
font-size: 40px;
line-height: 1;
letter-spacing: -0.035em;
}
article.docs h2 {
font-size: 28px;
line-height: 30px;
letter-spacing: -0.025em;
}
article.docs h3 {
font-size: 21px;
line-height: 25px;
text-transform: uppercase;
letter-spacing: -0.018em;
}
article.docs h4 {
font-size: 19px;
line-height: 20px;
letter-spacing: -0.02em;
}
article.docs h5 {
font-size: 17px;
line-height: 20px;
text-transform: uppercase;
letter-spacing: -0.01em;
}
article.docs h6 {
font-size: 14px;
line-height: 15px;
text-transform: uppercase;
letter-spacing: -0.005em;
}
article.docs header .breadcrumbs {
font-size: 12px;
}
article.docs footer p {
font-style: italic;
}
article.docs p,
article.docs > ol,
article.docs > ul,
article.docs header .breadcrumbs,
article.docs footer p,
article.docs footer small {
margin: 1.33333em 0;
}