HandBrake/HandBrake-docs
1
0
Fork 0
mirror of https://github.com/HandBrake/HandBrake-docs.git synced 2025-12-10 17:47:51 -06:00
Code Issues Packages Projects Releases 1 Wiki Activity

docs: Update smart comment tags to new system-foo format.

Browse Source
This commit is contained in:
Bradley Sepos 2018-04-22 12:01:13 -04:00
parent f9bff56f47
commit 5493c9db0e
No known key found for this signature in database
GPG Key ID: DEADE2F57D42D9C7
48 changed files with 496 additions and 496 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

72
source/docs/en/1.0.0/advanced/queue.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![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.")
<!-- /.system-win -->
<!-- /.system-windows -->
Select the `Show Queue` button on the toolbar to see the queued encodes, or `Jobs`.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![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.")
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
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.
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
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.
<!-- /.system-win -->
<!-- /.system-windows -->
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].
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-lin -->
<!-- /.system-macos -->
<!-- .system-linux -->
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.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
On Windows, select `All Selection to Queue` from the `Queue` menu to add all `Titles`.
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.")
<!-- /.system-win -->
<!-- /.system-windows -->
To remove a `Job`, select the `╳` button next to the unwanted `Job`.
<!-- .system-lin -->
<!-- .system-linux -->
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`.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
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.")
<!-- /.system-win -->
<!-- /.system-windows -->
When you're finished making changes, again add the encode to the `Queue` by selecting the `Add to Queue` button on the toolbar.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![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.")
<!-- /.system-win -->
<!-- /.system-windows -->
## 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`.
<!-- .system-mac -->
<!-- .system-macos -->
![Starting the Queue](../../images/mac/start-queue-button-1.0.0.png "The Start Queue button begins encoding the Jobs in the Queue.")
<!-- /.system-mac -->
<!-- /.system-macos -->
[^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.

12
source/docs/en/1.0.0/get-handbrake/check-for-updates.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
## 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.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
## 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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
## 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.
<!-- /.system-win -->
<!-- /.system-windows -->
<!-- .continue -->

24
source/docs/en/1.0.0/get-handbrake/download-and-install.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
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.
<!-- /.system-lin -->
<!-- /.system-linux -->
<!-- .system-mac -->
<!-- .system-macos -->
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].
<!-- /.system-mac -->
<!-- /.system-macos -->
<!-- .system-win -->
<!-- .system-windows -->
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].
<!-- /.system-win -->
<!-- /.system-windows -->
*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).
<!-- .system-lin -->
<!-- .system-linux -->
## 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.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
## 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.
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
## 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.")
<!-- /.system-win -->
<!-- /.system-windows -->
## Launching HandBrake

8
source/docs/en/1.0.0/get-handbrake/where-to-get-handbrake.markdown
View File

@ -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*.
<!-- .system-lin -->
<!-- .system-linux -->
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.
<!-- /.system-lin -->
<!-- /.system-linux -->
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*.
<!-- .system-lin -->
<!-- .system-linux -->
## 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).
<!-- /.system-lin -->
<!-- /.system-linux -->
<!-- .continue -->

12
source/docs/en/1.0.0/help/activity-log.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
### 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
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
### 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
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
### 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
<!-- /.system-win -->
<!-- /.system-windows -->
### Activity Logs on the command line

