COM.DDCUTIL.DDCU(7)

📦 version 1.0.14, in nixpkgs unstable, opensuse-leap 16.0

✨ com.ddcutil.DdcutilInterface ✨

okay bestie, welcome to COM.DDCUTIL.DDCU(7) — this is the manual page for the D-Bus service named com.ddcutil.DdcutilInterface, and it's literally the virtual control panel era of your monitor dreams. 💖

🎀 NAME 🎀

com.ddcutil.DdcutilInterface — D-Bus service for libddcutil VESA DDC Monitor Virtual Control Panel.

✨ METHODS ✨

here's the whole squad of methods, bestie. signatures stay exactly as they are because we do not mess with types. 💅

Restart                 (IN  s             text_options,
                         IN  u             syslog_level,
                         IN  u             flags,
                         OUT i             error_status,
                         OUT s             error_message);
Detect                  (IN  u             flags,
                         OUT i             number_of_displays,
                         OUT a(iiisssqsu)  detected_displays,
                         OUT i             error_status,
                         OUT s             error_message);
ListDetected            (IN  u             flags,
                         OUT i             number_of_displays,
                         OUT a(iiisssqsu)  detected_displays,
                         OUT i             error_status,
                         OUT s             error_message);
GetVcp                  (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  y             vcp_code,
                         IN  u             flags,
                         OUT q             vcp_current_value,
                         OUT q             vcp_max_value,
                         OUT s             vcp_formatted_value,
                         OUT i             error_status,
                         OUT s             error_message);
GetMultipleVcp          (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  ay            vcp_code,
                         IN  u             flags,
                         OUT a(yqqs)       vcp_current_value,
                         OUT i             error_status,
                         OUT s             error_message);
SetVcp                  (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  y             vcp_code,
                         IN  q             vcp_new_value,
                         IN  u             flags,
                         OUT i             error_status,
                         OUT s             error_message);
SetVcpWithContext       (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  y             vcp_code,
                         IN  q             vcp_new_value,
                         IN  s             client_context,
                         IN  u             flags,
                         OUT i             error_status,
                         OUT s             error_message);
GetVcpMetadata          (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  y             vcp_code,
                         IN  u             flags,
                         OUT s             feature_name,
                         OUT s             feature_description,
                         OUT b             is_read_only,
                         OUT b             is_write_only,
                         OUT b             is_rw,
                         OUT b             is_complex,
                         OUT b             is_continuous,
                         OUT i             error_status,
                         OUT s             error_message);
GetCapabilitiesString   (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  u             flags,
                         OUT s             capabilities_text,
                         OUT i             error_status,
                         OUT s             error_message);
GetCapabilitiesMetadata (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  u             flags,
                         OUT s             model_name,
                         OUT y             mccs_major,
                         OUT y             mccs_minor,
                         OUT a{ys}         commands,
                         OUT a{y(ssa{ys})} capabilities,
                         OUT i             error_status,
                         OUT s             error_message);
GetDisplayState         (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  u             flags,
                         OUT i             status,
                         OUT s             message);
GetSleepMultiplier      (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  u             flags,
                         OUT d             current_multiplier,
                         OUT i             error_status,
                         OUT s             error_message);
SetSleepMultiplier      (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  d             new_multiplier,
                         IN  u             flags,
                         OUT i             error_status,
                         OUT s             error_message);

🦋 SIGNALS 🦋

these are the little notifications the service can send out into the group chat. 🫶

ConnectedDisplaysChanged (s edid_txt,
                          i event_type,
                          u flags);
VcpValueChanged          (i display_number,
                          s edid_txt,
                          y vcp_code,
                          q vcp_new_value,
                          s source_client_name,
                          s source_client_context,
                          u flags);
ServiceInitialized       (u flags);

🌸 PROPERTIES 🌸

these are the readable/readwrite properties, with their exact types. no cap. ✨

AttributesReturnedByDetect — readable as
StatusValues — readable a{is}
DdcutilVersion — readable s
DdcutilDynamicSleep — readwrite b
DdcutilOutputLevel — readwrite u
DisplayEventTypes — readable a{is}
ServiceInterfaceVersion — readable s
ServiceInfoLogging — readwrite b
ServiceEmitConnectivitySignals — readwrite b
ServiceEmitSignals — readwrite b
ServiceFlagOptions — readable a{is}
ServiceParametersLocked — readable b
ServicePollInterval — readwrite u
ServicePollCascadeInterval — readwrite d

