-
Notifications
You must be signed in to change notification settings - Fork 55
Home
Welcome to the HBBatchBeast wiki!
This is the source folder which will be scanned for media. The folder needs to be entered with no trailing slash. For example:
Windows:
C:\Users\HaveAGitGat\Desktop\Input
Linux:
/home/haveagitgat/Desktop/Input
macOS:
/Users/haveagitgat/Desktop/Input
The source folder path is expandable (press enter to create a new line). If you want to specify multiple source folders, make sure each source folder path is on its own line.
If "Temporary conversion folder?" is checked, then Handbrake will convert files into that folder. Once the conversion is finished, the file will be moved into your "Destination folder". You'll need to specify as many temporary conversion folders as source folders. Your first source folder will be converted into your first temporary conversion folder, your second source folder into your second temporary conversion folder and so on.
You'll then to specify destination folder paths. Again, you'll need to specify as many destination folders as source folders. Files from your first source folder will end up in your first destination folder, your second source folder files in your second destination folder and so on.
First source folder ---------> First temporary conversion folder ---------> First destination folder
Second source folder ---------> Second temporary conversion folder ---------> Second destination folder
etc
Select the HandBrake preset you'd like to convert your files with. If "Standard preset" is selected, then all files in the folders selected will be converted using the specified Handbrake preset. You can find more about HandBrake presets here:
https://handbrake.fr/docs/en/latest/workflow/select-preset.html
If "Custom preset" then you need to enter your own custom preset. HBBB covers the "HandBrakeCLI -i source -o destination" part of the HandBrakeCLI input so you need to enter the conversion parameters. For example:
-e x264 -q 20 -B
-Z "Very Fast 1080p30"
-Z "Very Fast 480p30"
You can also link to a custom preset that's been exported from the official HandBrake GUI application for example:
"C:\Users\HaveAGitGat\Desktop\testpreset.json" -Z "My Preset"
Each custom preset needs to be on its own line and, similar to the folders, there need to be as many custom presets as source folders.
First source folder ---------> First temporary conversion folder ---------> First destination folder @ Custom preset 1
Second source folder ---------> Second temporary conversion folder ---------> Second destination folder @ Custom preset 2
etc
See the following image for guidance:
https://imgur.com/a/2tl8dIw
Select the container you'd like the output file to have. You can find out more about containers at: https://handbrake.fr/docs/en/latest/technical/containers.html
HBBB can monitor your source folders and run scans for new files at a specified interval. The interval time is in seconds with the default being 300 seconds (5 minutes). If this option is selected, then when you press "Scan and convert", the program will convert any new files and then a countdown timer will begin. This will loop infinitely until stopped. The scan interval is in the advanced settings section.
Instead of periodic scanning, you can choose for a scan to be run once a day. The scan time is entered in the advanced settings section in hh:mm format. Once "Scan and convert" is selected, the program will wait until the specified time until running a scan and conversion process. Again, this will loop infinitely until stopped.
If this is selected, then if a conversion attempt is successful, the source file will be deleted.
Enter the file types to scan for. Each type needs to be separated by a comma. The default entry is:
mp4,mkv,mov,m4v,mpg,mpeg,avi,flv,webm,wmv,vob,evo,mts,m2ts,ts,iso,
Valid file types:File types
which the
program will scan for.Separate with comma (e.g. iso,wmv,
)Default:mp4,mkv,mov,m4v,mpg,mpeg,avi,flv,webm,wmv,vob,evo,mts,m2ts,ts,iso,
Number of
simultaneous Handbrake
instances:Set
how many Handbrake
simultaneous conversions to carry out. Although an ulimited amount can be used, it is
recommended not to go above 4.
Custom bat path to run after each conversion
(Windows):Input
a bat file path to run after each file has finished being converted.Bat files with
timeout
statements won't work (more on this here
https://comm.support.ca.com/kb/the-timeout-command-in-batch-script-job-results-in-error-input-redirection-is-not-supported-exiting-the-process-immediately/kb000029524)Leave
box completely empty if you do not wish to use this option (make sure there are no
hidden
characters in the box).
Save config:Save current configuration
Health check:This uses
Handbrakes
inbuilt '--scan' feature it uses to scan a video for information. If an error is thrown
during this
process, the file my be corrupt. It is not 100% accurate so should only be used as
guidance.
Scan only:Scan for files to
be
converted given current configuration. No files will be converted. Pressing this
will
only
run it once (regardless of whether 'periodic scanning' is checked.
Scan and convert:Scan for
files
and
convert any valid ones. If 'periodic scanning' is checked, then the program will
scan
and
convert repeatedly at the specified interval.
View scan/conversion summary
log:Show
historic scan/conversion information
View individual file conversion
log:
Shows a list of all files processed with success or error tag.
Total number of media files
found:Number
of valid files found based on valid file types option.
Number of unconverted media files
found:Files
which don't exist in the destination folder structure when compared to the source
folder
structure.
If an item in the queue comes out with "Error", this means that the HandbrakeCLI
had
trouble
converting/scanning the file, most likely due to it being corrupt/partially corrupt.
Else it may
be
a
file type which Handbrake does not support. Try converting the file normally in
Handbrake
to
see what error it throws.<br>
Email settings:Fill in
details to receive email notifications if an error is encountered during health check or
conversion/folder watching. Won't work with accounts that require 2FA. May need to
enable access to less secure apps on Gmail accounts.
Email: e.g. [email protected]
Password: Is not saved for security purposes.
SMTP server: e.g. smtp.gmail.com