60
source/docs/en/1.0.0/introduction/quick-start.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
## 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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
`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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices.

4
source/docs/en/1.0.0/technical/audio-quality.markdown
View File

@ -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.
<!-- .system-win -->
<!-- .system-windows -->
![HandBrake's Audio Track Settings](../../images/windows/audio-quality-1.0.0.png "HandBrake's Audio Track Settings")
<!-- /.system-win -->
<!-- /.system-windows -->
There are several different modes HandBrake can operate in.

4
source/docs/en/1.0.0/technical/frame-rates.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![Frame rate controls on Mac](../../images/mac/frame-rate-controls-1.0.0.png "HandBrake's frame rate controls.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.

24
source/docs/en/1.0.0/technical/system-requirements.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
### 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
<!-- /.system-lin -->
<!-- /.system-linux -->
<!-- .system-mac -->
<!-- .system-macos -->
### 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
<!-- /.system-mac -->
<!-- /.system-macos -->
<!-- .system-win -->
<!-- .system-windows -->
### 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
<!-- /.system-win -->
<!-- /.system-windows -->
HandBrake's QuickSync and OpenCL features are only supported on Windows.
## Software
<!-- .system-lin -->
<!-- .system-linux -->
### 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).
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
### Mac
- OS X 10.7 Lion or later
- [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing MKV (Matroska) media files
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
### 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
<!-- /.system-win -->
<!-- /.system-windows -->

4
source/docs/en/1.0.0/technical/video-angles.markdown
View File

@ -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.
<!-- .system-win -->
<!-- .system-windows -->
![Frame rate controls on Windows](../../images/windows/point-to-point-1.0.0.png "HandBrake's Angle Control.")
<!-- /.system-win -->
<!-- /.system-windows -->

8
source/docs/en/1.0.0/technical/video-encoding-performance.markdown
View File

@ -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.
<!-- .system-win -->
<!-- .system-windows -->
![HandBrake's Video Quality Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Quality Settings")
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-win -->
<!-- .system-windows -->
![HandBrake's Video Filter Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Filter Settings")
<!-- /.system-win -->
<!-- /.system-windows -->
### Source

4
source/docs/en/1.0.0/workflow/adjust-quality.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
Begin by making small adjustments. Plus or minus 1-2 RF is usually noticeable.

48
source/docs/en/1.0.0/workflow/open-video-source.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![Successfully opened source](../../images/mac/open-source-success-1.0.0.png "HandBrake's main window after sucessfully opening a source.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
Great! At this point, HandBrake knows which video you want to use.

16
source/docs/en/1.0.0/workflow/preview-settings.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
To create a new `Preview`, select the `╳` button to start over.
<!-- /.system-mac -->
<!-- /.system-macos -->
When you're finished previewing your work, you may close the `Preview` window.

12
source/docs/en/1.0.0/workflow/select-preset.markdown
View File

@ -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).
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.

16
source/docs/en/1.0.0/workflow/start-encoding.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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]
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![Destination in Finder](../../images/mac/destination-finder-1.0.0.png "Your new video is located at the Destination you specified.")
<!-- /.system-mac -->
<!-- /.system-macos -->
Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices.

72
source/docs/en/1.1.0/advanced/queue.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![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.")
<!-- /.system-win -->
<!-- /.system-windows -->
Select the `Show Queue` button on the toolbar to see the queued encodes, or `Jobs`.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![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.")
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
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.
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
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.
<!-- /.system-win -->
<!-- /.system-windows -->
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].
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-lin -->
<!-- /.system-macos -->
<!-- .system-linux -->
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.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
On Windows, select `All Selection to Queue` from the `Queue` menu to add all `Titles`.
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.")
<!-- /.system-win -->
<!-- /.system-windows -->
To remove a `Job`, select the `╳` button next to the unwanted `Job`.
<!-- .system-lin -->
<!-- .system-linux -->
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`.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
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.")
<!-- /.system-win -->
<!-- /.system-windows -->
When you're finished making changes, again add the encode to the `Queue` by selecting the `Add to Queue` button on the toolbar.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![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.")
<!-- /.system-win -->
<!-- /.system-windows -->
## 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`.
<!-- .system-mac -->
<!-- .system-macos -->
![Starting the Queue](../../images/mac/start-queue-button-1.0.0.png "The Start Queue button begins encoding the Jobs in the Queue.")
<!-- /.system-mac -->
<!-- /.system-macos -->
[^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.

12
source/docs/en/1.1.0/get-handbrake/check-for-updates.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
## 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.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
## 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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
## 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.
<!-- /.system-win -->
<!-- /.system-windows -->
<!-- .continue -->

24
source/docs/en/1.1.0/get-handbrake/download-and-install.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
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.
<!-- /.system-lin -->
<!-- /.system-linux -->
<!-- .system-mac -->
<!-- .system-macos -->
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].
<!-- /.system-mac -->
<!-- /.system-macos -->
<!-- .system-win -->
<!-- .system-windows -->
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].
<!-- /.system-win -->
<!-- /.system-windows -->
*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).
<!-- .system-lin -->
<!-- .system-linux -->
## 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.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
## 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.
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
## 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.
<!-- /.system-win -->
<!-- /.system-windows -->
## Launching HandBrake

