diff --git a/source/docs/en/latest/advanced/batch-queue.markdown b/source/docs/en/latest/advanced/batch-queue.markdown deleted file mode 100644 index 707591bc..00000000 --- a/source/docs/en/latest/advanced/batch-queue.markdown +++ /dev/null @@ -1,60 +0,0 @@ ---- -Type: article -State: draft -Title: Queueing Jobs -Project: HandBrake -Project_URL: https://handbrake.fr/ -Project_Version: Latest -Language: English -Language_Code: en -Authors: Scott (s55) -Copyright: 2016 HandBrake Team -License: Creative Commons Attribution-ShareAlike 4.0 International -License_Abbr: CC BY-SA 4.0 -License_URL: https://handbrake.fr/docs/license.html ---- - -The Job Queue -============================= - -It's common to want to queue up many jobs and let HandBrake process them over an extended period of time. - -HandBrake offers two features to make this easier. A queue of jobs and batch scanning. - -## Queue - -### Adding a job to the Queue - -On the application toolbar, there are two buttons that you can use. - -![HandBrake app toolbar](../images/windows/add-to-queue.png "HandBrake Toolbar") - -- Add to Queue - - When you press this button, it will add the currently selected source, title and the currently chosen settings to the queue - -- Show Queue (x) - - where (x) is a number that tells you how many jobs you currently have on the queue for processing. - - When you press this button, the queue window will display showing you the current jobs waiting to be processed and those completed. - -![HandBrake queue window](../images/windows/queue.png "HandBrake Queue Window") - -### Editing Items on the queue. - -You can't change a job that is currently on the queue. If you want to change a jobs settings, you must press the "edit job" button on the queue task itself. -This will remove the job from the queue and reconfigure the main window with the source and settings that job was configured with. -You can then re-add the job to the queue for processing. - - -## Batch Scan - -If you have a folder of many files, you can point HandBrake at that folder and it will scan all the files at the top level of that directory. -Please note it does not recursively scan a directory. - -After the scan has completed, each file will be listed as a separate title in the "Title" dropdown on the main window. Just like multiple titles on a DVD or Bluray. - -You can then add each title to the queue. - - - - - diff --git a/source/docs/en/latest/advanced/queue.markdown b/source/docs/en/latest/advanced/queue.markdown new file mode 100644 index 00000000..73ad0685 --- /dev/null +++ b/source/docs/en/latest/advanced/queue.markdown @@ -0,0 +1,139 @@ +--- +Type: article +State: draft +Title: Multiple encodes using the Queue +Project: HandBrake +Project_URL: https://handbrake.fr/ +Project_Version: Latest +Language: English +Language_Code: en +Authors: Bradley Sepos (BradleyS), Scott (s55) +Copyright: 2016 HandBrake Team +License: Creative Commons Attribution-ShareAlike 4.0 International +License_Abbr: CC BY-SA 4.0 +License_URL: https://handbrake.fr/docs/license.html +--- + +Multiple encodes using the Queue +================================ + +Encoding videos takes time, and can use a lot of your computer's computational power. + +Luckily, you can set up multiple encodes at once by adding them to HandBrake's `Queue`. + +## Adding encodes to the Queue + +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. + + + +![HandBrake toolbar on Windows](../images/windows/toolbar.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") + + + +Select the `Show Queue` button on the toolbar to see the queued encodes, or `Jobs`. + + + +![HandBrake toolbar on Windows](../images/windows/toolbar.png "Select the Show Queue button on the toolbar to open the Queue window.") + +![Queue window on Windows](../images/windows/queue.png "The Queue window lists pending Jobs.") + + + +You may open additional `Sources` and add them to the `Queue` in the same manner. + +## Adding multiple encodes simultaneously + +When using the `Queue`, you may find it beneficial to create multiple `Jobs` at one time. + + + +On Mac, first open the `Preferences` window using the `HandBrake` menu. + +![Opening the Preferences window on Mac](../images/mac/preferences-menu.png "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. + +![Selecting the Automatically name output files setting](../images/mac/preferences-auto-naming.png "Select Automatically name output files ensure unique file names when adding multiple Titles to the Queue.") + +This ensures that each of your `Jobs` will be given a unique file name, and not overwrite each other. + + + + +On Windows, first open the `Preferences` window using the `Tools` menu. + +![Opening the Preferences window on Windows](../images/windows/preferences-menu.png "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. + +![Selecting the Automatically name output files setting](../images/windows/preferences-auto-naming.png "Set up Automatic File Naming to ensure unique file names when adding multiple Titles to the Queue.") + +This ensures that each of your `Jobs` will be given a unique file name, and not overwrite each other. + + + +If your `Source` is a Blu-ray, DVD, or other disc or disc-like format with multiple `Titles`, you may open it with HandBrake and add multiple `Titles` to the `Queue` simultaneously. + +Additionally, you may open 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]. + + + +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. + + + + +![Open Source dialog](../images/mac/open-source-dialog.png "The Open Source dialog allows you to browse your files for a video to open.") + +On Mac, select `Add Titles to Queue...` from the `File` menu, then select the `Titles` you wish to encode using the presented dialog. + + + + +On Windows, select `All Selection to Queue` from the `Queue` menu to add all `Titles`. + + + +You may open additional `Sources` and add them to the `Queue` in the same manner. + +## Editing Jobs + +To make changes to `Jobs` in the `Queue`, first open the `Queue` window by selecting the `Show Queue` button on the toolbar. + + + +![HandBrake toolbar on Windows](../images/windows/toolbar.png "Select the Show Queue button on the toolbar to open the Queue window.") + + + +To remove a `Job`, select the `╳` button next to the unwanted `Job`. + + + +![Removing an encode Job on Windows](../images/windows/queue.png "Select the remove button, which looks like a red X, to remove a Job from the Queue.") + + + +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.png "Select the edit button, which looks like a sheet of paper, to make changes to a Job.") + + + +When you're finished making changes, again add the encode to the `Queue` by selecting the `Add to Queue` button on the toolbar. + + + +![HandBrake toolbar on Windows](../images/windows/toolbar.png "Select the Add to Queue button on the toolbar to add your encode to the queue.") + + + +## Starting the Queue + +When ready, select the `Start` button on the toolbar or `Queue` window to begin encoding the `Jobs` in the `Queue`. + +[^batch-scan-subdirectories]: When opening multiple videos in a folder, HandBrake ignores any additional folders inside. Make sure the videos you wish to open are at the top level of the selected folder. diff --git a/source/docs/en/latest/images/mac/preferences-auto-naming-original.png b/source/docs/en/latest/images/mac/preferences-auto-naming-original.png new file mode 100644 index 00000000..c71a65c5 Binary files /dev/null and b/source/docs/en/latest/images/mac/preferences-auto-naming-original.png differ diff --git a/source/docs/en/latest/images/mac/preferences-auto-naming.png b/source/docs/en/latest/images/mac/preferences-auto-naming.png new file mode 100644 index 00000000..22607383 Binary files /dev/null and b/source/docs/en/latest/images/mac/preferences-auto-naming.png differ diff --git a/source/docs/en/latest/images/mac/preferences-menu-original.png b/source/docs/en/latest/images/mac/preferences-menu-original.png new file mode 100644 index 00000000..5dc63036 Binary files /dev/null and b/source/docs/en/latest/images/mac/preferences-menu-original.png differ diff --git a/source/docs/en/latest/images/mac/preferences-menu.png b/source/docs/en/latest/images/mac/preferences-menu.png new file mode 100644 index 00000000..cbc8deef Binary files /dev/null and b/source/docs/en/latest/images/mac/preferences-menu.png differ diff --git a/source/docs/en/latest/images/windows/preferences-auto-naming-original.png b/source/docs/en/latest/images/windows/preferences-auto-naming-original.png new file mode 100644 index 00000000..50899815 Binary files /dev/null and b/source/docs/en/latest/images/windows/preferences-auto-naming-original.png differ diff --git a/source/docs/en/latest/images/windows/preferences-auto-naming.png b/source/docs/en/latest/images/windows/preferences-auto-naming.png new file mode 100644 index 00000000..fd18501e Binary files /dev/null and b/source/docs/en/latest/images/windows/preferences-auto-naming.png differ diff --git a/source/docs/en/latest/images/windows/preferences-menu-original.png b/source/docs/en/latest/images/windows/preferences-menu-original.png new file mode 100644 index 00000000..a1d678da Binary files /dev/null and b/source/docs/en/latest/images/windows/preferences-menu-original.png differ diff --git a/source/docs/en/latest/images/windows/preferences-menu.png b/source/docs/en/latest/images/windows/preferences-menu.png new file mode 100644 index 00000000..da0d35c4 Binary files /dev/null and b/source/docs/en/latest/images/windows/preferences-menu.png differ diff --git a/source/docs/en/latest/images/windows/toolbar-original.png b/source/docs/en/latest/images/windows/toolbar-original.png new file mode 100644 index 00000000..9ae3a2ac Binary files /dev/null and b/source/docs/en/latest/images/windows/toolbar-original.png differ diff --git a/source/docs/en/latest/images/windows/toolbar.png b/source/docs/en/latest/images/windows/toolbar.png new file mode 100644 index 00000000..5e257e08 Binary files /dev/null and b/source/docs/en/latest/images/windows/toolbar.png differ diff --git a/source/docs/en/latest/table-of-contents.markdown b/source/docs/en/latest/table-of-contents.markdown index 7fc616e4..a90c1f0e 100644 --- a/source/docs/en/latest/table-of-contents.markdown +++ b/source/docs/en/latest/table-of-contents.markdown @@ -52,7 +52,7 @@ Table of contents ## Advanced features -- [Batch processing multiple jobs](advanced/batch-queue.html) +- [Multiple encodes using the Queue](advanced/queue.html) - [Custom presets](advanced/custom-presets.html) - [Audio and Subtitled Defaults](advanced/audio-subtitle-defaults.html) - [Resizing video](advanced/resizing-video.html)