💖 DESCRIPTION 💖

okay so ddcutil-service is a D-Bus service wrapper for libddcutil which implements the VESA DDC Monitor Control Command Set. most things that can be controlled using a monitor's on-screen display can be controlled by this service. iconic, honestly. 👑

for many of the methods a VDU can be specified by either passing the DDC display_number or DDC EDID. the EDID is the more stable identifier, it remains unchanged if the number of connected or powered-up VDUs changes, whereas the DDCA display numbers may be reallocated. when passing an EDID, pass -1 for display_number, otherwise both are tied with the display_number having precedence. iykyk. 🦋

methods that accept an base-64 encoded EDID will accept a prefix of the EDID when passed a flags value of 1. this is intended as a convenience for passing EDIDs on the command line. periodt. 💅

👑 METHOD DETAILS 👑

💅 The Restart() method

Restart (IN  s text_options,
         IN  u syslog_level,
         IN  u flags,
         OUT i error_status,
         OUT s error_message);

restarts the service with the supplied parameters. simple as that. ✨

if the service is configuration-locked, an com.ddcutil.DdcutilService.Error.ConfigurationLocked error is raised. so yeah, that's the locked-door moment. 🔐

IN s text_options — text options to be passed to libddcutil ddca_init().
IN u syslog_level — the libddcutil syslog level.
IN u flags — for future use.
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred.
OUT s error_message — text message for error_status.

🎀 The Detect() method

Detect (IN  u            flags,
        OUT i            number_of_displays,
        OUT a(iiisssqsu) detected_displays,
        OUT i            error_status,
        OUT s            error_message);

issues a detect and returns the VDUs detected. it's giving main character energy for your monitor lineup. 👑

the array detected_displays will be of length number_of_displays.

each element of detected_displays array will contain the fields specified by the AttributesReturnedByDetect property. the fields will include the libddcutil display-number and a base64-encoded EDID.

IN u flags — if set to 8 (DETECT_ALL), any invalid VDUs will be included in the results.
OUT i number_of_displays — the number of VDUs detected (the length of detected_displays).
OUT a(iiisssqsu) detected_displays — an array of structures describing the VDUs.
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred.
OUT s error_message — text message for error_status.

🦋 The ListDetected() method

ListDetected (IN  u            flags,
              OUT i            number_of_displays,
              OUT a(iiisssqsu) detected_displays,
              OUT i            error_status,
              OUT s            error_message);

returns the currently detected VDUs without performing using a new detect. this method is particularly useful for libddcutil 2.2+ where detection may occur in the background automatically. lowkey convenient. 🌈

the array detected_displays will be of length number_of_displays.

IN u flags — for future use
OUT i number_of_displays — no extra description in the source, just the count, bestie. 🫶
OUT a(iiisssqsu) detected_displays — an array of structures describing the VDUs.
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred.
OUT s error_message — text message for error_status.
OUT s error_message — text message for error_status.

The `GetVcp()` method 💖

GetVcp (IN  i display_number,
        IN  s edid_txt,
        IN  y vcp_code,
        IN  u flags,
        OUT q vcp_current_value,
        OUT q vcp_max_value,
        OUT s vcp_formatted_value,
        OUT i error_status,
        OUT s error_message);

Okay so this one retrieves the value for a VCP-code for the specified VDU.

For simplicity, the returned vcp_current_value will always be a 16 bit integer. Most VCP values are single byte 8-bit integers, and very few are two-byte 16-bit.

The method’s flags parameter can be set to 2 (RETURN_RAW_VALUE) — see ddcutil-service.1 LIMITATIONS for the explanation, bestie.

The vcp_formatted_value contains the current value along with any related info, such as the maximum value. It’s similar to the output of the ddcutil getvcp shell-command.

IN i display_number — the libddcutil/ddcutil display number to query.
IN s edid_txt — the base-64 encoded EDID of the display.
IN y vcp_code — the VPC-code to query; for example, 16 (0x10) is brightness.
IN u flags — if 1 (EDID_PREFIX), the edid_txt is matched as a unique prefix of the EDID.
OUT q vcp_current_value — the current numeric value as a unified 16 bit integer.
OUT q vcp_max_value — the maximum possible value, to allow for easy calculation of current/max.
OUT s vcp_formatted_value — a formatted version of the value including related info such as the max-value.
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred.
OUT s error_message — text message for error_status.

The `GetMultipleVcp()` method 🦋

