Skip to content

Dithering

Some users have issues with dithering causing flickering or artifacts on their displays (1) (2), or may prefer it enabled - which also lacks a Wayland option to disable in nvidia-settings.

Since nvibrant already sets up most of the work, I also included options for it 🙂

State

For enabling or disabling dithering in monitors, use the following numbers in args:

$ ATTRIBUTE=dithering nvibrant (...)

1
2
3
4
5
enum NvKmsDpyAttributeRequestedDitheringValue {
    NV_KMS_DPY_ATTRIBUTE_REQUESTED_DITHERING_AUTO = 0,
    NV_KMS_DPY_ATTRIBUTE_REQUESTED_DITHERING_ENABLED = 1,
    NV_KMS_DPY_ATTRIBUTE_REQUESTED_DITHERING_DISABLED = 2,
};

Default value is (2), disabling on all monitors without input arguments.

For enabling in certain or all monitors, similar to vibrance levels, adapt to your setup:

$ ATTRIBUTE=dithering nvibrant 0 2 2 1
$ ATTRIBUTE=dithering nvibrant 1 1 1 1

Mode

Only in git main builds, next patch release will include this option.

For setting the dithering mode when enabled, use the following numbers in args:

$ ATTRIBUTE=dithering-mode nvibrant (...)

1
2
3
4
5
6
enum NvKmsDpyAttributeCurrentDitheringModeValue {
    NV_KMS_DPY_ATTRIBUTE_CURRENT_DITHERING_MODE_NONE = 0,
    NV_KMS_DPY_ATTRIBUTE_CURRENT_DITHERING_MODE_DYNAMIC_2X2 = 1,
    NV_KMS_DPY_ATTRIBUTE_CURRENT_DITHERING_MODE_STATIC_2X2 = 2,
    NV_KMS_DPY_ATTRIBUTE_CURRENT_DITHERING_MODE_TEMPORAL = 3,
};

Default value in nvibrant is (0), unsure about the driver.

Depth

Only in git main builds, next patch release will include this option.

For setting the dithering depth when enabled, use the following numbers in args:

$ ATTRIBUTE=dithering-depth nvibrant (...)

1
2
3
4
5
6
enum NvKmsDpyAttributeRequestedDitheringDepthValue {
    NV_KMS_DPY_ATTRIBUTE_REQUESTED_DITHERING_DEPTH_AUTO = 0,
    NV_KMS_DPY_ATTRIBUTE_REQUESTED_DITHERING_DEPTH_6_BITS = 1,
    NV_KMS_DPY_ATTRIBUTE_REQUESTED_DITHERING_DEPTH_8_BITS = 2,
    NV_KMS_DPY_ATTRIBUTE_REQUESTED_DITHERING_DEPTH_10_BITS = 3,
};

Default value in nvibrant is (0), likely in the driver too.