handbrake-loader


Use HandBrake to Encode/Transcode Video files with Webpack.

Install

``bash
$ npm install handbrake-loader --save
`

Usage

In your webpack.config.js add the handbrake-loader, chained with the file-loader, url-loader or raw-loader:

`js
{
test: /\.(mov|mkv|avi|mp4)$/,
use: [

/ file-loader | url-loader | raw-loader /
{ loader: 'file-loader' },

{
loader: 'handbrake-loader',
options: {
enable: process.env.NODE_ENV === 'production',
format: 'mp4',
srtFile: path.resolve(__dirname, 'sample-files/subtitle.srt'),
srtLang: 'eng',
srtBurn: 1,
preset: 'Very Fast 1080p30',
optimize: true
}
}
]
}
`

Options

#### preset [string]

Select preset by name (case-sensitive) Enclose names containing spaces in double quotation marks (e.g. "Preset Name")

#### preset-import-file [filespec]

Import presets from a json preset file. 'filespec' may be a list of files separated by spaces, or it may use shell wildcards.

#### preset-export [string]

Create a new preset from command line options and write a json representation of the preset to the console or a file if '--preset-export-file' is specified. The required argument will be the name of the new preset.

#### preset-export-file [filename]

Write new preset generated by '--preset-export' to file 'filename'.

#### preset-export-description [string]

Add a description to the new preset created with '--preset-export'

#### no-dvdnav

Do not use dvdnav for reading DVDs

#### no-opencl

Disable use of OpenCL

#### title [number]

Select a title to encode (0 to scan all titles only, default: 1)

#### min-duration

Set the minimum title duration (in seconds). Shorter titles will be ignored (default: 10).

#### scan

Scan selected title only.

#### main-feature

Detect and select the main feature title.

#### chapters [string]

Select chapters (e.g. "1-3" for chapters 1 to 3 or "3" for chapter 3 only, default: all chapters)

#### angle [number]

Select the video angle (DVD or Blu-ray only)

#### previews [number:boolean]

Select how many preview images are generated, and whether to store to disk (0 or 1). (default: 10:0)

#### start-at-preview [number]

Start encoding at a given preview.

#### start-at [string:number]

Start encoding at a given duration (in seconds), frame, or pts (on a 90kHz clock) (e.g. duration:10, frame:300, pts:900000)

#### stop-at [string:number]

Stop encoding at a given duration (in seconds), frame, or pts (on a 90kHz clock) (e.g. duration:10, frame:300, pts:900000)

#### format [string]

Select container format av_mp4, av_mkv or mp4, mkv

#### markers

Add chapter markers

#### no-markers

Disable preset chapter markers

#### optimize

Optimize MP4 files for HTTP streaming (fast start, s.s. rewrite file to place MOOV atom at beginning)

#### no-optimize

Disable preset 'optimize'

#### ipod-atom

Add iPod 5G compatibility atom to MP4 container

#### no-ipod-atom

Disable iPod 5G atom

#### use-opencl

Use OpenCL where applicable

#### encoder [string]

Select video encoder: x264, x265, mpeg4, mpeg2, VP8, VP9, theora

#### encoder-preset [string]

Adjust video encoding settings for a particular speed/efficiency tradeoff (encoder-specific)

- x264
- x265
- ultrafast,superfast,veryfast,faster,fast,medium,slow,slower,veryslow,placebo
- VP8
- VP9
- veryfast,faster,fast,medium,slow,slower,veryslow

#### encoder-tune [string]

Adjust video encoding settings for a particular type of source or situation (encoder-specific)

- x264
- film,animation,grain,stillimage,psnr,ssim,fastdecode,zerolatency
- x265
- psnr,ssim,grain,zerolatency,fastdecode

#### encopts [string]

Specify advanced encoding options in the same style as mencoder (all encoders except theora): option1=value1:option2=value2


#### encoder-profile [string]

Ensure compliance with the requested codec profile (encoder-specific)

- x264
- auto,high,main,baseline
- x265
- auto,main,mainstillpicture

#### encoder-level [string]

Ensures compliance with the requested codec level (encoder-specific)

- x264
- auto,1.0,1b,1.1,1.2,1.3,2.0,2.1,2.2,3.0,3.1,3.2,4.0,4.1,4.2,5.0,5.1,5.2

#### quality [float]

Set video quality (e.g. 22.0)

#### vb [number]

Set video bitrate in kbit/s (default: 1000)

#### two-pass

Use two-pass mode

#### no-two-pass

Disable two-pass mode

#### turbo

When using 2-pass use "turbo" options on the first pass to improve speed (works with x264 and x265)

#### no-turbo

Disable 2-pass mode's "turbo" first pass

#### rate [float]

Set video framerate (5,10,12,15,20,23.976,24,25,29.97,30,48,50,59.94,60,72,75,90,100,120 or a number between 1 and 1000`). Be aware that not specifying a framerate lets HandBrake preserve a source's time stamps, potentially creating variable framerate video

#### vfr, cfr, pfr

Select variable, constant or peak-limited frame rate control. VFR preserves the source timing. CFR makes the output constant rate at the rate given by the -r flag (or the source's average rate if no -r is given). PFR doesn't allow the rate to go over the rate specified with the -r flag but won't change the source timing if it's below that rate. If none of these flags are given, the default is --pfr when -r is given and --vfr otherwise

More at https://handbrake.fr/docs/en/1.0.0/cli/cli-guide.html

License

MIT © Rafael Milewski