Project ddccontrol-db contains database of monitor descriptors, which are used by ddccontrol and gddccontrol utilities to control monitor parameters using DDC/CI protocol.
The most convenient way to install ddccontrol-db is to use packages from official distribution repositories.
Manual installation is more complicated, but contains latest monitor profiles.
On Ubuntu based distrubtions ddccontrol-db, along with utilities, can be installed using apt:
sudo apt install ddccontrol ddccontrol-db gddccontrolInstructions for other distributions will be prepared later.
Release archives contain the generated database and compiled translations. On
Ubuntu, only make is needed to install one:
sudo apt install makeBuilding directly from a Git checkout also requires GNU gettext to compile the translations:
sudo apt install gettext makeThe handwritten Makefile is tested with both GNU Make and BSD bmake.
Latest repository can be cloned and built by:
git clone https://github.com/ddccontrol/ddccontrol-db.git
cd ddccontrol-db
./configure --prefix=/usr
makeFinally, the build can be installed using:
sudo make installPackagers can stage an installation with DESTDIR, for example:
make install DESTDIR="$pkgdir"See INSTALL for all supported installation variables and
maintainer targets.
Monitor database is used indirectly with ddccontrol and gddccontrol utilities.
gddccontrol is a graphical utility for monitor configuration. It is called Monitor Settings in list of applications.
Currently, root privileges are required to control monitor parameters, therefore the launcher automatically asks for a password.
Utility can launched directly from commandline:
sudo gddccontrolddccontrol allows monitor configuration directly from commandline. To probe I2C devices to find monitor buses use:
sudo ddccontrol -pTo read value of control 0x10 (brightness on VESA compliant monitors) for device dev:/dev/i2c-4:
sudo ddccontrol -r 0x10 dev:/dev/i2c-4To set value of control 0x10 (brightness on VESA compliant monitors) to 75 for device dev:/dev/i2c-4:
sudo ddccontrol -r 0x10 -w 75 dev:/dev/i2c-4See ddccontrol -h for more information.
See doc/how-to-add-a-monitor.md for a hands-on introduction on how to add a monitor.
The project is licensed under GNU General Public License v2.0 license. See COPYING for details.