8
source/docs/en/1.1.0/get-handbrake/where-to-get-handbrake.markdown
View File

@ -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*.
<!-- .system-lin -->
<!-- .system-linux -->
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.
<!-- /.system-lin -->
<!-- /.system-linux -->
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*.
<!-- .system-lin -->
<!-- .system-linux -->
## 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).
<!-- /.system-lin -->
<!-- /.system-linux -->
<!-- .continue -->

12
source/docs/en/1.1.0/help/activity-log.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
### 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
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
### 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
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
### 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
<!-- /.system-win -->
<!-- /.system-windows -->
### Activity Logs on the command line

64
source/docs/en/1.1.0/introduction/quick-start.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
## 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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
`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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![Selecting a destination](../../images/mac/destination-field-1.1.0.png "The Destination is where HandBrake will place your new video.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![Destination in Finder](../../images/mac/destination-finder-1.1.0.png "Your new video is located at the Destination you specified.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices.

4
source/docs/en/1.1.0/technical/audio-quality.markdown
View File

@ -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.
<!-- .system-win -->
<!-- .system-windows -->
![HandBrake's Audio Track Settings](../../images/windows/audio-quality-1.0.0.png "HandBrake's Audio Track Settings")
<!-- /.system-win -->
<!-- /.system-windows -->
There are several different modes HandBrake can operate in.

4
source/docs/en/1.1.0/technical/frame-rates.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![Frame rate controls on Mac](../../images/mac/frame-rate-controls-1.0.0.png "HandBrake's frame rate controls.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.

24
source/docs/en/1.1.0/technical/system-requirements.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
### 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
<!-- /.system-lin -->
<!-- /.system-linux -->
<!-- .system-mac -->
<!-- .system-macos -->
### 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
<!-- /.system-mac -->
<!-- /.system-macos -->
<!-- .system-win -->
<!-- .system-windows -->
### 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
<!-- /.system-win -->
<!-- /.system-windows -->
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
<!-- .system-lin -->
<!-- .system-linux -->
### 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).
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
### Mac
- OS X 10.7 Lion or later
- [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing MKV (Matroska) media files
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
### 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
<!-- /.system-win -->
<!-- /.system-windows -->
[^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.

4
source/docs/en/1.1.0/technical/video-angles.markdown
View File

@ -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.
<!-- .system-win -->
<!-- .system-windows -->
![Frame rate controls on Windows](../../images/windows/point-to-point-1.0.0.png "HandBrake's Angle Control.")
<!-- /.system-win -->
<!-- /.system-windows -->

8
source/docs/en/1.1.0/technical/video-encoding-performance.markdown
View File

@ -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.
<!-- .system-win -->
<!-- .system-windows -->
![HandBrake's Video Quality Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Quality Settings")
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-win -->
<!-- .system-windows -->
![HandBrake's Video Filter Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Filter Settings")
<!-- /.system-win -->
<!-- /.system-windows -->
### Source

4
source/docs/en/1.1.0/workflow/adjust-quality.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
Begin by making small adjustments. Plus or minus 1-2 RF is usually noticeable.

48
source/docs/en/1.1.0/workflow/open-video-source.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![Successfully opened source](../../images/mac/open-source-success-1.1.0.png "HandBrake's main window after sucessfully opening a source.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
Great! At this point, HandBrake knows which video you want to use.

16
source/docs/en/1.1.0/workflow/preview-settings.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
To create a new `Preview`, select the `╳` button to start over.
<!-- /.system-mac -->
<!-- /.system-macos -->
When you're finished previewing your work, you may close the `Preview` window.

12
source/docs/en/1.1.0/workflow/select-preset.markdown
View File

@ -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).
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.

16
source/docs/en/1.1.0/workflow/start-encoding.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![Selecting a destination](../../images/mac/destination-field-1.1.0.png "The Destination is where HandBrake will place your new video.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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]
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![Destination in Finder](../../images/mac/destination-finder-1.1.0.png "Your new video is located at the Destination you specified.")
<!-- /.system-mac -->
<!-- /.system-macos -->
Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices.

72
source/docs/en/latest/advanced/queue.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![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.")
<!-- /.system-win -->
<!-- /.system-windows -->
Select the `Show Queue` button on the toolbar to see the queued encodes, or `Jobs`.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![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.")
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
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.
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
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.
<!-- /.system-win -->
<!-- /.system-windows -->
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].
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-lin -->
<!-- /.system-macos -->
<!-- .system-linux -->
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.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
On Windows, select `All Selection to Queue` from the `Queue` menu to add all `Titles`.
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![HandBrake toolbar on Windows](../../images/windows/toolbar-1.0.0.png "Select the Show Queue button on the toolbar to open the Queue window.")
<!-- /.system-win -->
<!-- /.system-windows -->
To remove a `Job`, select the `╳` button next to the unwanted `Job`.
<!-- .system-lin -->
<!-- .system-linux -->
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`.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
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.")
<!-- /.system-win -->
<!-- /.system-windows -->
When you're finished making changes, again add the encode to the `Queue` by selecting the `Add to Queue` button on the toolbar.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
![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.")
<!-- /.system-win -->
<!-- /.system-windows -->
## 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`.
<!-- .system-mac -->
<!-- .system-macos -->
![Starting the Queue](../../images/mac/start-queue-button-1.0.0.png "The Start Queue button begins encoding the Jobs in the Queue.")
<!-- /.system-mac -->
<!-- /.system-macos -->
[^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.

12
source/docs/en/latest/get-handbrake/check-for-updates.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
## 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.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
## 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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
## 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.
<!-- /.system-win -->
<!-- /.system-windows -->
<!-- .continue -->

24
source/docs/en/latest/get-handbrake/download-and-install.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
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.
<!-- /.system-lin -->
<!-- /.system-linux -->
<!-- .system-mac -->
<!-- .system-macos -->
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].
<!-- /.system-mac -->
<!-- /.system-macos -->
<!-- .system-win -->
<!-- .system-windows -->
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].
<!-- /.system-win -->
<!-- /.system-windows -->
*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).
<!-- .system-lin -->
<!-- .system-linux -->
## 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.
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
## 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.
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
## 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.")
<!-- /.system-win -->
<!-- /.system-windows -->
## Launching HandBrake

