Post-Installation Checklist

This page outlines steps that may be required to configure ddcutil after it has been installed.

Kernel Module i2c-dev

ddcutil requires kernel module i2c-dev. If it is not built into your kernel, it must be loaded explicly. To do so, add a file into directory /etc/modules-load.d with the single line:

i2c-dev

For details, see Kernel Module Configuration.

I2C Device Permissions

Permissions must be granted in order for users other than root to run ddcutil.

On some distributions, including Debian and Ubuntu, all /dev/i2c devices are assigned to group i2c by installation of required package i2c-tools. All that is necessary is to add ddcutil users to group i2c:

$ sudo usermod <user-name> -aG i2c 

If installing from some other distribution or from source, additional configuration may be required. See I2C Device Permissions.

Proprietary Nvidia Driver

The proprietary Nvidia video driver sometimes requires special settings for I2C communication. See Special Nvidia Driver Settings.

Configuration Diagnostics

If ddcutil installs successfully but execution fails, command ddcutil environment can be used to probe the I2C environment and may provide clues as to the problem. For USB connected monitors, use command ddcutil usbenvironment. See Secondary Commands.

Linux command i2cdetect (found in required package i2ctools) provides an independent check of whether the DDC slave address (X37) is active on an I2C bus.

Shared Library Configuration

When installing from source, additional configuration may be required to use shared library libddcutil if it is installed under /usr/local. See Shared Library Configuration. Note that libddcutil is NOT required to run ddcutil.

Additional Information

See also ddcutil Configuration.