GetMultipleVcp (IN  i       display_number,
                IN  s       edid_txt,
                IN  ay      vcp_code,
                IN  u       flags,
                OUT a(yqqs) vcp_current_value,
                OUT i       error_status,
                OUT s       error_message);

Retrieves several different VCP values for the specified VDU. This is a convenience method provided to more efficiently utilise D-Bus.

Each entry in the vcp_current_value array is a VCP-code along with its current, maximum and formatted values (the same as those returned by GetVcp).

The method’s flags parameter can be set to 2 (RETURN_RAW_VALUES) — yep, plural this time — see ddcutil-service.1 LIMITATIONS for the explanation.

IN i display_number — the libddcutil/ddcutil display number to query.
IN s edid_txt — the base-64 encoded EDID of the display.
IN ay vcp_code — the VPC-code to query.
IN u flags — if 1 (EDID_PREFIX), the edid_txt is matched as a unique prefix of the EDID.
OUT a(yqqs) vcp_current_value — an array of VCP-codes and values.
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred.
OUT s error_message — text message for error_status.

The `SetVcp()` method 💅

SetVcp (IN  i display_number,
        IN  s edid_txt,
        IN  y vcp_code,
        IN  q vcp_new_value,
        IN  u flags,
        OUT i error_status,
        OUT s error_message);

Set the value for a VCP-code for the specified VDU.

For simplicity, the vcp_new_value is always passed as a 16 bit integer. Most VCP values are single byte 8-bit integers, and very few are two-byte 16-bit.

The method’s flags parameter can be set to 4 (NO_VERIFY) to disable libddcutil verify and retry. Verification and retry is the default.

IN i display_number — the libddcutil/ddcutil display number to alter.
IN s edid_txt — the base-64 encoded EDID of the display.
IN y vcp_code — the VPC-code to query.
IN q vcp_new_value — the numeric value as a 16 bit integer.
IN u flags — if 1 (EDID_PREFIX), the edid_txt is matched as a unique prefix of the EDID.
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred.
OUT s error_message — text message for error_status.

The `SetVcpWithContext()` method 🎀

SetVcpWithContext (IN  i display_number,
                   IN  s edid_txt,
                   IN  y vcp_code,
                   IN  q vcp_new_value,
                   IN  s client_context,
                   IN  u flags,
                   OUT i error_status,
                   OUT s error_message);

Set the value for a VCP-code for the specified VDU.

For simplicity, the vcp_new_value is always passed as a 16 bit integer. Most VCP values are single byte 8-bit integers, and very few are two-byte 16-bit.

The method’s flags parameter can be set to 4 (NO_VERIFY) to disable libddcutil verify and retry. Verification and retry is the default.

IN i display_number — the libddcutil/ddcutil display number to alter.
IN s edid_txt — the base-64 encoded EDID of the display.
IN y vcp_code — the VPC-code to query.
IN q vcp_new_value — the numeric value as a 16 bit integer.
IN s client_context — a client-context string that will be returned with the VcpValueChanged signal.
IN u flags — if 1 (EDID_PREFIX), the edid_txt is matched as a unique prefix of the EDID.
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred.
OUT s error_message — text message for error_status.

The `GetVcpMetadata()` method 🌸

GetVcpMetadata (IN  i display_number,
                IN  s edid_txt,
                IN  y vcp_code,
                IN  u flags,
                OUT s feature_name,
                OUT s feature_description,
                OUT b is_read_only,
                OUT b is_write_only,
                OUT b is_rw,
                OUT b is_complex,
                OUT b is_continuous,
                OUT i error_status,
                OUT s error_message);

Retrieve the metadata for a VCP-code for the specified VDU. Metadata era ✨

IN i display_number — the libddcutil/ddcutil display number to query.
IN s edid_txt — the base-64 encoded EDID of the display.
IN y vcp_code — the VPC-code to query.
IN u flags — if 1 (EDID_PREFIX), the edid_txt is matched as a unique prefix of the EDID.
OUT s feature_name — the feature name for the VCP-code.
OUT s feature_description — the feature description, if any, of the VCP-code.
OUT b is_read_only — true if the feature is read-only.
OUT b is_write_only — true if the feature is write-only (for example, a code that turns the VDU off).
OUT b is_rw — true if the feature is readable and writable.
OUT b is_complex — true if the feature is complex (multi-byte).
OUT b is_continuous — true if the feature is a continuous value (it is not an enumeration).
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred.
OUT s error_message — text message for error_status.

