x265 settings map
x265 answers to more than three hundred long options. This page lists 60 of them by the stage of the encoder each acts on, with x265's default and a link to the page that explains the tool. It is thinner than the x264 map in one respect: for 35 of the 60 this course read only that the option exists and what its default is, and the map says which.
Browse a stage
Choose a stage to list its options. The stages follow the order of the course, from input and color through entropy coding and the in-loop filter to rate control and the stream. The defaults are x265's starting values at the commit linked, which are also its medium preset; presets, tunings, your own options, input handling and x265's checks can change what takes effect. Under --preset ultrafast an omitted --ref starts at 1, and under veryslow at 5, not the 3 shown. "Unset" means the mode is not active, not that nothing is stored: x265 keeps 32 for --qp while constant rate factor is the mode. The 0 for --min-keyint is the stored starting value; what x265 makes of it was not read. "Set by presets" keeps only the options that at least one of the ten presets changes. A star marks an option whose default and presence were read in x265 and nothing more: the page it links to explains the idea, usually as x264 does it.
| Option and default | Purpose |
|---|
Star: the link explains the idea; x265's own behavior was not traced. The four counts below are for the whole stage, except Pages linked, which counts the rows shown.
x265_param_default and the preset marks in x265_param_default_preset. Starred descriptions name the idea only; they are not statements about x265's code.Where the options act
--no-cabac.- Presets set 27 of these 60 options, against 17 of the 60 on the x264 map: all 8 for prediction and 7 of the 8 for decisions and speed.
- None of the 11 rate control entries here is directly changed by a preset, as on the x264 map. Presets still change the lookahead and adaptive quantization, so they can affect how bits and quality are distributed.
- Behavior was read for 25 of the 60. That covers every option for input and color, for transform and quantization, and for measurement and stream, and none for decisions and speed or for rate control. Those two stages are where this course leans on x264.
Against x264's defaults
The two encoders share option names, and several defaults differ. Each number below is in one of the two maps.
| Option | x264 | x265 |
|---|---|---|
--crf | 23 | 28 |
--bframes | 3 | 4 |
--rc-lookahead | 40 | 20 |
--b-adapt | 1 | 2 |
--open-gop | off | on |
--aq-mode | 1 | 2 |
--psy-rd | 1.0 | 2.0 |
--subme | 7 | 2 |
--merange | 16 | 57 |
The same number does not mean the same thing in both. The two rate factor scales, the two --subme scales and the two psychovisual strengths are each encoder's own, so a setting cannot be carried across by copying its value.
What the map leaves out
Weighted prediction, merge candidates, sign hiding, transform skip and most of x265's analysis options are not here because no page of this course covers them. Neither are threading, the labels for color and high dynamic range, or the options for reusing analysis between encodes.
Sources
Read 2026-11-15, at the commit linked.
- x265 at commit 4191822:
x265_param_default, where every default in the table was read, andx265_param_default_presetinsource/common/param.cpp; the option table insource/x265cli.h, which has 325 entries counting each--no-form and, searched 2026-11-16, no switch between entropy coders. Read 2026-11-16 insource/common/param.cpp: the quantizer stored while constant rate factor is the mode and the starting value ofmin-keyint. The x264 column of the comparison is from the x264 map's sources. - For
--rc-lookahead, read 2026-11-15 at the same commit, insource/encoder/slicetype.cpp: the queue length set from it, frame types decided once that many frames are queued, the search limited to that many frames and frames released once that many, plus the B frame limit and two, have come in. - Not checked: the behavior of every starred option; the defaults of
--input-csp,--ditherand--scaling-listbeyond what the pages they link to cite; x265's tunings; the options left out.