ddcui(1)

✨ ddcui — GUI for ddcutil ✨

okay bestie, welcome to the General Commands Manual entry for ddcui, and no cap, it's a good one. sit down, grab a strawberry 🍓, we're gonna talk about clicking buttons on your monitor.

---

🌸 NAME 🌸

ddcui — the GUI for ddcutil. that's it. that's the whole name section. iconic brevity. 💅

---

🦋 SYNOPSIS 🦋

ddcui [options]

like, that's the whole vibe. you run it, you pass it some options, it does its thing. periodt.

---

💖 DESCRIPTION 💖

so ddcui gives you a graphical user interface to a monitor's Virtual Control Panel, aka the VCP. it talks the DDC/CI protocol over an I2C bus that's connected to the monitor. normally your video driver exposes one or more I2C buses as devices named /dev/i2c-n. yes, literally that path, no notes. 🫶

the Virtual Control Panel features come from the Monitor Control Command Set, aka MCCS. here's the tea: monitors only implement <em>some subset</em> of those features. every single feature gets identified by one byte. for example, feature x10 is the brightness control. slay. ✨

---

🎀 OPTIONS 🎀

🌈 Options that change initial settings for the Feature Selection dialog

• --feature-set name — the initial feature set to show. the big three you'll actually care about are MCCS (all features defined in MCCS), MANUFACTURER (features in the manufacturer reserved range xe0..xff), and COLOR (color related features). want the complete list? run --help, bestie. and unless you also passed --custom-feature-set, the default is MCCS.
• --custom-feature-set (feature code..) — you get to explicitly name the features you want shown. feature codes go in as 2 byte hex numbers, with or without a leading "x" or a trailing "h". to list more than one, separate the codes with commas or blanks and wrap the whole list in quotation marks. example incoming:

--custom-feature-set "10 x12 14h"

• --only-capabilities — restrict the features to just the ones in the capabilities string. this one applies when the feature set is MCCS, COLOR, or MANUFACTURER.
• --all-capabilities — always include the features found in the capabilities string. applies when the feature set is MCCS.
• --show-unsupported — display unsupported features in the feature set. normally, unsupported features are not shown at all. 🙈

🧚 Option that changes initial settings for the NC Values Source dialog

• --nc-values-source MCCS|CAPABILITIES|BOTH — this is the source of the values shown in the drop down menu for simple Non-Continuous features.
• --use-latest-nc-values — always use values from the latest MCCS version. ⭐

👑 Option for initial display selection

• --model model-name — the model name as specified in the monitor's EDID and shown on the toolbar.

💜 Miscellaneous options

• --styles — list the available Qt styles.
• --style style-name — pick the Qt style to use.
• --version, -v — report version information.
• --help — get command line help.

🔥 Options that are passed to the ddcutil shared library

fr fr, these correspond to ddcutil command line options of the same name:

• --ddc — report DDC protocol and data errors to the terminal.
• --trace trace-group-name — trace all functions in a trace group. may be specified more than once.
• --trcfile simple-file-name — trace all traceable functions in a file. may be specified more than once.
• --trcfunc function name — trace a single function. may be specified more than once.
• --timestamp | --ts — prefix trace messages with a timestamp.
• --thread-id | --tid — prefix trace messages with the thread id.

---

💀 STATUS CODES 💀

normally it returns 0. it returns 1 if there's a failure. 😭

using the --help option is regarded as success. as it should be. 🫶

---

🌟 SEE_ALSO 🌟

• ddcutil(1)

the project homepage: http://www.ddcutil.com

general ddcui documentation:

http://www.ddcutil.com/ddcui_main

for detailed documentation of the command line options:

http:0.ddcutil.com/ddcui_options

(and yes, bestie, that URL is exactly as written up there — copy it character for character, i don't make the rules 💅)

---

💅 AUTHOR 💅

Sanford Rockowitz (rockowitz at minsoft dot com)

Copyright 2019-2020 Sanford Rockowitz

---

okay that's the whole page, you ate it, you're the main character of monitor configuration now 👑✨

this was the ddcui(1) page from the General Commands Manual, dated 13 June 2020 — mwah, take care of her, she's iconic 🎀🦋💖