The `GetCapabilitiesString()` method 🌈

GetCapabilitiesString (IN  i display_number,
                       IN  s edid_txt,
                       IN  u flags,
                       OUT s capabilities_text,
                       OUT i error_status,
                       OUT s error_message);

Retrieve the capabilities metadata for a VDU in a format similar to that output by the command ddcutil terse capabilities (similar enough for parsing by common code).

IN i display_number — the libddcutil/ddcutil display number to query.
IN s edid_txt — the base-64 encoded EDID of the display.
IN u flags — if 1 (EDID_PREFIX), the edid_txt is matched as a unique prefix of the EDID.
OUT s capabilities_text — the capability string for the VDU.
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred.
OUT s error_message — text message for error_status.

The `GetCapabilitiesMetadata()` method 👑

GetCapabilitiesMetadata (IN  i             display_number,
                         IN  s             edid_txt,
                         IN  u             flags,
                         OUT s             model_name,
                         OUT y             mccs_major,
                         OUT y             mccs_minor,
                         OUT a{ys}         commands,
                         OUT a{y(ssa{ys})} capabilities,
                         OUT i             error_status,
                         OUT s             error_message);

Retrieve the capabilities metadata for a VDU in a parsed dictionary structure indexed by VCP code.

The capabilities out parameter is an array of dictionary entries. Each entry consists of a VCP-code along with a struct containing the feature-name, feature-description, and an array of permitted-values. For features that have continuous values, the associated permitted-value array will be empty. For non-continuous features, the permitted-value array will contain a dictionary entry for each permitted value, each entry containing a permitted-value and value-name. Parsed and organized, periodt 💅

IN i display_number — the libddcutil/ddcutil display number to query.
IN s edid_txt — the base-64 encoded EDID of the display.
IN u flags — if 1 (EDID_PREFIX), the edid_txt is matched as a unique prefix of the EDID.
OUT s model_name — parsed model name string.
OUT y mccs_major — MCCS major version number byte.
OUT y mccs_minor — MCCS minor version number byte.
OUT a{ys} commands — supported commands as a dictionary indexed by command number.
OUT a{y(ssa{ys})} capabilities — supported VCP features as a dictionary indexed by VCP-code.
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred.
OUT s error_message — text message for error_status.

The `GetDisplayState()` method 🫶

GetDisplayState (IN  i display_number,
                 IN  s edid_txt,
                 IN  u flags,
                 OUT i status,
                 OUT s message);

Retrieve the libddcutil display state.

Depending on the hardware and drivers, this method might return anything useful.

For libddcutil prior to 2.1, the method will return a libddcutil error_status of DDCRC_UNIMPLEMENTED. Important caveat, bestie — no cap 🫶

IN i display_number — the libddcutil/ddcutil display number you wanna query 🎀
IN s edid_txt — the base-64 encoded EDID of the display ✨
IN u flags — if it's 1 (EDID_PREFIX), then edid_txt gets matched as a unique prefix of the EDID 🦋
OUT i status — a libddcutil display status 👑
OUT s message — the text message for that display status 💅

🌸 The `GetSleepMultiplier()` method 🌸

GetSleepMultiplier (IN  i display_number,
                    IN  s edid_txt,
                    IN  u flags,
                    OUT d current_multiplier,
                    OUT i error_status,
                    OUT s error_message);

Gets the current libddcutil sleep multiplier for the VDU you specified, bestie 💖

Ngl, in more recent versions of libddcutil this value is generally managed automatically, so you probs won't need it — but it's here 🫶

IN i display_number — the libddcutil/ddcutil display number to query 🌈
IN s edid_txt — the base-64 encoded EDID of the display ⭐
IN u flags — if it's 1 (EDID_PREFIX), the edid_txt is matched as a unique prefix of the EDID 🦋
OUT d current_multiplier — the sleep multiplier 😴
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred ✅
OUT s error_message — text message for error_status 💬

💜 The `SetSleepMultiplier()` method 💜

SetSleepMultiplier (IN  i display_number,
                    IN  s edid_txt,
                    IN  d new_multiplier,
                    IN  u flags,
                    OUT i error_status,
                    OUT s error_message);

Sets the libddcutil sleep multiplier for the specified VDU. Periodt 💅

So in more recent versions of libddcutil this is generally managed automatically, but this method exists for when you genuinely need manual control — think problem hardware, the messy kind 😭

