Skip to content

haroldthegray/ddccontrol-db

 
 

Repository files navigation

Build Status

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

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.

About

DDC Control Monitor Database

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 64.3%
  • Makefile 17.6%
  • M4 7.6%
  • sed 5.8%
  • Perl 4.7%