EncoderSettingsNVENC
Electron APIs / Recorder / EncoderSettingsNVENC
NVENC encoder settings.
Configuration specific to NVIDIA's NVENC hardware video encoder. Extends base video encoding options.
Extends
Extended by
Properties
| Property | Type | Description |
|---|---|---|
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 | Encoding profile. Defines the encoding features and compatibility level. Common options include: - 'baseline' - 'main' - 'high' Default 'main' |
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 |