vdu_controls - a DDC control panel for monitors

A control panel for external monitors (Visual Display Units).

KDE 6 introduced energy saving brighness dimming after 5 minutes of idle time. This may interfere with changes made via vdu_controls, including scheduled-presets and ambient-light-control. The relevant KDE 6 options can be found under System Settings -> System -> Energy Saving.

vdu_controls version 2.0 adds manual ambient-light-level input. This allows all connected VDU's to be simultatiniously adjusted by moving one slider. This is an alternative to fully automatic control via hardware lux-metering. When the ambient-light-level is changed, each VDU us adjusted according to its own custom light-level/brighness profile defined under Settings->Light-Metering. This new option is enabled by default, but can be disabled by unchecking Settings->Lux options enabled.

The second major change in 2.0 is actually far more wide-reaching, but much less visibile. The internal DDC/VDU interface has been rewritten to optionally use the D-Bus ddcutil-service instead of the ddcutil command. The new ddcutil-service is a daemon I've written to interface with libddcutil, it's faster and more responsive than the older command-based implementation. Should the ddcutil-service be unavailable, the DDC/VDU interface reverts to using the ddcutil command. Should you encounter any issues with using the service, Settings->D-Bus client enabled can be used to disable it and force the use of the command.

If you'd like to try the ddcutil-service, builds are available for OpenSUSE Tumbleweed and the Arch AUR:

OpenSUSE Tumbleweed RPM:

https://software.opensuse.org/package/ddcutil-service

AUR (Arch Linux User Repository):

https://aur.archlinux.org/packages/ddcutil-service

Otherwise it's written in C, so you'd need to build and install it. It's one C file. It will build against any libddcutil from 1.4 onward. It doesn't need to be installed as root, it can also be started manually from the command line or installed as a single user D-Bus daemon. For install/build details, see:

https://github.com/digitaltrails/ddcutil-service

The service can be installed for on demand access via the D-BUS daemon. It can also run manually from the command line. Once the service is running, any new instance of vdu_controls should automatically find and connect to the service. When using the service, the bottom line of vdu_controls About Dialog will list ddcutil-interface as 1.0.0 (QtDBus client). Use of the service can be manually toggled via vdu_controls->Settins->dbus client enabled.

The service may also be accessed from generic D-Bus clients such as d-feet dbus-send and busctl.

Description

vdu_controls is a virtual control panel for externally connected VDUs. The application detects DVI, DP, HDMI, or USB connected VDUs. It provides controls for settings such as brightness and contrast.

The application interacts with VDUs via the VESA Display Data Channel (DDC) Virtual Control Panel (VCP) commands set. DDC VCP interactions are mediated by the ddcutil command line utility. Ddcutil provides a robust interface that is tolerant of the vagaries of the many OEM DDC implementations.

By default vdu_controls offers a subset of controls including brightness, contrast and audio controls. Additional controls can be enabled via the Settings dialog.

vdu_controls may optionally run as an entry in the system tray of KDE, Deepin, GNOME, and Xfce (and possibly others). The UI attempts to adapt to the quirks of the different tray implementations.