8
source/docs/en/latest/get-handbrake/where-to-get-handbrake.markdown
View File

@ -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*.
<!-- .system-lin -->
<!-- .system-linux -->
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.
<!-- /.system-lin -->
<!-- /.system-linux -->
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*.
<!-- .system-lin -->
<!-- .system-linux -->
## 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).
<!-- /.system-lin -->
<!-- /.system-linux -->
<!-- .continue -->

12
source/docs/en/latest/help/activity-log.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
### 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
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
### 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
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
### 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
<!-- /.system-win -->
<!-- /.system-windows -->
### Activity Logs on the command line

64
source/docs/en/latest/introduction/quick-start.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
## 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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
`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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![Selecting a destination](../../images/mac/destination-field-1.1.0.png "The Destination is where HandBrake will place your new video.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![Destination in Finder](../../images/mac/destination-finder-1.1.0.png "Your new video is located at the Destination you specified.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices.

4
source/docs/en/latest/technical/audio-quality.markdown
View File

@ -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.
<!-- .system-win -->
<!-- .system-windows -->
![HandBrake's Audio Track Settings](../../images/windows/audio-quality-1.0.0.png "HandBrake's Audio Track Settings")
<!-- /.system-win -->
<!-- /.system-windows -->
There are several different modes HandBrake can operate in.

4
source/docs/en/latest/technical/frame-rates.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![Frame rate controls on Mac](../../images/mac/frame-rate-controls-1.0.0.png "HandBrake's frame rate controls.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.

24
source/docs/en/latest/technical/system-requirements.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
### 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
<!-- /.system-lin -->
<!-- /.system-linux -->
<!-- .system-mac -->
<!-- .system-macos -->
### 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
<!-- /.system-mac -->
<!-- /.system-macos -->
<!-- .system-win -->
<!-- .system-windows -->
### 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
<!-- /.system-win -->
<!-- /.system-windows -->
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
<!-- .system-lin -->
<!-- .system-linux -->
### 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).
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
### Mac
- OS X 10.7 Lion or later
- [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing MKV (Matroska) media files
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
### 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
<!-- /.system-win -->
<!-- /.system-windows -->
[^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.

4
source/docs/en/latest/technical/video-angles.markdown
View File

@ -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.
<!-- .system-win -->
<!-- .system-windows -->
![Frame rate controls on Windows](../../images/windows/point-to-point-1.0.0.png "HandBrake's Angle Control.")
<!-- /.system-win -->
<!-- /.system-windows -->

8
source/docs/en/latest/technical/video-encoding-performance.markdown
View File

@ -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.
<!-- .system-win -->
<!-- .system-windows -->
![HandBrake's Video Quality Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Quality Settings")
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-win -->
<!-- .system-windows -->
![HandBrake's Video Filter Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Filter Settings")
<!-- /.system-win -->
<!-- /.system-windows -->
### Source

4
source/docs/en/latest/workflow/adjust-quality.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
Begin by making small adjustments. Plus or minus 1-2 RF is usually noticeable.

48
source/docs/en/latest/workflow/open-video-source.markdown
View File

@ -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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![Successfully opened source](../../images/mac/open-source-success-1.1.0.png "HandBrake's main window after sucessfully opening a source.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
Great! At this point, HandBrake knows which video you want to use.

16
source/docs/en/latest/workflow/preview-settings.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
To create a new `Preview`, select the `╳` button to start over.
<!-- /.system-mac -->
<!-- /.system-macos -->
When you're finished previewing your work, you may close the `Preview` window.

12
source/docs/en/latest/workflow/select-preset.markdown
View File

@ -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).
<!-- .system-lin -->
<!-- .system-linux -->
<!-- TODO: Linux figures. -->
<!-- /.system-lin -->
<!-- .system-mac -->
<!-- /.system-linux -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- .system-win -->
<!-- /.system-macos -->
<!-- .system-windows -->
<!-- TODO: Windows figures. -->
<!-- /.system-win -->
<!-- /.system-windows -->
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.

16
source/docs/en/latest/workflow/start-encoding.markdown
View File

@ -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.
<!-- .system-mac -->
<!-- .system-macos -->
![Selecting a destination](../../images/mac/destination-field-1.1.0.png "The Destination is where HandBrake will place your new video.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![Main window toolbar](../../images/mac/toolbar-1.1.0.png "The Toolbar provides easy access to HandBrake's most common functions.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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]
<!-- .system-mac -->
<!-- .system-macos -->
![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.")
<!-- /.system-mac -->
<!-- /.system-macos -->
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.
<!-- .system-mac -->
<!-- .system-macos -->
![Destination in Finder](../../images/mac/destination-finder-1.1.0.png "Your new video is located at the Destination you specified.")
<!-- /.system-mac -->
<!-- /.system-macos -->
Congratulations! You just encoded your first video using HandBrake. It's now ready to watch on your devices.