README.md 2.56 KB
Newer Older
1 2 3 4
# 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.

5 6 7 8
* [Installation](#installation)
    * [Installation from official packages](#installation-from-official-packages)
    * [Installation from sources](#installation-from-sources)
* [Usage](#usage)
9 10
    * [From GUI using gddccontrol](#from-gui-using-gddccontrol)
    * [From command line using ddccontrol](#from-command-line-using-ddccontrol)
11 12
* [License](#license)

13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58
## 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`:

```shell
sudo apt install ddccontrol ddccontrol-db gddccontrol
```

Instructions for other distributions will be prepared later.

### Installation from sources

Install build depedencies (on Ubuntu):

```shell
sudo apt install intltool
```

Instructions for dependecies installation will be prepared later.

Latest repository can be cloned and built by:

```shell
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:

```shell
sudo make install
```

## Usage

Monitor database is used indirectly with `ddccontrol` and `gddccontrol` utilities.

59
### From GUI using gddccontrol
60

61 62 63
`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.
64 65 66 67 68 69 70

Utility can launched directly from commandline:

```shell
sudo gddccontrol
```

71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89
### From command line using ddccontrol

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

```shell
sudo ddccontrol -p
```

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

```shell
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`:

```shell
sudo ddccontrol -r 0x10 -w 75 dev:/dev/i2c-4
```
90

91
See `ddccontrol -h` for more information.
92 93 94

## License

95
The project is licensed under `GNU General Public License v2.0` license. See [COPYING](COPYING) for details.