diff --git a/source/docs/en/1.0.0/advanced/queue.markdown b/source/docs/en/1.0.0/advanced/queue.markdown index ba87ebd6..e89e854c 100644 --- a/source/docs/en/1.0.0/advanced/queue.markdown +++ b/source/docs/en/1.0.0/advanced/queue.markdown @@ -25,33 +25,33 @@ Luckily, you can set up multiple encodes at once by adding them to HandBrake's ` Begin by [opening a Source, selecting a Title](../workflow/open-video-source.html), and [selecting a Preset](../workflow/select-preset.html). Then select the `Add to Queue` button on the toolbar. - + ![Adding an encode to the Queue](../../images/mac/add-to-queue-button-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - + Select the `Show Queue` button on the toolbar to see the queued encodes, or `Jobs`. - + ![Opening the Queue window](../../images/mac/queue-button-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") ![Queue window on Mac](../../images/mac/queue-1.0.0.png "The Queue window lists pending Jobs.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") ![Queue window on Windows](../../images/windows/queue-1.0.0.png "The Queue window lists pending Jobs.") - + You may open additional `Sources` and add them to the `Queue` in the same manner. @@ -59,7 +59,7 @@ You may open additional `Sources` and add them to the `Queue` in the same manner When using the `Queue`, you may find it beneficial to create multiple `Jobs` at one time. - + On Mac, first open the `Preferences` window using the `HandBrake` menu. In the `General` section, ensure that the `Automatically name output files` setting is selected and `Title` is part of the `Format` field. @@ -69,8 +69,8 @@ On Mac, first open the `Preferences` window using the `HandBrake` menu. In the ` This ensures that each of your `Jobs` will be given a unique file name, and not overwrite each other. - - + + On Windows, first open the `Preferences` window using the `Tools` menu. In the `Output Files` section, ensure that the `Automatically name output files` setting is selected. Set a `Default Path` (where your new videos will be created) and make sure `Title` is part of the `File Format` field. @@ -80,25 +80,25 @@ On Windows, first open the `Preferences` window using the `Tools` menu. In the ` This ensures that each of your `Jobs` will be given a unique file name, and not overwrite each other. - + If your `Source` is a Blu-ray, DVD, or other disc or disc-like format with multiple `Titles`, you may open it with HandBrake and add multiple `Titles` to the `Queue` simultaneously. Additionally, you may open a folder of multiple single-`Title` videos (excluding discs and disc-like formats) as one virtual `Source` with multiple `Titles` using the `Open Source` dialog, and then add multiple `Titles` to the `Queue`[^batch-scan-subdirectories]. - + ![Opening a folder containing multiple video Sources](../../images/mac/open-source-dialog-folder-1.0.0.png "The Open Source dialog allows you to select a folder containing multiple video files.") ![Selecting a Title](../../images/mac/title-selection-1.0.0.png "The Title control lets you select which video clip you want to use.") - - + + On Linux, select `Add Multiple` from the `Queue` menu, then select the `Titles` you wish to encode using the presented dialog. Be sure to give each a unique file name. - - + + On Mac, select `Add Titles to Queue...` from the `File` menu, then select the `Titles` you wish to encode using the presented dialog. @@ -106,12 +106,12 @@ On Mac, select `Add Titles to Queue...` from the `File` menu, then select the `T ![Selecting multiple Titles to add to the Queue](../../images/mac/add-titles-to-queue-1.0.0.png "Select the Titles you wish to encode from the Add Titles to Queue dialog.") - - + + On Windows, select `All Selection to Queue` from the `Queue` menu to add all `Titles`. - + You may open additional `Sources` and add them to the `Queue` in the same manner. @@ -119,60 +119,60 @@ You may open additional `Sources` and add them to the `Queue` in the same manner To make changes to `Jobs` in the `Queue`, first open the `Queue` window by selecting the `Show Queue` button on the toolbar. - + ![Opening the Queue window](../../images/mac/queue-button-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") - + To remove a `Job`, select the `╳` button next to the unwanted `Job`. - + On Linux, if you want to make changes to a `Job` already in the `Queue`, select the `Job` and then select `Edit`. Editing a `Job` opens the `Source` in HandBrake's main window and removes the `Job` from the `Queue`. - - + + On Mac, if you want to make changes to a `Job` already in the `Queue`, control- or right-click on the `Job` and select `Edit`. Editing a `Job` opens the `Source` in HandBrake's main window and removes the `Job` from the `Queue`. ![Editing an encode Job on Mac](../../images/mac/queue-edit-1.0.0.png "Control- or right-click the Job and select Edit to make changes.") - - + + On Windows, if you want to make changes to a `Job` already in the `Queue`, select the edit button next to the `Job`. Editing a `Job` opens the `Source` in HandBrake's main window and removes the `Job` from the `Queue`. ![Editing an encode Job on Windows](../../images/windows/queue-1.0.0.png "Select the edit button, which looks like a sheet of paper, to make changes to a Job.") - + When you're finished making changes, again add the encode to the `Queue` by selecting the `Add to Queue` button on the toolbar. - + ![Adding an encode to the Queue](../../images/mac/add-to-queue-button-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - + ## Starting the Queue When ready, select the `Start` button on the`Queue` window or the `Start Queue` button on the main window to begin encoding the `Jobs` in the `Queue`. - + ![Starting the Queue](../../images/mac/start-queue-button-1.0.0.png "The Start Queue button begins encoding the Jobs in the Queue.") - + [^batch-scan-subdirectories]: When opening multiple videos in a folder, HandBrake ignores any additional folders inside. Make sure the videos you wish to open are at the top level of the selected folder. diff --git a/source/docs/en/1.0.0/get-handbrake/check-for-updates.markdown b/source/docs/en/1.0.0/get-handbrake/check-for-updates.markdown index 80882e0c..e882589a 100644 --- a/source/docs/en/1.0.0/get-handbrake/check-for-updates.markdown +++ b/source/docs/en/1.0.0/get-handbrake/check-for-updates.markdown @@ -21,14 +21,14 @@ HandBrake can let you know when a newer version is available, and even automatic Before updating, please make sure there are no pending encodes in the `Queue`. If you are currently using HandBrake older than version 1.0.0, also make note of any custom `Presets` you have created, as they may not be compatible with newer versions. - + ## Updating HandBrake on Linux The Linux version of HandBrake does not have a built-in update checking feature. Your Linux distribution's package manager will handle any updates to the official PPA. - - + + ## Updating HandBrake on Mac @@ -42,8 +42,8 @@ Manually checking for updates is easy. Using the main menu at the top of your sc ![Software update dialog](../../images/mac/software-update-1.0.0.png "If an update is available, HandBrake will offer to install it for you.") - - + + ## Updating HandBrake on Windows @@ -51,7 +51,7 @@ Automatic update checking may be enabled or disabled in HandBrake's preferences. Manually checking for updates is easy. From the `Help` menu, select `Check for Updates...`. If an update is available, HandBrake will offer to install it for you. - + diff --git a/source/docs/en/1.0.0/get-handbrake/download-and-install.markdown b/source/docs/en/1.0.0/get-handbrake/download-and-install.markdown index d9badfe6..3ddbb382 100644 --- a/source/docs/en/1.0.0/get-handbrake/download-and-install.markdown +++ b/source/docs/en/1.0.0/get-handbrake/download-and-install.markdown @@ -35,15 +35,15 @@ Experienced users may wish to try HandBrake's [nightly builds](https://handbrake The HandBrake Team publishes [checksums for all downloads on handbrake.fr](https://handbrake.fr/checksums.php) and the [Checksums article on GitHub](https://github.com/HandBrake/HandBrake/wiki/Checksums). You may use the provided checksums to verify the integrity of the files you download. - + When installing on Linux using the official PPA, download integrity is verified automatically. Similarly, the integrity of source code managed using `git` is verified automatically. To verify an official source distribution tarball, consult your Linux distribution's documentation for instructions on how to verify checksums. - + - + On Mac, launch Terminal from your Applications > Utilities folder and use the `shasum` command. For example, if you downloaded HandBrake 1.0.0 to your Downloads folder: @@ -51,15 +51,15 @@ On Mac, launch Terminal from your Applications > Utilities folder and use the `s Alternatively, the free third-party app [Hashsum](https://itunes.apple.com/us/app/hashsum/id1079442694?mt=12) available on the Mac App Store provides a convenient graphical interface for computing file checksums[^third-party-utilities-1]. - + - + On Windows, Microsoft provides the [Microsoft File Checksum Integrity Verifier](https://www.microsoft.com/en-us/download/details.aspx?id=11533) command line utility for verifying checksums. Please see the [associated Microsoft help article](https://support.microsoft.com/en-us/help/841290/availability-and-description-of-the-file-checksum-integrity-verifier-utility) for more information and usage instructions. Alternatively, free third-party apps [Compute Hash](http://www.subisoft.net/ComputeHash.aspx), [ExactFile](http://www.exactfile.com), and [MultiHasher](http://www.abelhadigital.com/multihasher) for Windows provide convenient graphical interfaces for computing file checksums[^third-party-utilities-2]. - + *If the checksums for the file you downloaded do not match the ones published by the HandBrake Team, you should delete the file and try your download again.* @@ -67,7 +67,7 @@ Alternatively, free third-party apps [Compute Hash](http://www.subisoft.net/Comp The HandBrake Team also publishes [OpenPGP signatures for all downloads on GitHub](https://github.com/HandBrake/HandBrake/releases). More information is available on the [OpenPGP article on GitHub](https://github.com/HandBrake/HandBrake/wiki/OpenPGP). - + ## Installing on Linux @@ -93,8 +93,8 @@ Run `HandBrakeCLI` to use HandBrake on the command line. Run `ghb` to launch HandBrake's graphical user interface. You may wish to right-click on the icon and select "Lock to Launcher" for easy access in the future. - - + + ## Installing on Mac @@ -120,8 +120,8 @@ Hold down the `Control` key and select the HandBrake icon to bring up the shortc Now HandBrake is up and running. You should not have to repeat this process in the near future. - - + + ## Installing on Windows @@ -153,7 +153,7 @@ By selecting `More info`, you will be able to select `Run anyway` to continue th ![Windows SmartScreen - Run Anyway](../../images/windows/smartscreen-2-1.0.0.png "Select Run anyway to dismiss the SmartScreen message and continue installing HandBrake.") - + ## Launching HandBrake diff --git a/source/docs/en/1.0.0/get-handbrake/where-to-get-handbrake.markdown b/source/docs/en/1.0.0/get-handbrake/where-to-get-handbrake.markdown index 3a133097..c62603ff 100644 --- a/source/docs/en/1.0.0/get-handbrake/where-to-get-handbrake.markdown +++ b/source/docs/en/1.0.0/get-handbrake/where-to-get-handbrake.markdown @@ -23,11 +23,11 @@ Official [HandBrake releases](https://handbrake.fr/downloads.php) and [nightly b HandBrake is open-source software licensed under the GNU General Public License Version 2 (GPLv2)[^license]. Anyone can download and use HandBrake *for free*. - + Ubuntu Linux users should install the [official release PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases) or the [official snapshots PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-git-snapshots). 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. - + HandBrake source code is available at the official [HandBrake repository on GitHub](https://github.com/HandBrake/HandBrake). @@ -41,7 +41,7 @@ Beware of third-party websites and peer-to-peer downloads of HandBrake. They may Beware of online marketplaces and auction sites. HandBrake is *free software*. - + ## Warning about broken third-party builds @@ -60,7 +60,7 @@ Please **do not** request support for these or any other unofficial versions. Th Linux users should install the [official release PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases), install the [official snapshots PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases), or compile from the [official source code](https://github.com/HandBrake/HandBrake). - + diff --git a/source/docs/en/1.0.0/help/activity-log.markdown b/source/docs/en/1.0.0/help/activity-log.markdown index 6be732a9..928cd5b4 100644 --- a/source/docs/en/1.0.0/help/activity-log.markdown +++ b/source/docs/en/1.0.0/help/activity-log.markdown @@ -99,7 +99,7 @@ Activity Logs may also be pasted directly into [new support requests on GitHub]( **Note:** When scanning a new source during encoding, log messages from the scan may be intermixed with log messages from your currently running encode. - + ### Activity Logs on Linux @@ -116,8 +116,8 @@ Inside, you may find the following files: - `Activity.log.ProcessID`, where `ProcessID` is the process identifier given to HandBrake by Linux, contains information about the specific app session - Log files for individual encodes are located in the `EncodeLogs` subdirectory and named according to the pattern `Videoname Date Time.txt`; encode logs are retained until deleted manually - - + + ### Activity Logs on Mac @@ -134,8 +134,8 @@ Inside, you may find the following files: - `HandBrake-activitylog.txt` is overwritten each time HandBrake starts, and contains information about the latest app session - Log files for individual encodes are named according to the pattern `Videoname Date Time.txt` and are retained until deleted manually - - + + ### Activity Logs on Windows @@ -153,7 +153,7 @@ Inside, you may find the following files: - `activity_logProcessID.txt`, where `ProcessID` is the process identifier given to HandBrake by Windows, contains information about the specific app session - Log files for individual encodes are named according to the pattern `Videoname Date Time.txt` and are retained until deleted manually - + ### Activity Logs on the command line diff --git a/source/docs/en/1.0.0/introduction/quick-start.markdown b/source/docs/en/1.0.0/introduction/quick-start.markdown index e7ae3765..4b47ffa7 100644 --- a/source/docs/en/1.0.0/introduction/quick-start.markdown +++ b/source/docs/en/1.0.0/introduction/quick-start.markdown @@ -35,43 +35,43 @@ HandBrake calls the video you already have the `Source`. Select the `Open Source` button on the toolbar to browse your files for a video to open. You may also drag your `Source` video onto HandBrake's main window. - + - - + + ![Browsing for a video source to open](../../images/mac/open-source-dialog-1.0.0.png "The Open Source dialog allows you to browse your files for a video to open.") ![Opening a video source via drag and drop](../../images/mac/open-source-drag-drop-1.0.0.png "In addition to the Open Source dialog, you may also open a video by dragging it to HandBrake's main window.") - - + + - + ## Select a title Some `Sources` may contain more than one video clip, or a collection of `Titles`. Use HandBrake's `Title` control to select which video clip you want to use. - + - - + + ![Selecting a title](../../images/mac/title-selection-1.0.0.png "Some sources may contain more than one video clip. The title control lets you select which video clip you want to use.") - - + + - + Some `Sources` have only one `Title`. Blu-ray and DVD `Sources` often have multiple `Titles`. @@ -81,23 +81,23 @@ HandBrake provides a number of settings `Presets` to make your new video work we The default `Fast 1080p30` preset is often a good choice because it's fast and compatible with most devices. - + - - + + ![Selecting a preset](../../images/mac/preset-selection-1.0.0.png "Presets are one-click settings to save you time and help ensure compatibility with your devices.") ![Toggling the presets list](../../images/mac/toggle-presets-button-1.0.0.png "If the presets list is not visible, select the Toggle Presets button on the toolbar.") - - + + - + `Presets` can affect compatibility (whether your video will work with your devices and software) and encoding time. Learn more about [Selecting a preset](../workflow/select-preset.html). @@ -105,23 +105,23 @@ The default `Fast 1080p30` preset is often a good choice because it's fast and c The `Destination` is where your new video will go. You can select the `Browse...` button to choose a different location and name, or type it directly in the box. - + - - + + ![Selecting a destination](../../images/mac/destination-field-1.0.0.png "Destination is where HandBrake will put your new video.") ![Browsing for a destination](../../images/mac/destination-dialog-1.0.0.png "Select the Browse button to choose a different location and name.") - - + + - + Please take special care to *note your destination*. Otherwise, you won't be able to find your new video. You can move it later if you desire. @@ -131,23 +131,23 @@ Select the `Start` button on the toolbar to make your new video. HandBrake will report its progress while it's working and alert you when it's finished. Then you will have a new video file at the `Destination` you specified. - + - - + + ![Encode progress](../../images/mac/encode-progress-1.0.0.png "HandBrake reports its progress during encoding.") ![Encoding complete alert](../../images/mac/encode-complete-1.0.0.png "HandBrake shows an alert when finished encoding.") - - + + - + Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices. diff --git a/source/docs/en/1.0.0/technical/audio-quality.markdown b/source/docs/en/1.0.0/technical/audio-quality.markdown index 16dcbe9e..5a1ce4b4 100644 --- a/source/docs/en/1.0.0/technical/audio-quality.markdown +++ b/source/docs/en/1.0.0/technical/audio-quality.markdown @@ -21,11 +21,11 @@ The Audio Tracks quality settings are controlled via the "Audio" tab on the main Each track can be configured to suit your needs. - + ![HandBrake's Audio Track Settings](../../images/windows/audio-quality-1.0.0.png "HandBrake's Audio Track Settings") - + There are several different modes HandBrake can operate in. diff --git a/source/docs/en/1.0.0/technical/frame-rates.markdown b/source/docs/en/1.0.0/technical/frame-rates.markdown index 9b595250..8a1100b1 100644 --- a/source/docs/en/1.0.0/technical/frame-rates.markdown +++ b/source/docs/en/1.0.0/technical/frame-rates.markdown @@ -19,11 +19,11 @@ Frame rate A video's frame rate is how many still pictures are displayed per second. Common frame rates are 23.976/24 for film, 25/50 for European broadcast standards, and 29.97/59.94 or 30/60 for North American broadcast standards. Modern video formats can be variable frame rate, switching between different frame rates on the fly, e.g. from 23.976 film to 29.97 NTSC and back. - + ![Frame rate controls on Mac](../../images/mac/frame-rate-controls-1.0.0.png "HandBrake's frame rate controls.") - + Selecting `Same as Source` allows you to select `Variable Frame Rate (VFR)`, which instructs HandBrake to make your new video's frame rate an exact copy of your `Source` frame rate. No frame rate conversion is performed. diff --git a/source/docs/en/1.0.0/technical/system-requirements.markdown b/source/docs/en/1.0.0/technical/system-requirements.markdown index 4ebf10d6..9da9d7b5 100644 --- a/source/docs/en/1.0.0/technical/system-requirements.markdown +++ b/source/docs/en/1.0.0/technical/system-requirements.markdown @@ -21,7 +21,7 @@ System requirements The following is the minimum level of hardware that HandBrake supports. While it may be technically possible to run HandBrake on hardware older than this, it is neither recommended nor supported. - + ### Linux @@ -35,9 +35,9 @@ The following is the minimum level of hardware that HandBrake supports. While it - 50 MB for the HandBrake app - 2 GB or more recommended for processing and storing your new videos - + - + ### Mac @@ -53,9 +53,9 @@ The following is the minimum level of hardware that HandBrake supports. While it - 50 MB for the HandBrake app - 2 GB or more recommended for processing and storing your new videos - + - + ### Windows @@ -71,13 +71,13 @@ The following is the minimum level of hardware that HandBrake supports. While it - Intel QuickSync requires a 2nd generation or newer Intel Core Ix Series processor with integrated Intel HD Graphics enabled and a directly connected display - OpenCL scaling is experimental and requires an AMD or Intel GPU with OpenCL 1.2 or later - + HandBrake's QuickSync and OpenCL features are only supported on Windows. ## Software - + ### Linux @@ -90,16 +90,16 @@ Several major versions are supported, see [Where to get HandBrake](../get-handbr For any other distribution, you must [compile from source](../developer/build-linux.html). - - + + ### Mac - OS X 10.7 Lion or later - [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing MKV (Matroska) media files - - + + ### Windows @@ -107,4 +107,4 @@ For any other distribution, you must [compile from source](../developer/build-li - Microsoft .NET Framework 4.6 or later - [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing media files - + diff --git a/source/docs/en/1.0.0/technical/video-angles.markdown b/source/docs/en/1.0.0/technical/video-angles.markdown index 1a46e0d0..e1b8c762 100644 --- a/source/docs/en/1.0.0/technical/video-angles.markdown +++ b/source/docs/en/1.0.0/technical/video-angles.markdown @@ -25,8 +25,8 @@ Under the source section, you will see a dropdown with the label "Angle" if your You can choose which angle to encode to your output file. HandBrake does not currently support multi-angle output. - + ![Frame rate controls on Windows](../../images/windows/point-to-point-1.0.0.png "HandBrake's Angle Control.") - + diff --git a/source/docs/en/1.0.0/technical/video-encoding-performance.markdown b/source/docs/en/1.0.0/technical/video-encoding-performance.markdown index 582fd83b..b874d9ad 100644 --- a/source/docs/en/1.0.0/technical/video-encoding-performance.markdown +++ b/source/docs/en/1.0.0/technical/video-encoding-performance.markdown @@ -43,20 +43,20 @@ Settings play a large part in encoding performance. Most of the encoders expose For x264 and x265, the Medium preset is a good trade off between quality, file size and speed but you can adjust this slider to suit your needs. - + ![HandBrake's Video Quality Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Quality Settings") - + Filters are another thing that has a big effect. Particularly if you use Denoise NLMeans. This is a very memory intensive operation so can drastically slow your encodes down. Again, there are settings for the filters that tune them for speed vs quality so you can see widely different results depending on what preset / tune you use. - + ![HandBrake's Video Filter Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Filter Settings") - + ### Source diff --git a/source/docs/en/1.0.0/workflow/adjust-quality.markdown b/source/docs/en/1.0.0/workflow/adjust-quality.markdown index 32958cd6..e7e7be12 100644 --- a/source/docs/en/1.0.0/workflow/adjust-quality.markdown +++ b/source/docs/en/1.0.0/workflow/adjust-quality.markdown @@ -27,11 +27,11 @@ Most of HandBrake's official `Presets` use the x264 video encoder and a constant To increase video quality, adjust the quality control toward the right. To reduce video quality, adjust the quality control toward the left. - + ![Using the constant quality control](../../images/mac/quality-control-1.0.0.png "Adjust the quality control toward the right to increase quality, or toward the left to lower it.") - + Begin by making small adjustments. Plus or minus 1-2 RF is usually noticeable. diff --git a/source/docs/en/1.0.0/workflow/open-video-source.markdown b/source/docs/en/1.0.0/workflow/open-video-source.markdown index e5945a15..bad50eb1 100644 --- a/source/docs/en/1.0.0/workflow/open-video-source.markdown +++ b/source/docs/en/1.0.0/workflow/open-video-source.markdown @@ -38,81 +38,81 @@ You can learn more about [Source formats](../technical/source-formats.html) in t By default, HandBrake presents the `Open Source` dialog on launch. It is also accessible from the `Toolbar` at the top of HandBrake's main window. - + - - + + ![Main window toolbar](../../images/mac/toolbar-1.0.0.png "The Toolbar provides easy access to HandBrake's most common functions.") ![Open Source button](../../images/mac/open-source-button-1.0.0.png "The Open Source button opens the Open Source dialog.") - - + + - + Select the `Open Source` button to select the video you want to open. You can also drag and drop a video `Source` onto HandBrake's main window. - + - - + + ![Open Source dialog](../../images/mac/open-source-dialog-1.0.0.png "The Open Source dialog allows you to browse your files for a video to open.") ![Opening a video source via drag and drop](../../images/mac/open-source-drag-drop-1.0.0.png "In addition to the Open Source dialog, you may also open a video by dragging it to HandBrake's main window.") - - + + - + HandBrake will scan your selection and after a few moments, the main window will show the file name of the `Source` you opened along with some additional information. - + - - + + ![Successfully opened source](../../images/mac/open-source-success-1.0.0.png "HandBrake's main window after sucessfully opening a source.") - - + + - + Some `Sources` may contain more than one video clip, or a collection of `Titles`. Blu-ray and DVD `Sources` often have multiple `Titles`. Use HandBrake's `Title` control to select which video clip you want to use. - + - - + + ![Selecting a title](../../images/mac/title-selection-1.0.0.png "Some sources may contain more than one video clip. The title control lets you select which video clip you want to use.") - - + + - + Great! At this point, HandBrake knows which video you want to use. diff --git a/source/docs/en/1.0.0/workflow/preview-settings.markdown b/source/docs/en/1.0.0/workflow/preview-settings.markdown index 96375166..f9821bc8 100644 --- a/source/docs/en/1.0.0/workflow/preview-settings.markdown +++ b/source/docs/en/1.0.0/workflow/preview-settings.markdown @@ -25,13 +25,13 @@ HandBrake's `Preview` feature allows you to perform a test run on a small portio At the top of HandBrake's main window, you'll see a toolbar with various buttons. - + ![Main window toolbar](../../images/mac/toolbar-1.0.0.png "The Toolbar provides easy access to HandBrake's most common functions.") ![Opening the Preview window](../../images/mac/preview-button-1.0.0.png "The Preview button opens a window where you can test your settings.") - + Select the `Preview` button to open the `Preview` window. @@ -39,13 +39,13 @@ Select the `Preview` button to open the `Preview` window. Move your mouse cursor over the `Preview` window, and some controls will appear. - + ![Preview window](../../images/mac/preview-window-1.0.0.jpg "HandBrake's Preview feature lets you test your settings on a small portion of your Source.") ![Preview controls](../../images/mac/preview-controls-1.0.0.png "You can set the starting position and duration of your Preview.") - + Set the starting position by dragging the `Position` control left or right, and choose how many seconds of video you want to encode using the `Duration` control. @@ -53,21 +53,21 @@ Set the starting position by dragging the `Position` control left or right, and When you're satisfied with your starting position and duration, select `Live Preview` and be patient. HandBrake will report its progress while it works. - + ![Preview progress indicator](../../images/mac/preview-progress-1.0.0.png "HandBrake will report its progress while encoding your Preview.") ![Preview playback controls](../../images/mac/preview-controls-playback-1.0.0.png "Playback controls allow you to interact with your Preview when it's ready.") - + When your `Preview` is ready, the controls are updated to let you play, pause, and rewind your video. You can also adjust the audio volume, and in some cases, choose which audio track plays. - + To create a new `Preview`, select the `╳` button to start over. - + When you're finished previewing your work, you may close the `Preview` window. diff --git a/source/docs/en/1.0.0/workflow/select-preset.markdown b/source/docs/en/1.0.0/workflow/select-preset.markdown index 34cab644..ab5b93b3 100644 --- a/source/docs/en/1.0.0/workflow/select-preset.markdown +++ b/source/docs/en/1.0.0/workflow/select-preset.markdown @@ -25,21 +25,21 @@ HandBrake includes a number of official `Presets` for specific devices and for g Once you've opened a `Source`, select the `Preset` that most closely describes the device you want your videos to work on. For instance, if you want to play your videos on a Roku that supports 1080p High Definition, choose the `Roku 1080p30 Surround` preset under `Devices`. See the technical documentation for more information about [official presets](../technical/official-presets.html). - + - - + + ![Selecting a preset](../../images/mac/preset-selection-1.0.0.png "Presets are one-click settings to save you time and help ensure compatibility with your devices.") - - + + - + If your device is not listed, or you wish to play your videos on a computer, the default `Fast 1080p30` preset is a good choice. It's fast and compatible across a wide range of software and devices. diff --git a/source/docs/en/1.0.0/workflow/start-encoding.markdown b/source/docs/en/1.0.0/workflow/start-encoding.markdown index a67ede34..25e06681 100644 --- a/source/docs/en/1.0.0/workflow/start-encoding.markdown +++ b/source/docs/en/1.0.0/workflow/start-encoding.markdown @@ -23,13 +23,13 @@ Now that you've got all your settings just right, it's time to make your new vid `Destination` is where your new video will go. You can select the `Browse...` button to choose a new location and name, or type it directly in the box. - + ![Selecting a destination](../../images/mac/destination-field-1.0.0.png "Destination is where HandBrake will put your new video.") ![Browsing for a destination](../../images/mac/destination-dialog-1.0.0.png "Select the Browse button to choose a different location and name.") - + Please take special care to *note your destination*. Otherwise, you won't be able to find your new video. You can move it later if you desire. @@ -37,31 +37,31 @@ Please take special care to *note your destination*. Otherwise, you won't be abl Select the `Start` button on the toolbar to make your new video. - + ![Main window toolbar](../../images/mac/toolbar-1.0.0.png "The Toolbar provides easy access to HandBrake's most common functions.") ![Starting an encode](../../images/mac/start-button-1.0.0.png "The Start button begins encoding your new video.") - + Video encoding requires a lot of computer resources and can take awhile to complete. Some videos may take minutes to create; others may take hours.[^encoding-time] - + ![Encode progress](../../images/mac/encode-progress-1.0.0.png "HandBrake reports its progress during encoding.") ![Encoding complete alert](../../images/mac/encode-complete-1.0.0.png "HandBrake shows an alert when finished encoding.") - + HandBrake will report its progress while it's working and alert you when it's finished. Then you will have a new video file at the `Destination` you specified. - + ![Destination in Finder](../../images/mac/destination-finder-1.0.0.png "Your new video is located at the Destination you specified.") - + Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices. diff --git a/source/docs/en/1.1.0/advanced/queue.markdown b/source/docs/en/1.1.0/advanced/queue.markdown index 7b97264a..a75326d5 100644 --- a/source/docs/en/1.1.0/advanced/queue.markdown +++ b/source/docs/en/1.1.0/advanced/queue.markdown @@ -24,33 +24,33 @@ Luckily, you can set up multiple encodes at once by adding them to HandBrake's ` Begin by [opening a Source, selecting a Title](../workflow/open-video-source.html), and [selecting a Preset](../workflow/select-preset.html). Then select the `Add to Queue` button on the toolbar. - + ![Adding an encode to the Queue](../../images/mac/add-to-queue-button-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - + Select the `Show Queue` button on the toolbar to see the queued encodes, or `Jobs`. - + ![Opening the Queue window](../../images/mac/queue-button-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") ![Queue window on Mac](../../images/mac/queue-1.0.0.png "The Queue window lists pending Jobs.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") ![Queue window on Windows](../../images/windows/queue-1.0.0.png "The Queue window lists pending Jobs.") - + You may open additional `Sources` and add them to the `Queue` in the same manner. @@ -58,7 +58,7 @@ You may open additional `Sources` and add them to the `Queue` in the same manner When using the `Queue`, you may find it beneficial to create multiple `Jobs` at one time. - + On Mac, first open the `Preferences` window using the `HandBrake` menu. In the `General` section, ensure that the `Automatically name output files` setting is selected and `Title` is part of the `Format` field. @@ -68,8 +68,8 @@ On Mac, first open the `Preferences` window using the `HandBrake` menu. In the ` This ensures that each of your `Jobs` will be given a unique file name, and not overwrite each other. - - + + On Windows, first open the `Preferences` window using the `Tools` menu. In the `Output Files` section, ensure that the `Automatically name output files` setting is selected. Set a `Default Path` (where your new videos will be created) and make sure `Title` is part of the `File Format` field. @@ -79,25 +79,25 @@ On Windows, first open the `Preferences` window using the `Tools` menu. In the ` This ensures that each of your `Jobs` will be given a unique file name, and not overwrite each other. - + If your `Source` is a Blu-ray, DVD, or other disc or disc-like format with multiple `Titles`, you may open it with HandBrake and add multiple `Titles` to the `Queue` simultaneously. Additionally, you may open a folder of multiple single-`Title` videos (excluding discs and disc-like formats) as one virtual `Source` with multiple `Titles` using the `Open Source` dialog, and then add multiple `Titles` to the `Queue`[^batch-scan-subdirectories]. - + ![Opening a folder containing multiple video Sources](../../images/mac/open-source-dialog-folder-1.0.0.png "The Open Source dialog allows you to select a folder containing multiple video files.") ![Selecting a Title](../../images/mac/title-selection-1.1.0.png "The Title control lets you select which video clip you want to use.") - - + + On Linux, select `Add Multiple` from the `Queue` menu, then select the `Titles` you wish to encode using the presented dialog. Be sure to give each a unique file name. - - + + On Mac, select `Add Titles to Queue...` from the `File` menu, then select the `Titles` you wish to encode using the presented dialog. @@ -105,12 +105,12 @@ On Mac, select `Add Titles to Queue...` from the `File` menu, then select the `T ![Selecting multiple Titles to add to the Queue](../../images/mac/add-titles-to-queue-1.0.0.png "Select the Titles you wish to encode from the Add Titles to Queue dialog.") - - + + On Windows, select `All Selection to Queue` from the `Queue` menu to add all `Titles`. - + You may open additional `Sources` and add them to the `Queue` in the same manner. @@ -118,60 +118,60 @@ You may open additional `Sources` and add them to the `Queue` in the same manner To make changes to `Jobs` in the `Queue`, first open the `Queue` window by selecting the `Show Queue` button on the toolbar. - + ![Opening the Queue window](../../images/mac/queue-button-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") - + To remove a `Job`, select the `╳` button next to the unwanted `Job`. - + On Linux, if you want to make changes to a `Job` already in the `Queue`, select the `Job` and then select `Edit`. Editing a `Job` opens the `Source` in HandBrake's main window and removes the `Job` from the `Queue`. - - + + On Mac, if you want to make changes to a `Job` already in the `Queue`, control- or right-click on the `Job` and select `Edit`. Editing a `Job` opens the `Source` in HandBrake's main window and removes the `Job` from the `Queue`. ![Editing an encode Job on Mac](../../images/mac/queue-edit-1.0.0.png "Control- or right-click the Job and select Edit to make changes.") - - + + On Windows, if you want to make changes to a `Job` already in the `Queue`, select the edit button next to the `Job`. Editing a `Job` opens the `Source` in HandBrake's main window and removes the `Job` from the `Queue`. ![Editing an encode Job on Windows](../../images/windows/queue-1.0.0.png "Select the edit button, which looks like a sheet of paper, to make changes to a Job.") - + When you're finished making changes, again add the encode to the `Queue` by selecting the `Add to Queue` button on the toolbar. - + ![Adding an encode to the Queue](../../images/mac/add-to-queue-button-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - + ## Starting the Queue When ready, select the `Start` button on the`Queue` window or the `Start Queue` button on the main window to begin encoding the `Jobs` in the `Queue`. - + ![Starting the Queue](../../images/mac/start-queue-button-1.0.0.png "The Start Queue button begins encoding the Jobs in the Queue.") - + [^batch-scan-subdirectories]: When opening multiple videos in a folder, HandBrake ignores any additional folders inside. Make sure the videos you wish to open are at the top level of the selected folder. diff --git a/source/docs/en/1.1.0/get-handbrake/check-for-updates.markdown b/source/docs/en/1.1.0/get-handbrake/check-for-updates.markdown index f1ba5ed6..ee3bc46a 100644 --- a/source/docs/en/1.1.0/get-handbrake/check-for-updates.markdown +++ b/source/docs/en/1.1.0/get-handbrake/check-for-updates.markdown @@ -20,14 +20,14 @@ HandBrake can let you know when a newer version is available, and even automatic Before updating, please make sure there are no pending encodes in the `Queue`. If you are currently using HandBrake older than version 1.0.0, also make note of any custom `Presets` you have created, as they may not be compatible with newer versions. - + ## Updating HandBrake on Linux The Linux version of HandBrake does not have a built-in update checking feature. Your Linux distribution's package manager will handle any updates to the official PPA. - - + + ## Updating HandBrake on Mac @@ -41,8 +41,8 @@ Manually checking for updates is easy. Using the main menu at the top of your sc ![Software update dialog](../../images/mac/software-update-1.1.0.png "If an update is available, HandBrake will offer to install it for you.") - - + + ## Updating HandBrake on Windows @@ -50,7 +50,7 @@ Automatic update checking may be enabled or disabled in HandBrake's preferences. Manually checking for updates is easy. From the `Help` menu, select `Check for Updates...`. If an update is available, HandBrake will offer to install it for you. - + diff --git a/source/docs/en/1.1.0/get-handbrake/download-and-install.markdown b/source/docs/en/1.1.0/get-handbrake/download-and-install.markdown index 4fe97b68..4f6e021f 100644 --- a/source/docs/en/1.1.0/get-handbrake/download-and-install.markdown +++ b/source/docs/en/1.1.0/get-handbrake/download-and-install.markdown @@ -34,15 +34,15 @@ Experienced users may wish to try HandBrake's [nightly builds](https://handbrake The HandBrake Team publishes [checksums for all downloads on handbrake.fr](https://handbrake.fr/checksums.php) and the [Checksums article on GitHub](https://github.com/HandBrake/HandBrake/wiki/Checksums). You may use the provided checksums to verify the integrity of the files you download. - + When installing on Linux using the official PPA, download integrity is verified automatically. Similarly, the integrity of source code managed using `git` is verified automatically. To verify an official source distribution tarball, consult your Linux distribution's documentation for instructions on how to verify checksums. - + - + On Mac, launch Terminal from your Applications > Utilities folder and use the `shasum` command. For example, if you downloaded HandBrake 1.0.0 to your Downloads folder: @@ -50,15 +50,15 @@ On Mac, launch Terminal from your Applications > Utilities folder and use the `s Alternatively, the free third-party app [Hashsum](https://itunes.apple.com/us/app/hashsum/id1079442694?mt=12) available on the Mac App Store provides a convenient graphical interface for computing file checksums[^third-party-utilities-1]. - + - + On Windows, Microsoft provides the [Microsoft File Checksum Integrity Verifier](https://www.microsoft.com/en-us/download/details.aspx?id=11533) command line utility for verifying checksums. Please see the [associated Microsoft help article](https://support.microsoft.com/en-us/help/841290/availability-and-description-of-the-file-checksum-integrity-verifier-utility) for more information and usage instructions. Alternatively, free third-party apps [Compute Hash](http://www.subisoft.net/ComputeHash.aspx), [ExactFile](http://www.exactfile.com), and [MultiHasher](http://www.abelhadigital.com/multihasher) for Windows provide convenient graphical interfaces for computing file checksums[^third-party-utilities-2]. - + *If the checksums for the file you downloaded do not match the ones published by the HandBrake Team, you should delete the file and try your download again.* @@ -66,7 +66,7 @@ Alternatively, free third-party apps [Compute Hash](http://www.subisoft.net/Comp The HandBrake Team also publishes [OpenPGP signatures for all downloads on GitHub](https://github.com/HandBrake/HandBrake/releases). More information is available on the [OpenPGP article on GitHub](https://github.com/HandBrake/HandBrake/wiki/OpenPGP). - + ## Installing on Linux @@ -92,8 +92,8 @@ Run `HandBrakeCLI` to use HandBrake on the command line. Run `ghb` to launch HandBrake's graphical user interface. You may wish to right-click on the icon and select "Lock to Launcher" for easy access in the future. - - + + ## Installing on Mac @@ -105,8 +105,8 @@ Once you've downloaded HandBrake for Mac, open the disk image in your Downloads HandBrake is now installed. You may eject the disk image and move it to the Trash. - - + + ## Installing on Windows @@ -126,7 +126,7 @@ Next, the installer will ask you where you wish to install HandBrake. Unless you You will find shortcuts for launching HandBrake placed on both the Windows Desktop and Start Menu. - + ## Launching HandBrake diff --git a/source/docs/en/1.1.0/get-handbrake/where-to-get-handbrake.markdown b/source/docs/en/1.1.0/get-handbrake/where-to-get-handbrake.markdown index f9b8006f..2c763bb1 100644 --- a/source/docs/en/1.1.0/get-handbrake/where-to-get-handbrake.markdown +++ b/source/docs/en/1.1.0/get-handbrake/where-to-get-handbrake.markdown @@ -22,11 +22,11 @@ Official [HandBrake releases](https://handbrake.fr/downloads.php) and [nightly b HandBrake is open-source software licensed under the GNU General Public License Version 2 (GPLv2)[^license]. Anyone can download and use HandBrake *for free*. - + Ubuntu Linux users should install the [official release PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases) or the [official snapshots PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-git-snapshots). 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. - + HandBrake source code is available at the official [HandBrake repository on GitHub](https://github.com/HandBrake/HandBrake). @@ -40,7 +40,7 @@ Beware of third-party websites and peer-to-peer downloads of HandBrake. They may Beware of online marketplaces and auction sites. HandBrake is *free software*. - + ## Warning about broken third-party builds @@ -62,7 +62,7 @@ BSD users should compile from the [official source code](https://github.com/Hand Linux users should install the [official release PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases), install the [official snapshots PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases), or compile from the [official source code](https://github.com/HandBrake/HandBrake). - + diff --git a/source/docs/en/1.1.0/help/activity-log.markdown b/source/docs/en/1.1.0/help/activity-log.markdown index 36f2ffb3..7a3d9d46 100644 --- a/source/docs/en/1.1.0/help/activity-log.markdown +++ b/source/docs/en/1.1.0/help/activity-log.markdown @@ -98,7 +98,7 @@ Activity Logs may also be pasted directly into [new support requests on GitHub]( **Note:** When scanning a new source during encoding, log messages from the scan may be intermixed with log messages from your currently running encode. - + ### Activity Logs on Linux @@ -115,8 +115,8 @@ Inside, you may find the following files: - `Activity.log.ProcessID`, where `ProcessID` is the process identifier given to HandBrake by Linux, contains information about the specific app session - Log files for individual encodes are located in the `EncodeLogs` subdirectory and named according to the pattern `Videoname Date Time.txt`; encode logs are retained until deleted manually - - + + ### Activity Logs on Mac @@ -133,8 +133,8 @@ Inside, you may find the following files: - `HandBrake-activitylog.txt` is overwritten each time HandBrake starts, and contains information about the latest app session - Log files for individual encodes are named according to the pattern `Videoname Date Time.txt` and are retained until deleted manually - - + + ### Activity Logs on Windows @@ -152,7 +152,7 @@ Inside, you may find the following files: - `activity_logProcessID.txt`, where `ProcessID` is the process identifier given to HandBrake by Windows, contains information about the specific app session - Log files for individual encodes are named according to the pattern `Videoname Date Time.txt` and are retained until deleted manually - + ### Activity Logs on the command line diff --git a/source/docs/en/1.1.0/introduction/quick-start.markdown b/source/docs/en/1.1.0/introduction/quick-start.markdown index 3717da2f..e30401be 100644 --- a/source/docs/en/1.1.0/introduction/quick-start.markdown +++ b/source/docs/en/1.1.0/introduction/quick-start.markdown @@ -34,43 +34,43 @@ HandBrake calls the video you already have the `Source`. Select the `Open Source` button on the toolbar to browse your files for a video to open. You may also drag your `Source` video onto HandBrake's main window. - + - - + + ![Browsing for a video source to open](../../images/mac/open-source-dialog-1.1.0.png "The Open Source dialog allows you to browse your files for a video to open.") ![Opening a video source via drag and drop](../../images/mac/open-source-drag-drop-1.1.0.png "In addition to the Open Source dialog, you may also open a video by dragging it to HandBrake's main window.") - - + + - + ## Select a title Some `Sources` may contain more than one video clip, or a collection of `Titles`. Use HandBrake's `Title` control to select which video clip you want to use. - + - - + + ![Selecting a title](../../images/mac/title-selection-1.1.0.png "Some sources may contain more than one video clip. The title control lets you select which video clip you want to use.") - - + + - + Some `Sources` have only one `Title`. Blu-ray and DVD `Sources` often have multiple `Titles`. @@ -80,21 +80,21 @@ HandBrake provides a number of settings `Presets` to make your new video work we The default `Fast 1080p30` preset is often a good choice because it's fast and compatible with most devices. - + - - + + ![Selecting a preset](../../images/mac/preset-selection-1.1.0.png "Presets are one-click settings to save you time and help ensure compatibility with your devices.") - - + + - + `Presets` can affect compatibility (whether your video will work with your devices and software) and encoding time. Learn more about [Selecting a preset](../workflow/select-preset.html). @@ -106,21 +106,21 @@ HandBrake calls the file name and location of your new video the `Destination`. `To` is the location where HandBrake will place your new video. You can select the `Browse...` button to choose a different location. - + - - + + ![Selecting a destination](../../images/mac/destination-field-1.1.0.png "The Destination is where HandBrake will place your new video.") - - + + - + Please take special care to *note your destination*. Otherwise, you won't be able to find your new video. You can move it later if you desire. @@ -128,31 +128,31 @@ Please take special care to *note your destination*. Otherwise, you won't be abl Select the `Start` button on the toolbar to make your new video. - + - - + + ![Encode progress](../../images/mac/encode-progress-1.1.0.png "HandBrake reports its progress during encoding.") ![Encoding complete alert](../../images/mac/encode-complete-1.1.0.png "HandBrake shows a notification when finished encoding.") - + HandBrake will report its progress while it's working and alert you when it's finished. Then you will have a new video file at the `Destination` you specified. - + ![Destination in Finder](../../images/mac/destination-finder-1.1.0.png "Your new video is located at the Destination you specified.") - - + + - + Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices. diff --git a/source/docs/en/1.1.0/technical/audio-quality.markdown b/source/docs/en/1.1.0/technical/audio-quality.markdown index 290dcbe7..0ad1408a 100644 --- a/source/docs/en/1.1.0/technical/audio-quality.markdown +++ b/source/docs/en/1.1.0/technical/audio-quality.markdown @@ -21,11 +21,11 @@ The Audio Tracks quality settings are controlled via the "Audio" tab on the main Each track can be configured to suit your needs. - + ![HandBrake's Audio Track Settings](../../images/windows/audio-quality-1.0.0.png "HandBrake's Audio Track Settings") - + There are several different modes HandBrake can operate in. diff --git a/source/docs/en/1.1.0/technical/frame-rates.markdown b/source/docs/en/1.1.0/technical/frame-rates.markdown index f2c61ff9..919a6c46 100644 --- a/source/docs/en/1.1.0/technical/frame-rates.markdown +++ b/source/docs/en/1.1.0/technical/frame-rates.markdown @@ -19,11 +19,11 @@ Frame rate A video's frame rate is how many still pictures are displayed per second. Common frame rates are 23.976/24 for film, 25/50 for European broadcast standards, and 29.97/59.94 or 30/60 for North American broadcast standards. Modern video formats can be variable frame rate, switching between different frame rates on the fly, e.g. from 23.976 film to 29.97 NTSC and back. - + ![Frame rate controls on Mac](../../images/mac/frame-rate-controls-1.0.0.png "HandBrake's frame rate controls.") - + Selecting `Same as Source` allows you to select `Variable Frame Rate (VFR)`, which instructs HandBrake to make your new video's frame rate an exact copy of your `Source` frame rate. No frame rate conversion is performed. diff --git a/source/docs/en/1.1.0/technical/system-requirements.markdown b/source/docs/en/1.1.0/technical/system-requirements.markdown index 6af18421..8fa2167b 100644 --- a/source/docs/en/1.1.0/technical/system-requirements.markdown +++ b/source/docs/en/1.1.0/technical/system-requirements.markdown @@ -20,7 +20,7 @@ System requirements The following is the minimum level of hardware that HandBrake supports. While it may be technically possible to run HandBrake on hardware older than this, it is neither recommended nor supported. - + ### Linux @@ -34,9 +34,9 @@ The following is the minimum level of hardware that HandBrake supports. While it - 50 MB for the HandBrake app - 2 GB or more recommended for processing and storing your new videos - + - + ### Mac @@ -52,9 +52,9 @@ The following is the minimum level of hardware that HandBrake supports. While it - 50 MB for the HandBrake app - 2 GB or more recommended for processing and storing your new videos - + - + ### Windows @@ -68,13 +68,13 @@ The following is the minimum level of hardware that HandBrake supports. While it - 50 MB for the HandBrake app - 2 GB or more recommended for processing and storing your new videos - + HandBrake's QuickSync feature is only supported on Linux (experimental) and Windows. QuickSync requires a 2nd generation (Sandy Bridge) or newer Intel Core series processor with integrated Intel HD Graphics enabled and a directly connected display[^display-emulator-adapter]. ## Software - + ### Linux @@ -87,16 +87,16 @@ Several major versions are supported, see [Where to get HandBrake](../get-handbr For any other distribution, you must [compile from source](../developer/build-linux.html). - - + + ### Mac - OS X 10.7 Lion or later - [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing MKV (Matroska) media files - - + + ### Windows @@ -104,6 +104,6 @@ For any other distribution, you must [compile from source](../developer/build-li - Microsoft .NET Framework 4.6 or later - [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing media files - + [^display-emulator-adapter]: In lieu of a physically connected display, a display emulator adapter such as [Headless Ghost](https://www.headlessghost.com/) will enable GPU functions such as QuickSync when connected to the Intel HD Graphics output port. \ No newline at end of file diff --git a/source/docs/en/1.1.0/technical/video-angles.markdown b/source/docs/en/1.1.0/technical/video-angles.markdown index 56f1916a..c852b346 100644 --- a/source/docs/en/1.1.0/technical/video-angles.markdown +++ b/source/docs/en/1.1.0/technical/video-angles.markdown @@ -25,8 +25,8 @@ Under the source section, you will see a dropdown with the label "Angle" if your You can choose which angle to encode to your output file. HandBrake does not currently support multi-angle output. - + ![Frame rate controls on Windows](../../images/windows/point-to-point-1.0.0.png "HandBrake's Angle Control.") - + diff --git a/source/docs/en/1.1.0/technical/video-encoding-performance.markdown b/source/docs/en/1.1.0/technical/video-encoding-performance.markdown index 019918a9..59e4d008 100644 --- a/source/docs/en/1.1.0/technical/video-encoding-performance.markdown +++ b/source/docs/en/1.1.0/technical/video-encoding-performance.markdown @@ -43,20 +43,20 @@ Settings play a large part in encoding performance. Most of the encoders expose For x264 and x265, the Medium preset is a good trade off between quality, file size and speed but you can adjust this slider to suit your needs. - + ![HandBrake's Video Quality Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Quality Settings") - + Filters are another thing that has a big effect. Particularly if you use Denoise NLMeans. This is a very memory intensive operation so can drastically slow your encodes down. Again, there are settings for the filters that tune them for speed vs quality so you can see widely different results depending on what preset / tune you use. - + ![HandBrake's Video Filter Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Filter Settings") - + ### Source diff --git a/source/docs/en/1.1.0/workflow/adjust-quality.markdown b/source/docs/en/1.1.0/workflow/adjust-quality.markdown index 3ecc4096..006e6891 100644 --- a/source/docs/en/1.1.0/workflow/adjust-quality.markdown +++ b/source/docs/en/1.1.0/workflow/adjust-quality.markdown @@ -26,11 +26,11 @@ Most of HandBrake's official `Presets` use the x264 video encoder and a constant To increase video quality, adjust the quality control toward the right. To reduce video quality, adjust the quality control toward the left. - + ![Using the constant quality control](../../images/mac/quality-control-1.1.0.png "Adjust the quality control toward the right to increase quality, or toward the left to lower it.") - + Begin by making small adjustments. Plus or minus 1-2 RF is usually noticeable. diff --git a/source/docs/en/1.1.0/workflow/open-video-source.markdown b/source/docs/en/1.1.0/workflow/open-video-source.markdown index 20f87518..e90c4969 100644 --- a/source/docs/en/1.1.0/workflow/open-video-source.markdown +++ b/source/docs/en/1.1.0/workflow/open-video-source.markdown @@ -37,79 +37,79 @@ You can learn more about [Source formats](../technical/source-formats.html) in t By default, HandBrake presents the `Open Source` dialog on launch. It is also accessible from the `Toolbar` at the top of HandBrake's main window. - + - - + + ![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.") - - + + - + Select the `Open Source` button to select the video you want to open. You can also drag and drop a video `Source` onto HandBrake's main window. - + - - + + ![Open Source dialog](../../images/mac/open-source-dialog-1.1.0.png "The Open Source dialog allows you to browse your files for a video to open.") ![Opening a video source via drag and drop](../../images/mac/open-source-drag-drop-1.1.0.png "In addition to the Open Source dialog, you may also open a video by dragging it to HandBrake's main window.") - - + + - + HandBrake will scan your selection and after a few moments, the main window will show the file name of the `Source` you opened along with some additional information. - + - - + + ![Successfully opened source](../../images/mac/open-source-success-1.1.0.png "HandBrake's main window after sucessfully opening a source.") - - + + - + Some `Sources` may contain more than one video clip, or a collection of `Titles`. Blu-ray and DVD `Sources` often have multiple `Titles`. Use HandBrake's `Title` control to select which video clip you want to use. - + - - + + ![Selecting a title](../../images/mac/title-selection-1.1.0.png "Some sources may contain more than one video clip. The title control lets you select which video clip you want to use.") - - + + - + Great! At this point, HandBrake knows which video you want to use. diff --git a/source/docs/en/1.1.0/workflow/preview-settings.markdown b/source/docs/en/1.1.0/workflow/preview-settings.markdown index c9762f39..130fa1eb 100644 --- a/source/docs/en/1.1.0/workflow/preview-settings.markdown +++ b/source/docs/en/1.1.0/workflow/preview-settings.markdown @@ -24,11 +24,11 @@ HandBrake's `Preview` feature allows you to perform a test run on a small portio At the top of HandBrake's main window, you'll see a toolbar with various buttons. - + ![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.") - + Select the `Preview` button to open the `Preview` window. @@ -36,13 +36,13 @@ Select the `Preview` button to open the `Preview` window. Move your mouse cursor over the `Preview` window, and some controls will appear. - + ![Preview window](../../images/mac/preview-window-1.1.0.jpg "HandBrake's Preview feature lets you test your settings on a small portion of your Source.") ![Preview controls](../../images/mac/preview-controls-1.1.0.png "You can set the starting position and duration of your Preview.") - + Set the starting position by dragging the `Position` control left or right, and choose how many seconds of video you want to encode using the `Duration` control. @@ -50,21 +50,21 @@ Set the starting position by dragging the `Position` control left or right, and When you're satisfied with your starting position and duration, select `Live Preview` and be patient. HandBrake will report its progress while it works. - + ![Preview progress indicator](../../images/mac/preview-progress-1.1.0.png "HandBrake will report its progress while encoding your Preview.") ![Preview playback controls](../../images/mac/preview-controls-playback-1.1.0.png "Playback controls allow you to interact with your Preview when it's ready.") - + When your `Preview` is ready, the controls are updated to let you play, pause, and rewind your video. You can also adjust the audio volume, and in some cases, choose which audio track plays. - + To create a new `Preview`, select the `╳` button to start over. - + When you're finished previewing your work, you may close the `Preview` window. diff --git a/source/docs/en/1.1.0/workflow/select-preset.markdown b/source/docs/en/1.1.0/workflow/select-preset.markdown index 17c8c075..293d2d7c 100644 --- a/source/docs/en/1.1.0/workflow/select-preset.markdown +++ b/source/docs/en/1.1.0/workflow/select-preset.markdown @@ -24,21 +24,21 @@ HandBrake includes a number of official `Presets` for specific devices and for g Once you've opened a `Source`, select the `Preset` that most closely describes the device you want your videos to work on. For instance, if you want to play your videos on a Roku that supports 1080p High Definition, choose the `Roku 1080p30 Surround` preset under `Devices`. See the technical documentation for more information about [official presets](../technical/official-presets.html). - + - - + + ![Selecting a preset](../../images/mac/preset-selection-1.1.0.png "Presets are one-click settings to save you time and help ensure compatibility with your devices.") - - + + - + If your device is not listed, or you wish to play your videos on a computer, the default `Fast 1080p30` preset is a good choice. It's fast and compatible across a wide range of software and devices. diff --git a/source/docs/en/1.1.0/workflow/start-encoding.markdown b/source/docs/en/1.1.0/workflow/start-encoding.markdown index eb87f154..985e58b2 100644 --- a/source/docs/en/1.1.0/workflow/start-encoding.markdown +++ b/source/docs/en/1.1.0/workflow/start-encoding.markdown @@ -26,11 +26,11 @@ HandBrake calls the file name and location of your new video the `Destination`. `To` is the location where HandBrake will place your new video. You can select the `Browse...` button to choose a different location. - + ![Selecting a destination](../../images/mac/destination-field-1.1.0.png "The Destination is where HandBrake will place your new video.") - + Please take special care to *note your destination*. Otherwise, you won't be able to find your new video. You can move it later if you desire. @@ -38,29 +38,29 @@ Please take special care to *note your destination*. Otherwise, you won't be abl Select the `Start` button on the toolbar to make your new video. - + ![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.") - + Video encoding requires a lot of computer resources and can take awhile to complete. Some videos may take minutes to create; others may take hours.[^encoding-time] - + ![Encode progress](../../images/mac/encode-progress-1.1.0.png "HandBrake reports its progress during encoding.") ![Encoding complete alert](../../images/mac/encode-complete-1.1.0.png "HandBrake shows a notification when finished encoding.") - + HandBrake will report its progress while it's working and alert you when it's finished. Then you will have a new video file at the `Destination` you specified. - + ![Destination in Finder](../../images/mac/destination-finder-1.1.0.png "Your new video is located at the Destination you specified.") - + Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices. diff --git a/source/docs/en/latest/advanced/queue.markdown b/source/docs/en/latest/advanced/queue.markdown index 4c5b0e58..98e116bf 100644 --- a/source/docs/en/latest/advanced/queue.markdown +++ b/source/docs/en/latest/advanced/queue.markdown @@ -24,33 +24,33 @@ Luckily, you can set up multiple encodes at once by adding them to HandBrake's ` Begin by [opening a Source, selecting a Title](../workflow/open-video-source.html), and [selecting a Preset](../workflow/select-preset.html). Then select the `Add to Queue` button on the toolbar. - + ![Adding an encode to the Queue](../../images/mac/add-to-queue-button-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - + Select the `Show Queue` button on the toolbar to see the queued encodes, or `Jobs`. - + ![Opening the Queue window](../../images/mac/queue-button-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") ![Queue window on Mac](../../images/mac/queue-1.0.0.png "The Queue window lists pending Jobs.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") ![Queue window on Windows](../../images/windows/queue-1.0.0.png "The Queue window lists pending Jobs.") - + You may open additional `Sources` and add them to the `Queue` in the same manner. @@ -58,7 +58,7 @@ You may open additional `Sources` and add them to the `Queue` in the same manner When using the `Queue`, you may find it beneficial to create multiple `Jobs` at one time. - + On Mac, first open the `Preferences` window using the `HandBrake` menu. In the `General` section, ensure that the `Automatically name output files` setting is selected and `Title` is part of the `Format` field. @@ -68,8 +68,8 @@ On Mac, first open the `Preferences` window using the `HandBrake` menu. In the ` This ensures that each of your `Jobs` will be given a unique file name, and not overwrite each other. - - + + On Windows, first open the `Preferences` window using the `Tools` menu. In the `Output Files` section, ensure that the `Automatically name output files` setting is selected. Set a `Default Path` (where your new videos will be created) and make sure `Title` is part of the `File Format` field. @@ -79,25 +79,25 @@ On Windows, first open the `Preferences` window using the `Tools` menu. In the ` This ensures that each of your `Jobs` will be given a unique file name, and not overwrite each other. - + If your `Source` is a Blu-ray, DVD, or other disc or disc-like format with multiple `Titles`, you may open it with HandBrake and add multiple `Titles` to the `Queue` simultaneously. Additionally, you may open a folder of multiple single-`Title` videos (excluding discs and disc-like formats) as one virtual `Source` with multiple `Titles` using the `Open Source` dialog, and then add multiple `Titles` to the `Queue`[^batch-scan-subdirectories]. - + ![Opening a folder containing multiple video Sources](../../images/mac/open-source-dialog-folder-1.0.0.png "The Open Source dialog allows you to select a folder containing multiple video files.") ![Selecting a Title](../../images/mac/title-selection-1.1.0.png "The Title control lets you select which video clip you want to use.") - - + + On Linux, select `Add Multiple` from the `Queue` menu, then select the `Titles` you wish to encode using the presented dialog. Be sure to give each a unique file name. - - + + On Mac, select `Add Titles to Queue...` from the `File` menu, then select the `Titles` you wish to encode using the presented dialog. @@ -105,12 +105,12 @@ On Mac, select `Add Titles to Queue...` from the `File` menu, then select the `T ![Selecting multiple Titles to add to the Queue](../../images/mac/add-titles-to-queue-1.0.0.png "Select the Titles you wish to encode from the Add Titles to Queue dialog.") - - + + On Windows, select `All Selection to Queue` from the `Queue` menu to add all `Titles`. - + You may open additional `Sources` and add them to the `Queue` in the same manner. @@ -118,60 +118,60 @@ You may open additional `Sources` and add them to the `Queue` in the same manner To make changes to `Jobs` in the `Queue`, first open the `Queue` window by selecting the `Show Queue` button on the toolbar. - + ![Opening the Queue window](../../images/mac/queue-button-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.") - + To remove a `Job`, select the `╳` button next to the unwanted `Job`. - + On Linux, if you want to make changes to a `Job` already in the `Queue`, select the `Job` and then select `Edit`. Editing a `Job` opens the `Source` in HandBrake's main window and removes the `Job` from the `Queue`. - - + + On Mac, if you want to make changes to a `Job` already in the `Queue`, control- or right-click on the `Job` and select `Edit`. Editing a `Job` opens the `Source` in HandBrake's main window and removes the `Job` from the `Queue`. ![Editing an encode Job on Mac](../../images/mac/queue-edit-1.0.0.png "Control- or right-click the Job and select Edit to make changes.") - - + + On Windows, if you want to make changes to a `Job` already in the `Queue`, select the edit button next to the `Job`. Editing a `Job` opens the `Source` in HandBrake's main window and removes the `Job` from the `Queue`. ![Editing an encode Job on Windows](../../images/windows/queue-1.0.0.png "Select the edit button, which looks like a sheet of paper, to make changes to a Job.") - + When you're finished making changes, again add the encode to the `Queue` by selecting the `Add to Queue` button on the toolbar. - + ![Adding an encode to the Queue](../../images/mac/add-to-queue-button-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - - + + ![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") - + ## Starting the Queue When ready, select the `Start` button on the`Queue` window or the `Start Queue` button on the main window to begin encoding the `Jobs` in the `Queue`. - + ![Starting the Queue](../../images/mac/start-queue-button-1.0.0.png "The Start Queue button begins encoding the Jobs in the Queue.") - + [^batch-scan-subdirectories]: When opening multiple videos in a folder, HandBrake ignores any additional folders inside. Make sure the videos you wish to open are at the top level of the selected folder. diff --git a/source/docs/en/latest/get-handbrake/check-for-updates.markdown b/source/docs/en/latest/get-handbrake/check-for-updates.markdown index 45f6bbda..fe94610b 100644 --- a/source/docs/en/latest/get-handbrake/check-for-updates.markdown +++ b/source/docs/en/latest/get-handbrake/check-for-updates.markdown @@ -20,14 +20,14 @@ HandBrake can let you know when a newer version is available, and even automatic Before updating, please make sure there are no pending encodes in the `Queue`. If you are currently using HandBrake older than version 1.0.0, also make note of any custom `Presets` you have created, as they may not be compatible with newer versions. - + ## Updating HandBrake on Linux The Linux version of HandBrake does not have a built-in update checking feature. Your Linux distribution's package manager will handle any updates to the official PPA. - - + + ## Updating HandBrake on Mac @@ -41,8 +41,8 @@ Manually checking for updates is easy. Using the main menu at the top of your sc ![Software update dialog](../../images/mac/software-update-1.1.0.png "If an update is available, HandBrake will offer to install it for you.") - - + + ## Updating HandBrake on Windows @@ -50,7 +50,7 @@ Automatic update checking may be enabled or disabled in HandBrake's preferences. Manually checking for updates is easy. From the `Help` menu, select `Check for Updates...`. If an update is available, HandBrake will offer to install it for you. - + diff --git a/source/docs/en/latest/get-handbrake/download-and-install.markdown b/source/docs/en/latest/get-handbrake/download-and-install.markdown index 60d38f6e..69ad8bb8 100644 --- a/source/docs/en/latest/get-handbrake/download-and-install.markdown +++ b/source/docs/en/latest/get-handbrake/download-and-install.markdown @@ -34,15 +34,15 @@ Experienced users may wish to try HandBrake's [nightly builds](https://handbrake The HandBrake Team publishes [checksums for all downloads on handbrake.fr](https://handbrake.fr/checksums.php) and the [Checksums article on GitHub](https://github.com/HandBrake/HandBrake/wiki/Checksums). You may use the provided checksums to verify the integrity of the files you download. - + When installing on Linux using the official PPA, download integrity is verified automatically. Similarly, the integrity of source code managed using `git` is verified automatically. To verify an official source distribution tarball, consult your Linux distribution's documentation for instructions on how to verify checksums. - + - + On Mac, launch Terminal from your Applications > Utilities folder and use the `shasum` command. For example, if you downloaded HandBrake 1.0.0 to your Downloads folder: @@ -50,15 +50,15 @@ On Mac, launch Terminal from your Applications > Utilities folder and use the `s Alternatively, the free third-party app [Hashsum](https://itunes.apple.com/us/app/hashsum/id1079442694?mt=12) available on the Mac App Store provides a convenient graphical interface for computing file checksums[^third-party-utilities-1]. - + - + On Windows, Microsoft provides the [Microsoft File Checksum Integrity Verifier](https://www.microsoft.com/en-us/download/details.aspx?id=11533) command line utility for verifying checksums. Please see the [associated Microsoft help article](https://support.microsoft.com/en-us/help/841290/availability-and-description-of-the-file-checksum-integrity-verifier-utility) for more information and usage instructions. Alternatively, free third-party apps [Compute Hash](http://www.subisoft.net/ComputeHash.aspx), [ExactFile](http://www.exactfile.com), and [MultiHasher](http://www.abelhadigital.com/multihasher) for Windows provide convenient graphical interfaces for computing file checksums[^third-party-utilities-2]. - + *If the checksums for the file you downloaded do not match the ones published by the HandBrake Team, you should delete the file and try your download again.* @@ -66,7 +66,7 @@ Alternatively, free third-party apps [Compute Hash](http://www.subisoft.net/Comp The HandBrake Team also publishes [OpenPGP signatures for all downloads on GitHub](https://github.com/HandBrake/HandBrake/releases). More information is available on the [OpenPGP article on GitHub](https://github.com/HandBrake/HandBrake/wiki/OpenPGP). - + ## Installing on Linux @@ -92,8 +92,8 @@ Run `HandBrakeCLI` to use HandBrake on the command line. Run `ghb` to launch HandBrake's graphical user interface. You may wish to right-click on the icon and select "Lock to Launcher" for easy access in the future. - - + + ## Installing on Mac @@ -121,8 +121,8 @@ Hold down the `Control` key and select the HandBrake icon to bring up the shortc Now HandBrake is up and running. You should not have to repeat this process in the near future. - - + + ## Installing on Windows @@ -154,7 +154,7 @@ By selecting `More info`, you will be able to select `Run anyway` to continue th ![Windows SmartScreen - Run Anyway](../../images/windows/smartscreen-2-1.0.0.png "Select Run anyway to dismiss the SmartScreen message and continue installing HandBrake.") - + ## Launching HandBrake diff --git a/source/docs/en/latest/get-handbrake/where-to-get-handbrake.markdown b/source/docs/en/latest/get-handbrake/where-to-get-handbrake.markdown index fd52faad..7cb3ebb7 100644 --- a/source/docs/en/latest/get-handbrake/where-to-get-handbrake.markdown +++ b/source/docs/en/latest/get-handbrake/where-to-get-handbrake.markdown @@ -22,11 +22,11 @@ Official [HandBrake releases](https://handbrake.fr/downloads.php) and [nightly b HandBrake is open-source software licensed under the GNU General Public License Version 2 (GPLv2)[^license]. Anyone can download and use HandBrake *for free*. - + Ubuntu Linux users should install the [official release PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases) or the [official snapshots PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-git-snapshots). 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. - + HandBrake source code is available at the official [HandBrake repository on GitHub](https://github.com/HandBrake/HandBrake). @@ -40,7 +40,7 @@ Beware of third-party websites and peer-to-peer downloads of HandBrake. They may Beware of online marketplaces and auction sites. HandBrake is *free software*. - + ## Warning about broken third-party builds @@ -62,7 +62,7 @@ BSD users should compile from the [official source code](https://github.com/Hand Linux users should install the [official release PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases), install the [official snapshots PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases), or compile from the [official source code](https://github.com/HandBrake/HandBrake). - + diff --git a/source/docs/en/latest/help/activity-log.markdown b/source/docs/en/latest/help/activity-log.markdown index ce4afb16..cedc5d90 100644 --- a/source/docs/en/latest/help/activity-log.markdown +++ b/source/docs/en/latest/help/activity-log.markdown @@ -98,7 +98,7 @@ Activity Logs may also be pasted directly into [new support requests on GitHub]( **Note:** When scanning a new source during encoding, log messages from the scan may be intermixed with log messages from your currently running encode. - + ### Activity Logs on Linux @@ -115,8 +115,8 @@ Inside, you may find the following files: - `Activity.log.ProcessID`, where `ProcessID` is the process identifier given to HandBrake by Linux, contains information about the specific app session - Log files for individual encodes are located in the `EncodeLogs` subdirectory and named according to the pattern `Videoname Date Time.txt`; encode logs are retained until deleted manually - - + + ### Activity Logs on Mac @@ -133,8 +133,8 @@ Inside, you may find the following files: - `HandBrake-activitylog.txt` is overwritten each time HandBrake starts, and contains information about the latest app session - Log files for individual encodes are named according to the pattern `Videoname Date Time.txt` and are retained until deleted manually - - + + ### Activity Logs on Windows @@ -152,7 +152,7 @@ Inside, you may find the following files: - `activity_logProcessID.txt`, where `ProcessID` is the process identifier given to HandBrake by Windows, contains information about the specific app session - Log files for individual encodes are named according to the pattern `Videoname Date Time.txt` and are retained until deleted manually - + ### Activity Logs on the command line diff --git a/source/docs/en/latest/introduction/quick-start.markdown b/source/docs/en/latest/introduction/quick-start.markdown index fbe386bc..dbe19b1e 100644 --- a/source/docs/en/latest/introduction/quick-start.markdown +++ b/source/docs/en/latest/introduction/quick-start.markdown @@ -34,43 +34,43 @@ HandBrake calls the video you already have the `Source`. Select the `Open Source` button on the toolbar to browse your files for a video to open. You may also drag your `Source` video onto HandBrake's main window. - + - - + + ![Browsing for a video source to open](../../images/mac/open-source-dialog-1.1.0.png "The Open Source dialog allows you to browse your files for a video to open.") ![Opening a video source via drag and drop](../../images/mac/open-source-drag-drop-1.1.0.png "In addition to the Open Source dialog, you may also open a video by dragging it to HandBrake's main window.") - - + + - + ## Select a title Some `Sources` may contain more than one video clip, or a collection of `Titles`. Use HandBrake's `Title` control to select which video clip you want to use. - + - - + + ![Selecting a title](../../images/mac/title-selection-1.1.0.png "Some sources may contain more than one video clip. The title control lets you select which video clip you want to use.") - - + + - + Some `Sources` have only one `Title`. Blu-ray and DVD `Sources` often have multiple `Titles`. @@ -80,21 +80,21 @@ HandBrake provides a number of settings `Presets` to make your new video work we The default `Fast 1080p30` preset is often a good choice because it's fast and compatible with most devices. - + - - + + ![Selecting a preset](../../images/mac/preset-selection-1.1.0.png "Presets are one-click settings to save you time and help ensure compatibility with your devices.") - - + + - + `Presets` can affect compatibility (whether your video will work with your devices and software) and encoding time. Learn more about [Selecting a preset](../workflow/select-preset.html). @@ -106,21 +106,21 @@ HandBrake calls the file name and location of your new video the `Destination`. `To` is the location where HandBrake will place your new video. You can select the `Browse...` button to choose a different location. - + - - + + ![Selecting a destination](../../images/mac/destination-field-1.1.0.png "The Destination is where HandBrake will place your new video.") - - + + - + Please take special care to *note your destination*. Otherwise, you won't be able to find your new video. You can move it later if you desire. @@ -128,31 +128,31 @@ Please take special care to *note your destination*. Otherwise, you won't be abl Select the `Start` button on the toolbar to make your new video. - + - - + + ![Encode progress](../../images/mac/encode-progress-1.1.0.png "HandBrake reports its progress during encoding.") ![Encoding complete alert](../../images/mac/encode-complete-1.1.0.png "HandBrake shows a notification when finished encoding.") - + HandBrake will report its progress while it's working and alert you when it's finished. Then you will have a new video file at the `Destination` you specified. - + ![Destination in Finder](../../images/mac/destination-finder-1.1.0.png "Your new video is located at the Destination you specified.") - - + + - + Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices. diff --git a/source/docs/en/latest/technical/audio-quality.markdown b/source/docs/en/latest/technical/audio-quality.markdown index ea6f5b9a..8647e0e3 100644 --- a/source/docs/en/latest/technical/audio-quality.markdown +++ b/source/docs/en/latest/technical/audio-quality.markdown @@ -21,11 +21,11 @@ The Audio Tracks quality settings are controlled via the "Audio" tab on the main Each track can be configured to suit your needs. - + ![HandBrake's Audio Track Settings](../../images/windows/audio-quality-1.0.0.png "HandBrake's Audio Track Settings") - + There are several different modes HandBrake can operate in. diff --git a/source/docs/en/latest/technical/frame-rates.markdown b/source/docs/en/latest/technical/frame-rates.markdown index 94b86ca9..e16966eb 100644 --- a/source/docs/en/latest/technical/frame-rates.markdown +++ b/source/docs/en/latest/technical/frame-rates.markdown @@ -19,11 +19,11 @@ Frame rate A video's frame rate is how many still pictures are displayed per second. Common frame rates are 23.976/24 for film, 25/50 for European broadcast standards, and 29.97/59.94 or 30/60 for North American broadcast standards. Modern video formats can be variable frame rate, switching between different frame rates on the fly, e.g. from 23.976 film to 29.97 NTSC and back. - + ![Frame rate controls on Mac](../../images/mac/frame-rate-controls-1.0.0.png "HandBrake's frame rate controls.") - + Selecting `Same as Source` allows you to select `Variable Frame Rate (VFR)`, which instructs HandBrake to make your new video's frame rate an exact copy of your `Source` frame rate. No frame rate conversion is performed. diff --git a/source/docs/en/latest/technical/system-requirements.markdown b/source/docs/en/latest/technical/system-requirements.markdown index fe072049..ca7acdd6 100644 --- a/source/docs/en/latest/technical/system-requirements.markdown +++ b/source/docs/en/latest/technical/system-requirements.markdown @@ -20,7 +20,7 @@ System requirements The following is the minimum level of hardware that HandBrake supports. While it may be technically possible to run HandBrake on hardware older than this, it is neither recommended nor supported. - + ### Linux @@ -34,9 +34,9 @@ The following is the minimum level of hardware that HandBrake supports. While it - 50 MB for the HandBrake app - 2 GB or more recommended for processing and storing your new videos - + - + ### Mac @@ -52,9 +52,9 @@ The following is the minimum level of hardware that HandBrake supports. While it - 50 MB for the HandBrake app - 2 GB or more recommended for processing and storing your new videos - + - + ### Windows @@ -68,13 +68,13 @@ The following is the minimum level of hardware that HandBrake supports. While it - 50 MB for the HandBrake app - 2 GB or more recommended for processing and storing your new videos - + HandBrake's QuickSync feature is only supported on Linux (experimental) and Windows. QuickSync requires a 2nd generation (Sandy Bridge) or newer Intel Core series processor with integrated Intel HD Graphics enabled and a directly connected display[^display-emulator-adapter]. ## Software - + ### Linux @@ -87,16 +87,16 @@ Several major versions are supported, see [Where to get HandBrake](../get-handbr For any other distribution, you must [compile from source](../developer/build-linux.html). - - + + ### Mac - OS X 10.7 Lion or later - [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing MKV (Matroska) media files - - + + ### Windows @@ -104,6 +104,6 @@ For any other distribution, you must [compile from source](../developer/build-li - Microsoft .NET Framework 4.6 or later - [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing media files - + [^display-emulator-adapter]: In lieu of a physically connected display, a display emulator adapter such as [Headless Ghost](https://www.headlessghost.com/) will enable GPU functions such as QuickSync when connected to the Intel HD Graphics output port. \ No newline at end of file diff --git a/source/docs/en/latest/technical/video-angles.markdown b/source/docs/en/latest/technical/video-angles.markdown index 2c662cee..3d98dfa3 100644 --- a/source/docs/en/latest/technical/video-angles.markdown +++ b/source/docs/en/latest/technical/video-angles.markdown @@ -25,8 +25,8 @@ Under the source section, you will see a dropdown with the label "Angle" if your You can choose which angle to encode to your output file. HandBrake does not currently support multi-angle output. - + ![Frame rate controls on Windows](../../images/windows/point-to-point-1.0.0.png "HandBrake's Angle Control.") - + diff --git a/source/docs/en/latest/technical/video-encoding-performance.markdown b/source/docs/en/latest/technical/video-encoding-performance.markdown index 0af6a552..2ce95bd0 100644 --- a/source/docs/en/latest/technical/video-encoding-performance.markdown +++ b/source/docs/en/latest/technical/video-encoding-performance.markdown @@ -43,20 +43,20 @@ Settings play a large part in encoding performance. Most of the encoders expose For x264 and x265, the Medium preset is a good trade off between quality, file size and speed but you can adjust this slider to suit your needs. - + ![HandBrake's Video Quality Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Quality Settings") - + Filters are another thing that has a big effect. Particularly if you use Denoise NLMeans. This is a very memory intensive operation so can drastically slow your encodes down. Again, there are settings for the filters that tune them for speed vs quality so you can see widely different results depending on what preset / tune you use. - + ![HandBrake's Video Filter Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Filter Settings") - + ### Source diff --git a/source/docs/en/latest/workflow/adjust-quality.markdown b/source/docs/en/latest/workflow/adjust-quality.markdown index 18f6ef97..52b8a8d3 100644 --- a/source/docs/en/latest/workflow/adjust-quality.markdown +++ b/source/docs/en/latest/workflow/adjust-quality.markdown @@ -26,11 +26,11 @@ Most of HandBrake's official `Presets` use the x264 video encoder and a constant To increase video quality, adjust the quality control toward the right. To reduce video quality, adjust the quality control toward the left. - + ![Using the constant quality control](../../images/mac/quality-control-1.1.0.png "Adjust the quality control toward the right to increase quality, or toward the left to lower it.") - + Begin by making small adjustments. Plus or minus 1-2 RF is usually noticeable. diff --git a/source/docs/en/latest/workflow/open-video-source.markdown b/source/docs/en/latest/workflow/open-video-source.markdown index 5be2e786..de6a8b19 100644 --- a/source/docs/en/latest/workflow/open-video-source.markdown +++ b/source/docs/en/latest/workflow/open-video-source.markdown @@ -37,79 +37,79 @@ You can learn more about [Source formats](../technical/source-formats.html) in t By default, HandBrake presents the `Open Source` dialog on launch. It is also accessible from the `Toolbar` at the top of HandBrake's main window. - + - - + + ![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.") - - + + - + Select the `Open Source` button to select the video you want to open. You can also drag and drop a video `Source` onto HandBrake's main window. - + - - + + ![Open Source dialog](../../images/mac/open-source-dialog-1.1.0.png "The Open Source dialog allows you to browse your files for a video to open.") ![Opening a video source via drag and drop](../../images/mac/open-source-drag-drop-1.1.0.png "In addition to the Open Source dialog, you may also open a video by dragging it to HandBrake's main window.") - - + + - + HandBrake will scan your selection and after a few moments, the main window will show the file name of the `Source` you opened along with some additional information. - + - - + + ![Successfully opened source](../../images/mac/open-source-success-1.1.0.png "HandBrake's main window after sucessfully opening a source.") - - + + - + Some `Sources` may contain more than one video clip, or a collection of `Titles`. Blu-ray and DVD `Sources` often have multiple `Titles`. Use HandBrake's `Title` control to select which video clip you want to use. - + - - + + ![Selecting a title](../../images/mac/title-selection-1.1.0.png "Some sources may contain more than one video clip. The title control lets you select which video clip you want to use.") - - + + - + Great! At this point, HandBrake knows which video you want to use. diff --git a/source/docs/en/latest/workflow/preview-settings.markdown b/source/docs/en/latest/workflow/preview-settings.markdown index 12847805..b8ff69ef 100644 --- a/source/docs/en/latest/workflow/preview-settings.markdown +++ b/source/docs/en/latest/workflow/preview-settings.markdown @@ -24,11 +24,11 @@ HandBrake's `Preview` feature allows you to perform a test run on a small portio At the top of HandBrake's main window, you'll see a toolbar with various buttons. - + ![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.") - + Select the `Preview` button to open the `Preview` window. @@ -36,13 +36,13 @@ Select the `Preview` button to open the `Preview` window. Move your mouse cursor over the `Preview` window, and some controls will appear. - + ![Preview window](../../images/mac/preview-window-1.1.0.jpg "HandBrake's Preview feature lets you test your settings on a small portion of your Source.") ![Preview controls](../../images/mac/preview-controls-1.1.0.png "You can set the starting position and duration of your Preview.") - + Set the starting position by dragging the `Position` control left or right, and choose how many seconds of video you want to encode using the `Duration` control. @@ -50,21 +50,21 @@ Set the starting position by dragging the `Position` control left or right, and When you're satisfied with your starting position and duration, select `Live Preview` and be patient. HandBrake will report its progress while it works. - + ![Preview progress indicator](../../images/mac/preview-progress-1.1.0.png "HandBrake will report its progress while encoding your Preview.") ![Preview playback controls](../../images/mac/preview-controls-playback-1.1.0.png "Playback controls allow you to interact with your Preview when it's ready.") - + When your `Preview` is ready, the controls are updated to let you play, pause, and rewind your video. You can also adjust the audio volume, and in some cases, choose which audio track plays. - + To create a new `Preview`, select the `╳` button to start over. - + When you're finished previewing your work, you may close the `Preview` window. diff --git a/source/docs/en/latest/workflow/select-preset.markdown b/source/docs/en/latest/workflow/select-preset.markdown index 8dff7474..f36a71df 100644 --- a/source/docs/en/latest/workflow/select-preset.markdown +++ b/source/docs/en/latest/workflow/select-preset.markdown @@ -24,21 +24,21 @@ HandBrake includes a number of official `Presets` for specific devices and for g Once you've opened a `Source`, select the `Preset` that most closely describes the device you want your videos to work on. For instance, if you want to play your videos on a Roku that supports 1080p High Definition, choose the `Roku 1080p30 Surround` preset under `Devices`. See the technical documentation for more information about [official presets](../technical/official-presets.html). - + - - + + ![Selecting a preset](../../images/mac/preset-selection-1.1.0.png "Presets are one-click settings to save you time and help ensure compatibility with your devices.") - - + + - + If your device is not listed, or you wish to play your videos on a computer, the default `Fast 1080p30` preset is a good choice. It's fast and compatible across a wide range of software and devices. diff --git a/source/docs/en/latest/workflow/start-encoding.markdown b/source/docs/en/latest/workflow/start-encoding.markdown index eed4061d..03650511 100644 --- a/source/docs/en/latest/workflow/start-encoding.markdown +++ b/source/docs/en/latest/workflow/start-encoding.markdown @@ -26,11 +26,11 @@ HandBrake calls the file name and location of your new video the `Destination`. `To` is the location where HandBrake will place your new video. You can select the `Browse...` button to choose a different location. - + ![Selecting a destination](../../images/mac/destination-field-1.1.0.png "The Destination is where HandBrake will place your new video.") - + Please take special care to *note your destination*. Otherwise, you won't be able to find your new video. You can move it later if you desire. @@ -38,29 +38,29 @@ Please take special care to *note your destination*. Otherwise, you won't be abl Select the `Start` button on the toolbar to make your new video. - + ![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.") - + Video encoding requires a lot of computer resources and can take awhile to complete. Some videos may take minutes to create; others may take hours.[^encoding-time] - + ![Encode progress](../../images/mac/encode-progress-1.1.0.png "HandBrake reports its progress during encoding.") ![Encoding complete alert](../../images/mac/encode-complete-1.1.0.png "HandBrake shows a notification when finished encoding.") - + HandBrake will report its progress while it's working and alert you when it's finished. Then you will have a new video file at the `Destination` you specified. - + ![Destination in Finder](../../images/mac/destination-finder-1.1.0.png "Your new video is located at the Destination you specified.") - + Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices.