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

Various updates and improvements

Browse Source
This commit is contained in:
sr55 2025-08-26 17:49:39 +01:00
parent ef113f3c09
commit 355f88ff8e
No known key found for this signature in database
GPG Key ID: 99C970F83E86C84B
12 changed files with 125 additions and 49 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
source/docs/en/images/mac/preferences-auto-naming-1.10.0.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 53 KiB

BIN
source/docs/en/images/mac/queue-1.10.0.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 138 KiB

10
source/docs/en/latest/advanced/audio-subtitle-defaults.markdown
View File

@ -1,6 +1,5 @@
---
Type: article
State: [ draft ]
Title: Audio and Subtitle Defaults
Project: HandBrake
Project_URL: https://handbrake.fr/
@ -17,7 +16,7 @@ License_URL: https://handbrake.fr/docs/license.html
Audio and Subtitle Defaults
=============================
HandBrake does not store Audio and Subtitle tracks in presets.
HandBrake does not store Audio and Subtitle tracks in presets as these vary from source to source.
Instead, we store behaviour rules for automatically selecting audio and subtitle tracks each time you scan a new source or select a title.
@ -25,6 +24,9 @@ In order to configure the track selection behaviour, click the "Selection Behavi
![Audio Defaults Access Button](../../images/windows/audio-configure-defaults-button-win-1.4.0.png "Audio Defaults Window")
After you've made the changes, you can press the "Reload" button on the Audio or Subtitle tab to see the effect on the currently selected source.
### Audio Defaults
<!-- .system-macos -->
@ -34,6 +36,8 @@ In order to configure the track selection behaviour, click the "Selection Behavi
![Audio Defaults Window](../../images/windows/audio-defaults-win-1.8.0.png "Audio Defaults Window")
<!-- /.system-windows -->
The behaviours screen has a number of options:
- Track Selection Behaviour
- None
- No audio tracks will be automatically added.
@ -64,6 +68,8 @@ In order to configure the track selection behaviour, click the "Selection Behavi
![Subtitle Defaults Window](../../images/windows/subtitle-defaults-win-1.4.0.png "Subtitle Defaults Window")
<!-- /.system-windows -->
The behaviours screen has a number of options:
- Track Selection Behaviour
- None
- No subtitle tracks will be added

1
source/docs/en/latest/advanced/chapter-markers.markdown
View File

@ -1,6 +1,5 @@
---
Type: article
State: [ draft ]
Title: Chapter Markers
Project: HandBrake
Project_URL: https://handbrake.fr/

82
source/docs/en/latest/advanced/metadata-passthru.markdown Normal file
View File

@ -0,0 +1,82 @@
---
Type: article
Title: Metadata
Project: HandBrake
Project_URL: https://handbrake.fr/
Project_Version: Latest
Language: English
Language_Code: en
Authors: [ Scott (s55) ]
Copyright: 2024 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
---
Metadata Passthru
=============================
HandBrake can pass through metadata some common metadata from the source file.
You can enable this function by choosing the "Passthru common Metadata" option on hte "Summary" tab.
The following Metadata attributes are copied through:
| Field | Comment |
| ----- | ----- |
|Name| Also known as Title |
|Episode ID||
|Episode Sort||
|Season Number||
|Rating||
|Media Type||
|HD Video||
|Description||
|LongDescription||
|SeriesDescription||
|Comment||
|Grouping||
|Compilation||
|Tempo||
|Subtitle||
|SongDescription||
|Director||
|ArtDirector||
|Composer||
|Arranger||
|Author||
|Acknowledgement||
|Conductor||
|Lyrics||
|Keywords||
|Copyright||
|WorkName||
|MovementName||
|MovementNumber||
|MovementShow||
|ShowWorkAndMovement||
|LinearNotes||
|RecordCompany||
|OriginalArtist||
|PhonogramRights||
|Producer||
|Performers||
|Publisher||
|SoundEngineer||
|Soloist||
|Credits||
|Thanks||
|OnlineExtra||
|ExecutiveProducer||
|iTunesU||
|Podcast||
|Category||
|ContentID||
|ArtistID||
|PlaylistID||
|GenreID||
|ComposerID||
|XID||
|iTunEXTC||
|iTunMOVI||
|Location6709||

13
source/docs/en/latest/advanced/point-to-point.markdown
View File

@ -1,6 +1,5 @@
---
Type: article
State: [ draft ]
Title: Point to Point Encoding
Project: HandBrake
Project_URL: https://handbrake.fr/
@ -24,12 +23,12 @@ Chapters, then, divide the movie/episode up logically. In a DVD or Blu-ray disc
## Point to Point options
In HandBrake you can decide what parts of the content that you wish to encode. You can do this by choosing what "range" you'd like, followed by a start and end point.
![Point to Point controls](../../images/windows/point-to-point-1.0.0.png "Point to Point controls")
For a given title, you can choose to encode only part of it instead of the whole thing.
There are three types of range available:
There are three options:
- Chapters,
- Seconds, e.g 60-180 means it will encode 2 minutes of video, starting 1 minute into the title.
- Frames, e.g (25-150) will encode 5 seconds of video if the framerate is 25fps. Starting after the 1st second of video.
- Chapters - Commonly found on DVD and Bluray discs and often video files as well.
- Seconds - This option offers more fine-grained control. For example: 60 - 180 means it will encode 2 minutes of video, starting 1 minute into the title.
- Frames, e.g (25-150) will encode 5 seconds of video if the framerate is 25fps. Starting after the 1st second of video. Note however that exact frame accuracy is not guaranteed or even always possible depending on the source.

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