Named Preset configurations can be saved for later recall. For example, a user could create presets for night, day, photography, movies, and so forth. Presets may be automatically triggered according to solar elevation, and can be further constrained by local weather conditions (as reported by https://wttr.in). Presets may also be activated by UNIX signals.

From any application window, use F1 to access help, and F10 to access the context-menu. The context menu is also available via the right-mouse button in the main-window, the hamburger-menu item on the bottom right of the main window, and the right-mouse button on the system-tray icon. The context-menu provides ALT-key shortcuts for all menu items (subject to sufficient letters being available to support all user defined Presets).

Version 1.10 introduces options for using lux readings from a hardware lux meter (or in some cases a webcam). When lux metering is enabled, vdu_controls can vary brightness according to customisable lux/VDU-brightness profiles. See Lux Metering for more details.

The UI's look-and-feel dynamically adjusts to the desktop theme and desktop environment: light-theme, dark-theme, KDE, Deepin, GNOME, and others.

Does adjusting a VDU affect its lifespan or health?

Repeatably altering VDU settings might affect VDU lifespan. Possible reasons include the consumption of NVRAM write cycles, stressing the VDU power-supply, or increasing the LED panel burn-in.

How many writes VDU NVRAM can accommodate is unknown, it is likely to vary by model and vintage. VDUs from past decades are likely to have NVRAM that can accommodate 10,000 to 100,000+ writes depending on the technology employed. For a ten year lifespan this might indicate a sustainable limit of only 2.7 writes per day or 27 writes per day respectively. Some modern types of NVRAM have upper limits that are for practical purposes unlimited, but the level of uptake of such technologies by the manufacturers is unknown (brighter back-lights, along with scene and gaming options, would appear to require increased durability).

A vintage-2010 VDU, that has been used for four years of intensive testing of vdu_controls, now shows signs of of the NVRAM having bad blocks. After loss of power the VDU will sometimes revert to its factory defaults, but not always, which suggests the NVRAM is being cycled through and only some of it is bad. This experience may indicate a write limit of at least 100,000 for a VDU of this vintage. I've subsequently implemented the initialization-preset feature as a fallback for failed NVRAM, so the problem with this VDU is, for the most part, eliminated.

All that said, vdu_controls does include a number of features that can be used to reduce the frequency of writes to VDU NVRAM:

Inbuilt mitigations:

• Slider and spin-box controls only update the VDU when adjustments become slow or stop (when no change occurs in 0.5 seconds).
• Preset restoration only updates the VDU values that differ from its current values.
• Transitioning effects and transition controls have been disabled by default and are deprecated for version 2.1.0 onward.
• Automatic ambient brightness adjustment only triggers a change when the proposed brightness differs from the current brightness by at least 10%.

Electable mitigations:

• Choose to restore pre-prepared ‘presets’ instead of dragging sliders.
• Refrain from adding transitions to presets.
• If using the ambient-light brightness response curves, tune the settings and curves to avoid frequent small changes.
• If using a light-meter, disengage metered automatic adjustment when faced with rapidly fluctuating levels of ambient brightness.
• Consider adjusting the ambient lighting instead of the VDU.

Monitoring to assist with making adjustments:

• Hovering over a VDU name in the main window reveals a popup that includes the number of VCP (NVRAM) writes.
• The bottom of the About-dialog shows the same numbers. They update dynamically.

Other concerns

Going beyond the standard DDC features by experimenting with undocumented-features or undocumented-values has the potential to make irreversible changes. Consider the potential cost in time and money before trying anything speculative.

The power-supplies in some older VDUs may buzz/squeel audibly when the brightness is turned way down. This may not be a major issue, in normal circumstances older VDUs are often not usable below 85-90% brightness.

Getting Started

The long term affects of repeatably rewriting a VDUs setting are not well understood, but some concerns have been expressed. See below for further details.

To get started with vdu_controls, you only need to download the vdu_controls.py python script and check that the dependencies described below are in place. Alternatively, should you wish to install vdu_controls for all users, RPMs are available for OpenSUSE, Fedora, and there is an archlinux AUR package which also works in Manjaro. See the Install section below.

Development is trunk-based. It is my intention that the trunk should always be usable as a daily-driver. That being said, a download of trunk is likely to be less stable than downloading one of the formal releases or installing one of the packages that are available in various distros.

Dependencies

All the following runtime dependencies are likely to be pre-packaged on any modern Linux distribution (vdu_controls was originally developed on OpenSUSE Tumbleweed).

• ddcutil >= 1.2, >= 1.4 recommended: the command line utility that interfaces to VDUs via DDC over i2c-dev or USB. (If anyone requires support for versions of ddcutil prior to v1.2 please contact me directly.)
• i2c-dev: the i2c-dev kernel module normally shipped with all Linux distributions and required by ddcutil
• python >=3.8: vdu_controls is written in python and may depend on some features present only in 3.8 onward.
• python >=3.8 QtPy: the python GUI library used by vdu_controls.

It's best to confirm that ddcutil is functioning before using vdu_controls:

• See https://www.ddcutil.com/config/ for instructions on configuring ddcutil (including some extra steps for Nvidia GPU users).
• See https://www.ddcutil.com/i2c_permissions/ for instructions on setting and testing the required permissions.
• Fo some VDUs, DDC/CI over Display-Port to Display-Port connections may work when others connections don't (mainly with some Nvidia GPUs).

As of ddcutil 1.4, installing a pre-packaged ddcutil will most likely set the correct udev rules to grant users access to the required devices. If you are using an earlier ddcutil, it may be necessary to follow all the steps detailed in the links above.

Installing

As previously stated, the vdu_vontrols.py script is only file required beyond the prerequisites. There are also OpenSUSE RPMs available at: https://software.opensuse.org/package/vdu_controls, some unoffical Fedora RPMs available at: build.opensuse.org and an archlinux (manjaro compatible) AUR package at: https://aur.archlinux.org/packages/vdu_controls

That makes three options for "installation":

1. The script can be run without installation by using a python interpreter, for example:

   % python3 vdu_controls.py
   

2. The script can be self installed as desktop application in the current user's desktop menu as Applications->Settings->VDU Controls by running:

    % python3 vdu_controls.py --install
   

   Depending on which desktop you're running menu changes may require logout before they become visible.

3. A system-wide installation using a distribution's packaging system which will install all of:

   /usr/bin/vdu_controls
   /usr/share/applications/vdu_controls.desktop
   /usr/share/licenses/vdu_controls/LICENSE.md
   /usr/share/vdu_controls/icons/*
   /usr/share/vdu_controls/sample-scripts/*
   /usr/share/vdu_controls/translations/*
   /usr/share/man/man1/vdu_controls.1.gz
   

Please note the first two options only install vdu-controls for the current user. The script and desktop-file installed for a single user could be modified and copied into /usr or /usr/local hierarchies should you wish to do so. If using the first two options, you might want to follow up by manually downloading some of the other items such as the starter set of icons for use when creating Presets.

Executing the program

• If installed from rpm, VDU Controls should be in everyone's application menu under Settings. The vdu_controls command will also be in everyone's PATH and will be able to be run from the command line, for example:

  % vdu_controls --show brightness --show contrast --show audio-volume
  

• If installed by the current user via the --install option, VDU Controls should be in the current user's application menu under Settings. The vdu_controls command will be in $HOME/bin. If $HOME/bin is on the user's PATH, vdu_controls will be also able to be run from the command line in the same manner as above.
• If the script has not been installed, it can still be run on the command line via the python interpreter, for example:
  % python3 vdu_controls.py --no-splash --system-tray --show brightness --show contrast

Help

Detailed help can be accessed by using the right mouse-button to bring up a context-menu. Access to the context-menu is available in the application-window and in the system-tray icon.

Both brief help and detailed help can also be accessed via the command line:

% python3 vdu_controls.py --help
% python3 vdu_controls.py --detailed-help
% python3 vdu_controls.py --detailed-help | pandoc --from markdown --to html > vdu_controls_help.html
# or if installed as an executable:
% vdu_controls --help
% vdu_controls --detailed-help
% vdu_controls --detailed-help | pandoc --from markdown --to html > vdu_controls_help.html

Whether run from the desktop application-menu or run from the command line, vdu-controls behaviour can be altered in a number of ways:

• The Settings item in the context-menu.
• Command line options.
• Configurations files in $HOME/.config/vdu_controls/

See the context-menu or the man page for details.

VDU controls and optimisations can be specified in the global or VDU-specific config-files.

Bugs and Suggestions

If you encounter a bug or issue, or wish to make a suggestion, you're most welcome to raise it on the issues page.

Development

I've set up the vdu_controls source as a typical Python development, but there is only one real source file, vdu_controls.py, so the file hierarchy is rather over the top. A standard python distributable can be built by issuing the following commands at the top of the project hierarchy:

% python3 -m pip install build
% python3 -m build
...
% ls -1 dist/
total 268
vdu_controls_digitaltrails-1.0.0-py3-none-any.whl
vdu_controls-digitaltrails-1.0.0.tar.gz

The source includes configuration files for the Sphinx Python Documentation Generator. The following commands will extract documentation from vdu_controls.py:

% cd docs
% make man
% make html

I prefer Pandoc's HTML generation. There is a util script that generates the Sphinx outputs and then pandoc for the html:

% ./util/make-man

My IDE for this project is PyCharm Community Edition.

Coverage testing is assisted by Coverage.py and Vulture. Type checking is assisted by Mypy.

My development Linux desktop is OpenSUSE Tumbleweed. The python3 interpreter and python3 libraries are from the standard Tumbleweed repositories.

Acknowledgements

• Sanford Rockowitz (rockowitz), for the robust ddcutil utility and all the friendly help and assistance.
• Mark Wagie (yochananmarqos), for Gnome related suggestions and AUR port.
• Denilson Sá Maia (denilsonsa), for many suggestions, assistance, and contributions.
• Matthew Coleman (crashmatt), Mark Lowne (lowne), usr3, Mateo Bohorquez G. (Milor123), Andrew Sun (apsun), Extent (Extent421) for contributing fixes to code and documentation.
• Jakeler, kupiqu, Mateo Bohorquez (Milor123), Johan Grande (nahoj), 0xCUBE, RokeJulianLockhart, abil76, Andrew Sun (apsun) for contributing suggestions for enhancements.
• Malcolm Lewis (malcolmlewis) for assistance with the OpenSUSE Open Build Service submissions.
• Christopher Laws (claws) for the BH1750 library and example build (lux-metering).
• Plus others who have supplied feedback and suggestions.

Author

Michael Hamilton

Version History

• 2.1.2

  • When performing a set-vcp, don't increment the NVRAM write count if the VDU doesn't respond.
  • Remove potential deadlock when handling ddcutil-service change-events.
  • Discard pending VDU VCP changes when reconfiguring VDU controllers.
  • Fix new-day Preset scheduling. If the timer triggers slightly early at 23:59:59, schedule for the new-day.

• 2.1.1

  • Removed --dbus-signals-enabled. DBus signals are now always enabled when --dbus-client is enabled.
  • Fix the active Preset icon display which was sometimes incorrect after DPMS-sleep or errors.
  • Fix a code regression when handling non-DDC-capable VDUs (fix status=-3020 exception).
  • The About-Dialog now includes counts of per-VDU set_vcp/NVRAM-writes.
  • Hovering over a VDU-name in the main-window reveals the write count for that VDU.
  • Minor changes to reduce unnecessary work and improve log messages.

• 2.1.0

  • Preset transitions have been deprecated. All presets are now restored instantly no matter how they have been set to transition. The Preset-Dialog controls for assigning transitions have been hidden. All transition related code may be removed in a future version, please contact me or comment on issue #93 if you prefer transitions to be retained.
  • Transitions and related controls can be re-enabled by disabling protect-nvram in the Settings-Dialog.
  • To avoid unnecessary updates, preset restoration now queries the VDU's existing values. This may slow down preset restoration.
  • Lux-metered auto adjustment has been defaulted to 10 minute intervals (up from 5).
  • Color-Preset (VCP code 0x14) has been added to the list of standard controls.
  • Added a VDU Initializer-Preset feature to provide a replacement for dead NVRAM. This also provides a way to restore settings not persisted in VDU NVRAM. A VDU's initializer-preset is automatically run if the target VDU is present at startup or is subsequently detected. Any preset that has a name that matches a VDU model and serial-number will be treated as an Initializer-Preset.
  • The Preset-Dialog now includes a tool-button to the right of the preset-name entry that will create a VDU specific Initializer-Preset.

• 2.0.4

  • The About-Dialog now refreshes the ddcutil version info on each invocation.
  • Increased dbus timeout to 10 seconds (in case numerous VDUs or errors slow down VDU detection).
  • Dynamically enable a scroll-area when the main-panel exceeds the available screen height.

• 2.0.3

  • Reduce the number of writes to VDU NVRAM by sliders, spinners, and ambient brightness adjustments.
    • Slider and spin-box controls now only update the VDU when adjustments become slow or stop (when the control value remains constant for 0.5 seconds).
    • Spin-Boxes now select the entire text on focus in (enables easier overtyping and decreases VDU updates).
    • Ambient lighting initiated changes in brightness of up to 20% are applied without any transitional steps (plus the existing code ignores updates of less than 10%).
    • Set the default ambient-light brightness adjustment-interval to 5 minutes.
  • React to DPMS awake signal from ddcutil-service by re-assessing ambient brightness.
  • Simplified locking and conformed to a locking hierarchy/protocol to avoid potential deadlocks.

• 2.0.2

  • Added a refresh annotation suffix for use with VCP-codes which cause multiple changes.
  • Make manual adjustment of the ambient Light Level more accurate and responsive.
  • Updates are sent to the VDU as sliders are dragged (rather than only on release).
  • Fix exception on monitors that return invalid/unexpected combo-box VCP values.
  • Fix exception on monitors with blank VCP value descriptions.
  • When refresh is pressed, only auto adjust ambient brightness if auto-brightness is enabled.
  • Don't automatically refresh on error, eliminate popup dialog loops.
  • Eliminate deadlocks when exceptions occur.
  • Cleanup the initialisation of the ddcutil-service connection.
  • Add more caveats and limitations to the documentation.
  • Fix manual ambient light slider when light meter is uninitialized.
  • Promote Simple-Non-Continuous values whose metadata exceeds one-byte to two-byte Complex-NC.

• 2.0.1

  • Fix D-Bus client code for python versions prior to 3.11.
  • Fix infinite-loop when altering an existing FIFO lux-meter in the Lux-Dialog.
  • Fix the refresh of the LuxDialog meter-readout/plot when changing to a new meter.
  • Apply context-aware defaults to the LuxDialog device file-chooser.
  • Improve/fix the handling of displays/laptop-displays that may be detected but lack proper DDC.
  • Force the file-picker to always show devices and FIFOs - it wasn't showing then on some desktops.

• 2.0.0

  • Added an optional D-Bus interface to ddcutil for up to 10x faster response times.
  • Added an immediate-lighting-check button and corresponding context-menu item (when lux-metering is enabled).
  • Added an ambient-light-control for manual lux input, one slider to adjust brightness on all displays.
  • Added more preset icons.

• 1.20.0

  • Added options monochrome-tray and mono-light-tray to enable a monochrome tray-icon (dark and light).
  • Optional $HOME/.config/vdu_controls/tray_icon.svg overrides the normal tray icon.
  • Improved the adjustment of icon/window dimensions by scaling them in respect to the user's default-font height.
  • Remove adjust-for-dpi in favour of the the above which automatically accounts for DPI.
  • When a Preset is transitioning slowly (i.e. not immediately), the UI controls can be used to stop the transition.
  • Considerable internal refactoring of option handling.

• 1.12.0

  • Added an F10_key context menu shortcut to all application windows (KDE accessibility standard).
  • Set icon and pixmap sizes appropriately for Normal and High DPI (controlled by adjust-for-dpi) (issue #63).
  • Icon/device-chooser-dialog: init-time reduced from 30 to 5 seconds for users with large home folders (issue #61).
  • Improvements/Fixes to the vlux_meter.py sample-script and the related vdu_controls FIFO reader.
  • Improved visibility of the app-icon's preset-transitioning indicator and auto-lux indicator.
  • Increased contrast for generated text preset-abbreviation icons.
  • Encode translations in plain text rather than escaped XML (for easier editing).

• 1.11.1

  • Fix Preset text size in tray icon.
  • Fix occasional concurrency lockup issue in lux_metering.
  • Update the Settings Dialog when a new VDU becomes available.
  • Light-metering: show both a lux-auto indicator (an orange "LED") AND the current preset (if any) in the app icon.
  • Fix first time use crash (issue #60).
  • Allow % in config files by turning off ConfigParser interpolation (issue #60).

• 1.11.0

  • Made vdu_controls ddcutil-2.0-ready.
  • Added support for ddcutil versions earlier than 1.3 (issue #43, #53).
  • Main-Window: added a hide-on-focus-out option to minimize the main window on focus out (issue #57).
  • Main-Window: changed the layout to display brightness and contrast as the first two controls for each VDU.
  • Main-Window: added jump to clicked value to sliders (issue #59).
  • Main-Window: added a smart-main-window option to make main window placement and geometry preservation optional.
  • Main-Window: the main window can now be raised above the other sub-windows (gnome issue only).
  • Main-Window and Context Menu: added alt-key keyboard shortcuts (issue #13).
  • Context-Menu: added an indicator mark suffix to the currently active Preset (if any) (issue #55).
  • Context-Menu: made changes to Preset ordering propagate to the menu without requiring an application restart.
  • Tray-Icon: made the app icon un-themed so that overlaid active Preset text/icon is more visible (issue #55).
  • Settings-Dialog: added a Reset button to makes it possible to un-ignore a VDU (issue #51).
  • Settings-Dialog: added tool-tips to main config-settings, made them consistent with command line help (issue #52).
  • Preset-Dialog: combined the Activate and Edit buttons into one button (simpler and more intuitive).
  • Preset Dialog: made the dialog bold the text button of the currently active Preset (if any).
  • Preset Dialog: added code to detect and and warn of unsaved changes.
  • Preset Dialog: made the dialog lock out any scheduled or automatic VDU changes while a Preset is being edited.
  • Preset-Dialog: supplied a starter set of Prest icons - a selection of KDE breeze5-icons (issue #56).
  • Popup-Messages: made message box popups resizable for increased readability.
  • Command-line: made config-settings and command-line arguments consistent, command line has precedence (issue #52).
  • Command-line: fixed --sleep-multiplier so that it is actually applied (issue #54).
  • Prevented potential crashes in the event of utf-8 decoding errors for EDIDs and capabilities (issue #49).
  • Added logging of stack traces for some errors if debugging is set to on (issue #49).
  • Improved the handling of ddcutil not found (issue #48).
  • Refactored to improve maintainability and run-time efficiency (issue #52).
  • Added Deepin 23 pyqt library compatibility.
  • Numerous minor enhancements and fixes.
  • An alpha release of vlux_meter.py, a system-tray webcam lux-meter, has been included in the sample scripts folder.

• 1.10.2

  • Fix Preset non-zero transition-step-seconds, so it works properly.
  • Changing log-to-syslog or log-debug-enabled no longer requires a restart.
  • Fix Lux Auto menu icon when starting with Auto disabled.
  • Use the progress bar area on the main panel for status messages.
  • Make auto brightness behave more predictably by removing unnecessary constraints on interpolation.
  • Improve auto-lux/preset tray icon interaction - better reflect actions and current state.

• 1.10.1

  • Restore lux meter displayed-value when restoring LuxDialog window.
  • Minor fixes to reduce and improve displayed and logged messages.
  • Rollup release prior to downtime for ToTK

• 1.10.0

  • Added hardware lux metering options (GY30/BH1750+Arduino, UNIX-fifo, or executable-script).
  • Added lux-to-brightness profiles per VDU.
  • Added sample scripts for using a webcam to produce approximate lux values.
  • Added an option to transition smoothly on UNIX signal.
  • Replaced the transition combo-box with a button+checkboxes.
  • Added drag-to-change, click-to-delete, to the elevation chart component.
  • Added a setting to quickly disable weather and another for elevation-scheduling.
  • Cleanup of thread handling - clarification of GUI/non-GUI thread operations.
  • Reduced logging and eliminated popup dialogs when monitors are suspended or powered off.

• 1.9.2

  • Optional Smooth Transitions for presets:
    • The Presets Dialog now includes an option to set a Preset to Transition Smoothly.
    • The tray, main panel, and Preset Dialog indicate when a smooth transition is in progress.
    • Transitions are performed by a non-GUI thread, the GUI remains accessible during smooth transitions.
    • A smooth transition can be interrupted by moving the controls being transitioned or invoking a preset.

• 1.9.1

  • The text input to right of slider controls has been replaced with a SpinBox with up/down arrows.
  • The main panel progress-bar spinner will now also display during preset-activation (in addition to displaying during refresh).
  • Refresh and preset controls now lock during refresh and preset-activation (to prevent conflicting actions).
  • The context menu and hamburger menu are now available during refresh (a subset of actions is available, such as help and about).
  • The VDU EDID 128/256 byte identifier is now used internally to ensure the controls operate on the correct monitor.
  • Build changes for submission to OpenSUSE Development and Factory by @malcolmlewis.
  • The thread handling and error handling has been cleaned up.

• 1.9.0

  • Bug fixes and speedy performance improvements:
    • Speed up initialization and refresh by combining multiple ddcutil getvcp requests.
    • Stop executing a getvcp precheck before each setvcp.
    • Fix repeat-initialisation bug in Context-Menu Refresh.
    • Fix Settings Dialog text field validation, some errors were invisibly ignored.
    • Fix Settings Dialog Settings Enable VCP Codes, they had stopped working.
    • Fix the monitor specific sleep multipliers, they were not always being used.
    • Treat all monitor detection situations as needing time to stabilise (helps in disconnect situations).
    • Fix event handling so that tablet+pen input works on the main window.
    • Default to a sleep-multiplier of 1.0 to support a wider range of monitors out of the box.
  • V1.9.0 drops support for converting from v1.6.* config and preset files. To convert from v1.6.* and earlier versions, follow these steps to download and run v1.8.3:

     % wget https://github.com/digitaltrails/vdu_controls/blob/v1.8.3/vdu_controls.py
     % python3 vdu_controls.py
    

    Alternatively, start fresh by moving or removing the old configs from $HOME/.config/vdu_controls.

• 1.8.3

  • Fix for a crash when the network is down and the weather site cannot be contacted.

• 1.8.2

  • Solar elevation weather requirements.
  • Locale language support and sample AI generated translations.

• 1.8.0

  • Presets can be scheduled to activate according to solar elevation at a given latitude and longitude.

• 1.7.2

  • Better handle monitors being powered off: on set-value errors, check what's connected.
  • The display ordering of presets can now be manually altered in the Presets dialog.
  • Do not exit if no controllable monitor is found.

• 1.7.1

  • Refactoring in 1.7 broke the signal handling - incorporate fix from Mark Lowne.

• 1.7.0

  • Presets can now optionally have icons which display in the menu and overlay the tray icon.
  • The Preset-management dialog now includes an icon selection button.

• 1.6.11

  • Display current preset in window and tray title and detect if a preset is in use at startup.

• 1.6.10, 1.6.9

  • Cope better with invalid slider values caused by a monitor being too slow/busy when responding.
  • Wait for monitor detection to stabilise at session restoration (at login time).

• 1.6.8

  • Fix preset restore/save bug introduced in 1.6.7

• 1.6.7

  • Gnome system tray behaviour made consistent with gnome - when in gnome do as the gnomens do.

• 1.6.5

  • Widen handling of pare exceptions for VDU capabilities - catch more exceptions.

• 1.6.4

  • Wait for system tray to become available (for autostart Plasma Wayland).
  • Enable HiDPI icons (for the bottom toolbar) - fix blurred toolbar icons on up-scaled desktops.

• 1.6.3

  • Added a hamburger menu as an obvious alternate path to the context menu.
  • Minor cosmetic UI changes.

• 1.6.2

  • Added a Feature Values: min..max override to optionally restrict brightness and other sliders.

• 1.6.1

  • Alterations for Wayland compatibility (cosmetic)

• 1.6.0

  • Let other processes trigger vdu_controls preset changes and settings refreshes via UNIX/Linux signals.

• 1.5.2

  • vdu-controls is now feature complete in respect to my own requirements.
  • Raise popup dialogs to the top (in case Qt renders them behind existing windows).
  • Documentation tweaks.

• 1.5.1

  • New grey-scale reference chart for assistance with brightness and contrast adjustment.
  • About/help/settings/presets dialogs are now singletons, only one of each can be visible.

• 1.5.0

  • New presets feature: easily switch between named presets such as Night, Day, Overcast, Sunny, Photography, and Video.
  • Presets context-menu item for access to the new preset management widget.
  • Context menu shortcuts for quickly accessing presets.
  • INI preset file format for ease of editing.

• 1.4.2

  • Fix increasing indentation of multiline capabilities text on each config file save.
  • Prune the VDU settings-editor control-list to only show controls supported by the VDU.
  • Use grid layout in the settings editor.

• 1.4.1

  • Internal code cleanups after switching to INI config files (no functional changes).
  • Updated the help.

• 1.4.0

  • Added global and VDU-specific INI style configuration files in $HOME/.conf/vdu_controls/.
  • Added a GUI settings-editor as a settings menu-item in the context-menu.

• 1.3.1

  • A minor enhancement to ease installation on Ubuntu, create $HOME/bin if it doesn't exist.

• 1.3.0

  • Add a CUSTOM::Sleep_Multiplier VDU config-file option to allow VDU specific sleep multipliers. This can be used to prevent the slowest VDU from dragging down response time for all connected VDUs.
  • Added a main UI right-mouse action that makes the context menu available in the UI window.
  • Added a help option to context menu, it displays a formatted version of the --detailed-help text.
  • Added a --detailed-help command line option to extract the help from the script (in Markdown format).

• 1.2.2

  • Generalise and simplify the error handling changes initiated in v1.2.1.

• 1.2.1

  • Catch ddcutil error exit and offer to try a slower --sleep-multiplier

• 1.2

  • Better handle out of range values.
  • Enable audio-mute,audio-treble,audio-bass,audio-mic-volume.
  • Allow ddcutil to be anywhere on the user's PATH.
  • Improve parsing to ignore laptop non-MCCS displays when present with external monitors.
  • Improve the documentation.
  • Add an --about command line option and an "about" tray option.

• 1.0

  • Initial Release

License

This project is licensed under the GNU General Public License Version 3 - see the LICENSE.md file for details

vdu_controls Copyright (C) 2021 Michael Hamilton

This program 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, version 3.

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, see https://www.gnu.org/licenses/.