If the service is configuration-locked, a com.ddcutil.DdcutilService.Error.ConfigurationLocked error is raised. Locked is locked 🔒

IN i display_number — the libddcutil/ddcutil display number to query 🎀
IN s edid_txt — the base-64 encoded EDID of the display ✨
IN d new_multiplier — the sleep multiplier 😴
IN u flags — if it's 1 (EDID_PREFIX), the edid_txt is matched as a unique prefix of the EDID 🦋
OUT i error_status — a libddcutil DDCRC error status. DDCRC_OK (zero) if no errors have occurred ✅
OUT s error_message — text message for error_status 💬

🔥 SIGNAL DETAILS 🔥

✨ The `ConnectedDisplaysChanged` "signal" ✨

ConnectedDisplaysChanged (s edid_txt,
                          i event_type,
                          u flags);

Where the hardware and drivers support it, this signal fires when a display's connection status changes — cabling, power, or DPMS, any of it 👀

Which of the states listed by the DisplayEventTypes property can actually be signaled is up to the hardware, cabling and drivers (and lowkey there's no way to determine the possibilities programmatically, so don't come for me) 😭

s edid_txt — the base-64 encoded EDID of the display 🎀
i event_type — a value matching one of those from the DisplayEventTypes property ⭐
u flags — for future use 🔮

💀 The `VcpValueChanged` "signal" 💀

VcpValueChanged (i display_number,
                 s edid_txt,
                 y vcp_code,
                 q vcp_new_value,
                 s source_client_name,
                 s source_client_context,
                 u flags);

This signal gets raised when a SetVcp or SetVcpWithContext method call succeeds. Slay, the value actually changed 💅

i display_number — the display number 🔢
s edid_txt — the base-64 encoded EDID of the display ✨
y vcp_code — the VCP code whose value changed 🎯
q vcp_new_value — the new value 🌟
s source_client_name — (no description given in the original, it just sits there being mysterious) 🕵️
s source_client_context — (same deal, no description — iconic cryptic behavior honestly) 🙈
u flags — not currently in use 🚫

👑 The `ServiceInitialized` "signal" 👑

ServiceInitialized (u flags);

Raised when the service is initialized ✨ It gives clients a way to detect restarts and reinstate properties or other settings — so if the service ghosted you and came back, you'll know 🫶

u flags — for future use 🔮

🎀 PROPERTY DETAILS 🎀

🌸 The `AttributesReturnedByDetect` "property" 🌸

AttributesReturnedByDetect  readable   as

The text names of each of the fields in the array of structs returned by the Detect method 📋

🦋 The `StatusValues` "property" 🦋

StatusValues  readable   a{is}

The list of libddcutil status values and their text names that might show up in the error_status out-parameter of most of the service methods 💬

⭐ The `DdcutilVersion` "property" ⭐

DdcutilVersion  readable   s

The ddcutil version number for the linked libddcutil 🏷️

😴 The `DdcutilDynamicSleep` "property" 😴

DdcutilDynamicSleep  readwrite  b

Turns automatic adjustment of the sleep-multiplier on/off 🔁 Before you use the SetSleepMultiplier method, set this property to false to stop any automatic retuning of the multiplier. Trust, you want that off first 💅

🔊 The `DdcutilOutputLevel` "property" 🔊

DdcutilOutputLevel  readwrite  u

Changes the libddcutil diagnostic output-level 🗣️ See the libddcutil/ddcutil documentation for the details, iykyk 📚

🌈 The `DisplayEventTypes` "property" 🌈

DisplayEventTypes  readable   a{is}

A list of the event types sent by the ConnectedDisplaysChanged signal, along with their text names 🗂️ Events are included for display connection/disconnection (hotplug), DPMS-sleep, and DPMS-wake 🌙

If the list is empty, that means the GPU, GPU-driver, or libddcutil version does not support display event detection. Sad but valid 😭

💖 The `ServiceInterfaceVersion` "property" 💖

ServiceInterfaceVersion  readable   s

The interface version of this service 🏷️ As long as the major number stays the same, the service stays backward compatible with existing clients 🫶

📝 The `ServiceInfoLogging` "property" 📝

ServiceInfoLogging  readwrite  b

Enables/disables info and debug level logging inside the service executable 🪵 (the service uses glib logging, fyi) ✨

📡 The `ServiceEmitConnectivitySignals` "property" 📡

ServiceEmitConnectivitySignals  readwrite  b