@ -41,7 +41,7 @@ Select the `Show Queue` button on the toolbar to see the queued encodes, or `Job
![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.8.0.png "The Queue window lists pending Jobs.")
![Queue window on Mac](../../images/mac/queue-1.10.0.png "The Queue window lists pending Jobs.")
<!-- /.system-macos -->
<!-- .system-windows -->

37
source/docs/en/latest/advanced/resizing-video.markdown
View File

@ -1,6 +1,5 @@
---
Type: article
State: [ draft ]
Title: Resizing Video
Project: HandBrake
Project_URL: https://handbrake.fr/
@ -23,20 +22,7 @@ The picture settings tab is located on HandBrake's main window and becomes activ
![Picture settings tab](../../images/windows/picture-settings-win-1.4.0.png "Picture settings tab")
### Anamorphic
Typically recommended that you leave this on "automatic". If your source is not anamorphic, having this set to an anamorphic option will not affect the output. Thus, it is safe to leave on.
When "Automatic" is selected, HandBrake will maximise the output size of the video, up to the source resolution or set "Resolution Limit".
When "Off" is selected along with unchecking "Optimal Size", you can alter both "width" and "height". Otherwise, the source size, or resolution limit will be used.
When "Custom" is selected, you have full control of the output dimensions.
### Upscaling
While upscaling is NOT recommended, there are some instances where it is useful (i.e. uploading to YouTube). To enable this, check the "Allow upscaling" checkbox.
The "Resolution Limit" will still be honoured.
It is recommended that you start with a preset that most closely fits your requirements. After this, if you want to set a limit on the output resolution, simply set the "Resolution Limit" dropdown to the desired value and HandBrake will automatically take care of the rest.
## Cropping
@ -52,3 +38,24 @@ The preview window will then appear and will display in real-time any changes yo
If the size of the output exceeds the window size, the preview window will scale it to fit to screen.
![Preview window](../../images/windows/preview-window-1.0.0.jpg "Preview window")
### Upscaling Video
While upscaling is NOT recommended, there are some instances where it is useful (i.e. uploading to YouTube). To enable this, check the "Allow upscaling" checkbox.
The "Resolution Limit" will still be honoured in this case.
### Anamorphic
Typically recommended that you leave this on "automatic". If your source is not anamorphic, having this set to an anamorphic option will not affect the output. Thus, it is safe to leave on.
- When "Automatic" is selected, HandBrake will maximise the output size of the video, up to the source resolution or set "Resolution Limit".
- When "Off" is selected along with unchecking "Optimal Size", you can alter both "width" and "height". Otherwise, the source size, or resolution limit will be used.
- When "Custom" is selected, you have full control of the output dimensions.

20
source/docs/en/latest/advanced/subtitle-defaults.markdown
View File

@ -1,20 +0,0 @@
---
Type: article
State: [ draft ]
Title: Subtitle Defaults
Project: HandBrake
Project_URL: https://handbrake.fr/
Project_Version: Latest
Language: English
Language_Code: en
Authors: []
Copyright: 2024 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
---
Subtitle Defaults
=============================
Todo

6
source/docs/en/latest/advanced/subtitles.markdown
View File

@ -1,6 +1,5 @@
---
Type: article
State: [ draft ]
Title: Subtitles
Project: HandBrake
Project_URL: https://handbrake.fr/
@ -17,6 +16,10 @@ License_URL: https://handbrake.fr/docs/license.html
Subtitles
=========
If you wish to handle Audio and Subtitle tracks automatically, See the [Audio and Subtitle Defaults](../workflow/audio-subtitle-defaults.html) guide.
Otherwise, if you wish to manually add subtitle tracks, press the "Tracks" button on the "Subtitles" tab and choose the appropriate option. A new track will be displayed that you can configure as you require.
## Supported Subtitle Formats
There are different types of subtitles that exist:
@ -61,7 +64,6 @@ The following subtitle types as supported as follows:
- Can be read from your source file or imported through the “Subtitles tab” if you have separate files(s)
- You can set an offset (measured in milliseconds) to change the start time that the first and subsequent SRT subtitles will appear. Use trial and error encoding a single chapter to obtain the correct offset.
- You should make sure the correct character code is selected from the “Char Code” dropdown. Selecting the wrong code, will result in your output file having no subtitle track, and can cause the player to crash when playing that track.
- Please note, SRT tracks are converted to SSA in the output file. This behavior is not currently configurable.
- SSA Subtitles
- SSA Subtitles can be passed-thru or burned into the video.

1
source/docs/en/latest/table-of-contents.markdown
View File

@ -59,6 +59,7 @@ Table of contents
- [Preserving surround sound](advanced/surround-sound.html)<span class="notice draft"><span>draft</span></span>
- [Adding subtitles](advanced/subtitles.html)<span class="notice draft"><span>draft</span></span>
- [Adding chapter markers](advanced/chapter-markers.html)<span class="notice draft"><span>draft</span></span>
- [Adding Metadata](advanced/metadata-passthru.html)<span class="notice draft"><span>draft</span></span>
<!-- - [Managing Audio Tracks](advanced/managing-audio.html) -->
<!-- - [Post-processing metadata](advanced/post-processing.html) -->

2
source/docs/en/latest/technical/video-qsv.markdown
View File

@ -18,7 +18,7 @@ Intel Quick Sync Video
## Supported Hardware and Configurations
- Intel Skylake (8th Generation Core) CPU or later with Intel HD, Iris Xe or Arc graphics.
- Intel Skylake (9th Generation Core) CPU or later with Intel HD, Iris Xe or Arc graphics.
- Windows 10 or Later
- Please make sure your Intel GPU drivers are up-to-date. Driver version should be >= 31.0.x.x
- Some Modern Linux versions.