DDC Control
Go to file
Barak A. Pearlmutter a43b4c34e8
version in configure.ac (#170)
* version

Gbp-Pq: Name 0001-version.patch

* Update configure.ac

---------

Co-authored-by: Lars Tobias Skjong-Børsting <larstobi@relatime.no>
2024-01-31 10:38:39 +01:00
doc Drop GNOME applet (#157) 2023-10-15 17:51:00 +02:00
man Clarified usage of the `dev:` option. 2018-10-05 14:24:48 -07:00
po Drop GNOME applet (#157) 2023-10-15 17:51:00 +02:00
scripts Code Format: Linux kernel coding style 2018-06-24 15:35:18 +02:00
src Fixed build with gcc-14 (#169) 2024-01-29 22:16:31 +01:00
.gitignore shave two yak hairs (#161) 2023-10-19 12:41:32 +02:00
.travis.yml TravisCI: add automatic code-format check 2018-06-21 22:17:59 +02:00
AUTHORS Updated source copyrights and AUTHORS 2018-02-06 11:44:12 +01:00
CHANGELOG.md Release version 0.5.2 (#102) 2021-05-05 15:03:13 +02:00
COPYING Updated license text with verbatim copy from http://www.gnu.org/licenses/gpl-2.0.txt 2012-09-05 14:38:13 +02:00
CheckList Drop GNOME applet (#157) 2023-10-15 17:51:00 +02:00
Makefile.am Applied ddccontrol-distcheck.patch 2010-10-10 16:31:23 +02:00
NEWS Prepare release 0.4.3 2017-12-27 17:32:34 +01:00
README.md README: Suggest local installation (#156) 2023-10-15 17:49:47 +02:00
TODO Added support to disable daemon use by environment variable 2018-03-31 10:06:35 +02:00
autogen.sh Fixed building with autoconf-2.71 (#98) 2021-05-05 14:50:32 +02:00
commit.sh Moved ddccontrol/* and debian/ddccontrol/* one directory up. 2010-02-13 12:40:41 +01:00
configure.ac version in configure.ac (#170) 2024-01-31 10:38:39 +01:00

README.md

Build Status

DDC/CI control

DDCcontrol is a software used to control monitor parameters, like brightness, contrast, RGB color levels and others.

DDCcontrol consists of:

  • ddccontrol - command-line tool for monitor parameters control
  • gddccontrol - GUI tool for monitor parameters control

Installation

The most convenient way to install DDCcontrol is to use packages from official distribution repositories.

Manual installation is more complicated, but contains latest version of software and more monitor profiles.

Installation from official packages

DDCcontrol tools, ddccontrol and gddccontrol can be installed from official distribution repositories with following command:

  • on Ubuntu/Debian: sudo apt install ddccontrol gddccontrol ddccontrol-db i2c-tools
  • on Fedora: sudo dnf install ddccontrol ddccontrol-gtk
  • on openSUSE: sudo zypper in ddccontrol

You might need to restart your system after installing i2c-tools.

Installation from sources

Install build dependencies:

  • on Ubuntu: sudo apt install intltool i2c-tools libxml2-dev libpci-dev libgtk2.0-dev liblzma-dev
  • on Solus: sudo eopkg install -c system.devel
    sudo eopkg install autoconf automake intltool i2c-tools m4 diffutils libtool-devel xz-devel pciutils-devel libxml2-devel libgtk-2-devel
  • on others: TODO

Clone, build and install built version:

git clone https://github.com/ddccontrol/ddccontrol.git
cd ddccontrol
./autogen.sh
./configure --prefix=/usr/local/ --sysconfdir=/etc --libexecdir=/usr/local/lib
make
sudo make install

Monitor database is required for proper functionality. See for ddccontrol-db installation.

Contributing to the Monitor Database

Follow the instructions on https://github.com/ddccontrol/ddccontrol-db/blob/master/doc/how-to-add-a-monitor.md for inclusion. It often merely involves adapting a few standard capabilities as many pull requests show.

Usage

From GUI using gddccontrol

gddccontrol is a graphical utility for monitor configuration. It is called Monitor Settings in list of applications.

Following configuration is needed to allow non-root user to use gddccontrol:

sudo adduser $USER i2c
sudo /bin/sh -c 'echo i2c-dev >> /etc/modules'

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.

License

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