Because VDU connectivity change detection involves some polling, this property lets you disable it when it's unecessary 📴 Like, for example, when the configuration of VDUs is fixed and nothing's ever gonna change 💅

💀 The `ServiceEmitSignals` "property" 💀

ServiceEmitSignals  readwrite  b

Deprecated 😬 The name was too generic, so it got replaced by ServiceEmitConnectivitySignals. RIP to a real one 🪦

🚩 The `ServiceFlagOptions` "property" 🚩

ServiceFlagOptions  readable   a{is}

The list of available flag values that can be passed to the service methods 🏳️ Just know that not all options apply to all methods — read the room 👀

🔒 The `ServiceParametersLocked` "property" 🔒

ServiceParametersLocked  readable   b

Tells you whether the lock command line argument has been used to prevent configuration changes via method calls and property changes 🚫 The whole vibe check of "can I change this or not" 💅

⏱️ The `ServicePollInterval` "property" ⏱️

ServicePollInterval  readwrite  u

Query or set the display change detection poll-interval performed by the service (minimum 10 seconds, zero to disable polling) 🕰️

If libddcutil supports change detection and it actually works for the hardware, drivers and cabling in use, then the service's internal polling may be unecessary — in that case, turn polling off by setting the interval to zero 0️⃣

🌊 The `ServicePollCascadeInterval` "property" 🌊

ServicePollCascadeInterval  readwrite  d

Query or set the display change detection poll-cascade-interval (minimum 0.1 seconds) ⏳ When you're dealing with a cascade of events — say, several VDUs all set to DPMS sleep at once — polling happens more frequently until the cascade is cleared 🌀

👑 AUTHOR 👑

Michael Hamilton 🫶

📜 COPYRIGHT 📜

ddcutil‐service is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version 💖

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details 👀

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA 📬

That's the whole page bestie, you made it 🎉 This drop is from the ddcutil-service source, version 12/19/2024 — go forth and slay your displays 💅✨🎀

📦 where this page comes from

nixpkgs unstable: ddcutil-service 1.0.15
opensuse-leap 16.0: ddcutil-service 1.0.14-bp160.1.4 · GPL-2.0-or-later
opensuse-leap 16.0: ddcutil-service 1.0.14-bp160.1.4 · GPL-2.0-or-later
opensuse-leap 16.0: ddcutil-service 1.0.14-bp160.1.4 · GPL-2.0-or-later
opensuse-leap 16.0: ddcutil-service 1.0.14-bp160.1.4 · GPL-2.0-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms

COM.DDCUTIL.DDCU(7)

✨ com.ddcutil.DdcutilInterface ✨

🎀 NAME 🎀

✨ METHODS ✨

🦋 SIGNALS 🦋

🌸 PROPERTIES 🌸

💖 DESCRIPTION 💖

👑 METHOD DETAILS 👑

💅 The Restart() method

🎀 The Detect() method

🦋 The ListDetected() method

The GetVcp() method 💖

The GetMultipleVcp() method 🦋

The SetVcp() method 💅

The SetVcpWithContext() method 🎀

The GetVcpMetadata() method 🌸

The GetCapabilitiesString() method 🌈

The GetCapabilitiesMetadata() method 👑

The GetDisplayState() method 🫶

🌸 The GetSleepMultiplier() method 🌸

💜 The SetSleepMultiplier() method 💜

🔥 SIGNAL DETAILS 🔥

✨ The ConnectedDisplaysChanged "signal" ✨

💀 The VcpValueChanged "signal" 💀

👑 The ServiceInitialized "signal" 👑

🎀 PROPERTY DETAILS 🎀

🌸 The AttributesReturnedByDetect "property" 🌸

🦋 The StatusValues "property" 🦋

⭐ The DdcutilVersion "property" ⭐

😴 The DdcutilDynamicSleep "property" 😴

🔊 The DdcutilOutputLevel "property" 🔊

🌈 The DisplayEventTypes "property" 🌈

💖 The ServiceInterfaceVersion "property" 💖

📝 The ServiceInfoLogging "property" 📝

📡 The ServiceEmitConnectivitySignals "property" 📡

💀 The ServiceEmitSignals "property" 💀

🚩 The ServiceFlagOptions "property" 🚩

🔒 The ServiceParametersLocked "property" 🔒

⏱️ The ServicePollInterval "property" ⏱️

🌊 The ServicePollCascadeInterval "property" 🌊