vgropp / ddccontrol-db

DDC Control Monitor Database

DDC/CI control database

Project ddccontrol-db contains database of monitor descriptors, which are used by ddccontrol and gddccontrol utilities to control monitor parameters using DDC/CI protocol.

• Installation
  • Installation from official packages
  • Installation from sources
• Usage
  • From GUI using gddccontrol
  • From command line using ddccontrol
• Contributing
• License

Installation

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.

Installation from official packages

On Ubuntu based distrubtions ddccontrol-db, along with utilities, can be installed using apt:

sudo apt install ddccontrol ddccontrol-db gddccontrol

Instructions for other distributions will be prepared later.

Installation from sources

Install build depedencies (on Ubuntu):

sudo apt install intltool libtool m4 automake autopoint

Instructions for dependecies installation will be prepared later.

Latest repository can be cloned and built by:

git clone https://github.com/ddccontrol/ddccontrol-db.git
cd ddccontrol-db
./autogen.sh 
./configure --prefix=/usr/
make

Finally, the build can be installed using:

sudo make install

Usage

Monitor database is used indirectly with ddccontrol and gddccontrol utilities.

From GUI using gddccontrol

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 gddccontrol

From command line using ddccontrol

ddccontrol allows monitor configuration directly from commandline. To probe I2C devices to find monitor buses use:

sudo ddccontrol -p

To read value of control 0x10 (brightness on VESA compliant monitors) for device dev:/dev/i2c-4:

sudo ddccontrol -r 0x10 dev:/dev/i2c-4

To 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-4

See ddccontrol -h for more information.

Contributing

See doc/how-to-add-a-monitor.md for a hands-on introduction on how to add a monitor.

License

The project is licensed under GNU General Public License v2.0 license. See COPYING for details.