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

New in version v1.3.0

For setting the dithering mode when the #state is enabled, use the following environment and enum numbers in the 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

New in version v1.3.0

For setting the dithering depth when the #state is enabled, use the following environment and enum numbers in the 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.