EncoderSettingsNVENCHEVC
Electron APIs / Recorder / EncoderSettingsNVENCHEVC
NVENC HEVC (H.265) encoder settings.
Extends EncoderSettingsNVENC with options specific to the HEVC codec.
See
Extends
Properties
| Property | Type | Description | Overrides |
|---|---|---|---|
bf? | number | Number of B-frames to use. Controls the number of bidirectional frames between I/P frames. Default 2 | - |
bitrate? | number | Target encoding bitrate in kilobits per second (kbps). Default 8000 | - |
gpu? | number | Index of the GPU used for encoding. Useful when multiple GPUs are installed. Default 0 | - |
keyint_sec? | number | Keyframe interval, in seconds. Defines how frequently a keyframe (I-frame) is inserted into the video stream. - 0 — Automatically selected by the encoder. - Recommended values: 2 for high quality/editability, 4 for reduced file size. - 1 — Suitable for short replays or splitting, but more CPU/GPU intensive. Balances quality, file size, and streaming performance. | - |
lookahead? | boolean | Enables dynamic B-frames (lookahead). If true, the encoder dynamically determines the number of B-frames up to bf. Improves quality but increases GPU usage. Default false | - |
max_bitrate? | number | Maximum bitrate in kilobits per second (kbps). Caps the bitrate for encoders using variable bitrate modes (e.g., VBR). | - |
multipass? | kNVENCEncoderMultipass | Multipass encoding strategy. - 'qres' — Two Passes (Quarter Resolution) - 'disabled' — Single Pass - 'fullres' — Two Passes (Full Resolution) Default 'qres' See kNVENCEncoderMultipass | - |
preset? | "p1" | "p2" | "p3" | "p4" | "p5" | "p6" | "p7" | Encoding quality preset. Affects encoding speed vs. output quality. - 'p1' — Fastest (Lowest Quality) - 'p2' — Faster (Lower Quality) - 'p3' — Fast (Low Quality) - 'p4' — Medium (Medium Quality) - 'p5' — Slow (Good Quality) (Default) - 'p6' — Slower (Better Quality) - 'p7' — Slowest (Best Quality) Default 'p5' | - |
profile? | any | HEVC encoding profile. Determines the compression tools and compatibility for H.265 encoding. Options include: - 'main' — Standard profile for HEVC encoding. - 'main10' — Enables 10-bit encoding for higher color depth. Default 'main' See kNVENCEncoderProfileHEVC | EncoderSettingsNVENC.profile |
psycho_aq? | boolean | Enables psycho-visual tuning. Improves perceived visual quality by adjusting bit allocation. Default true | - |
rate_control? | kNVENCEncoderRateControl | Rate control method used by the encoder. Controls how bitrate is allocated during encoding. Default 'CBR' See kNVENCEncoderRateControl | - |
tune? | kNVENCEncoderTuning | Tuning mode for encoding optimization. Common values: - 'hq' — High Quality (Default) - 'll' — Low Latency - 'ull' — Ultra Low Latency Default 'hq' See kNVENCEncoderTuning | - |
type | kSupportedEncodersTypes | The selected video encoder type. See kSupportedEncodersTypes | - |