ahaduoduoduo · Jun 14, 2026 · Sep 2, 2026
diff --git a/MonitorControl.xcodeproj/project.pbxproj b/MonitorControl.xcodeproj/project.pbxproj
@@ -38,6 +38,7 @@
 		AA78BDBD2709FE7B00CA8DF7 /* UpdaterDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = AA78BDBC2709FE7B00CA8DF7 /* UpdaterDelegate.swift */; };
 		AA99521726FE25AB00612E07 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = AA99521626FE25AB00612E07 /* AppDelegate.swift */; };
 		AA99521926FE49A300612E07 /* MenuHandler.swift in Sources */ = {isa = PBXBuildFile; fileRef = AA99521826FE49A300612E07 /* MenuHandler.swift */; };
+		AAB41E2D2C1F6A8200E22A10 /* DisplayLinkControl.swift in Sources */ = {isa = PBXBuildFile; fileRef = AAB41E2C2C1F6A8200E22A10 /* DisplayLinkControl.swift */; };
 		AA9AE86F26B5BF3D00B6CA65 /* OSD.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = AA9AE86E26B5BF3D00B6CA65 /* OSD.framework */; };
 		AA9AE87126B5BFB700B6CA65 /* CoreDisplay.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = AA9AE87026B5BFB700B6CA65 /* CoreDisplay.framework */; };
 		AAB2F638273ED099004AB5A4 /* .swiftlint.yml in Resources */ = {isa = PBXBuildFile; fileRef = AAB2F637273ED099004AB5A4 /* .swiftlint.yml */; };
@@ -125,6 +126,7 @@
 		AA90102027C56A0E00CC1DF7 /* cs */ = {isa = PBXFileReference; lastKnownFileType = text.plist.strings; name = cs; path = cs.lproj/Localizable.strings; sourceTree = "<group>"; };
 		AA99521626FE25AB00612E07 /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
 		AA99521826FE49A300612E07 /* MenuHandler.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MenuHandler.swift; sourceTree = "<group>"; };
+		AAB41E2C2C1F6A8200E22A10 /* DisplayLinkControl.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DisplayLinkControl.swift; sourceTree = "<group>"; };
 		AA99E81527622EBE00413316 /* pt-BR */ = {isa = PBXFileReference; lastKnownFileType = text.plist.strings; name = "pt-BR"; path = "pt-BR.lproj/Main.strings"; sourceTree = "<group>"; };
 		AA99E81627622EBE00413316 /* pt-BR */ = {isa = PBXFileReference; lastKnownFileType = text.plist.strings; name = "pt-BR"; path = "pt-BR.lproj/InternetAccessPolicy.strings"; sourceTree = "<group>"; };
 		AA99E81727622EBE00413316 /* pt-BR */ = {isa = PBXFileReference; lastKnownFileType = text.plist.strings; name = "pt-BR"; path = "pt-BR.lproj/Localizable.strings"; sourceTree = "<group>"; };
@@ -314,6 +316,7 @@
 				6C85EFD922C941B000227EA1 /* DisplayManager.swift */,
 				AA25F6D626E68C160087F3A2 /* MediaKeyTapManager.swift */,
 				AA44E70627038F7F00E06865 /* KeyboardShortcutsManager.swift */,
+				AAB41E2C2C1F6A8200E22A10 /* DisplayLinkControl.swift */,
 				AA16139A26BE772E00DCF027 /* Arm64DDC.swift */,
 				AA4398A826DD55DA00943F16 /* IntelDDC.swift */,
 				FE4E0895249D584C003A50BB /* OSDUtils.swift */,
@@ -636,6 +639,7 @@
 				AA44E7052703790100E06865 /* KeyboardShortcuts+Extension.swift in Sources */,
 				F0A489C4279C71B200BEDFD6 /* OnboardingViewController.swift in Sources */,
 				AA16139B26BE772E00DCF027 /* Arm64DDC.swift in Sources */,
+				AAB41E2D2C1F6A8200E22A10 /* DisplayLinkControl.swift in Sources */,
 				F0445D3820023E710025AE82 /* MainPrefsViewController.swift in Sources */,
 				28D1DDF2227FBE71004CB494 /* NSScreen+Extension.swift in Sources */,
 				AA99521726FE25AB00612E07 /* AppDelegate.swift in Sources */,

diff --git a/MonitorControl/Info.plist b/MonitorControl/Info.plist
@@ -19,7 +19,7 @@
 	<key>CFBundleShortVersionString</key>
 	<string>$(MARKETING_VERSION)</string>
 	<key>CFBundleVersion</key>
-	<string>7141</string>
+	<string>7160</string>
 	<key>LSApplicationCategoryType</key>
 	<string>public.app-category.utilities</string>
 	<key>LSMinimumSystemVersion</key>

diff --git a/MonitorControl/Model/Display.swift b/MonitorControl/Model/Display.swift
@@ -75,7 +75,11 @@ class Display: Equatable {
     os_log("Display init with prefsIdentifier %{public}@", type: .info, self.prefsId)
     self.swUpdateDefaultGammaTable()
     self.smoothBrightnessTransient = self.getBrightness()
-    if self.isVirtual || self.readPrefAsBool(key: PrefKey.avoidGamma), !self.isDummy {
+    let hasDisplayLinkBrightnessControl = self.isVirtual && DisplayLinkControl.shared.display(for: self.identifier)?.isEnabled == true
+    if hasDisplayLinkBrightnessControl {
+      os_log("Skipping software shade for DisplayLink display %{public}@", type: .info, String(self.identifier))
+      _ = DisplayManager.shared.destroyShade(displayID: self.identifier)
+    } else if self.isVirtual || self.readPrefAsBool(key: PrefKey.avoidGamma), !self.isDummy {
       os_log("Creating or updating shade for display %{public}@", type: .info, String(self.identifier))
       _ = DisplayManager.shared.updateShade(displayID: self.identifier)
     } else {
@@ -224,36 +228,35 @@ class Display: Equatable {
     var newValue = brightnessValue
     currentValue = self.swBrightnessTransform(value: currentValue)
     newValue = self.swBrightnessTransform(value: newValue)
+    if self.isVirtual || self.readPrefAsBool(key: .avoidGamma) {
+      self.swBrightnessSemaphore.signal()
+      let displayID = DisplayManager.resolveEffectiveDisplayID(self.identifier)
+      if smooth {
+        let duration = max(0.02, TimeInterval(abs(currentValue - newValue)) * 0.2)
+        return DisplayManager.shared.animateShadeAlpha(value: 1 - newValue, duration: duration, displayID: displayID)
+      }
+      return DisplayManager.shared.setShadeAlpha(value: 1 - newValue, displayID: displayID)
+    }
     if smooth {
       DispatchQueue.global(qos: .userInteractive).async {
         for transientValue in stride(from: currentValue, to: newValue, by: 0.005 * (currentValue > newValue ? -1 : 1)) {
           guard app.reconfigureID == 0 else {
-            self.swBrightnessSemaphore.signal()
             return
           }
-          if self.isVirtual || self.readPrefAsBool(key: .avoidGamma) {
-            _ = DisplayManager.shared.setShadeAlpha(value: 1 - transientValue, displayID: DisplayManager.resolveEffectiveDisplayID(self.identifier))
-          } else {
-            let gammaTableRed = self.defaultGammaTableRed.map { $0 * transientValue }
-            let gammaTableGreen = self.defaultGammaTableGreen.map { $0 * transientValue }
-            let gammaTableBlue = self.defaultGammaTableBlue.map { $0 * transientValue }
-            CGSetDisplayTransferByTable(self.identifier, self.defaultGammaTableSampleCount, gammaTableRed, gammaTableGreen, gammaTableBlue)
-          }
+          let gammaTableRed = self.defaultGammaTableRed.map { $0 * transientValue }
+          let gammaTableGreen = self.defaultGammaTableGreen.map { $0 * transientValue }
+          let gammaTableBlue = self.defaultGammaTableBlue.map { $0 * transientValue }
+          CGSetDisplayTransferByTable(self.identifier, self.defaultGammaTableSampleCount, gammaTableRed, gammaTableGreen, gammaTableBlue)
           Thread.sleep(forTimeInterval: 0.001) // Let's make things quick if not performed in the background
         }
       }
     } else {
-      if self.isVirtual || self.readPrefAsBool(key: .avoidGamma) {
-        self.swBrightnessSemaphore.signal()
-        return DisplayManager.shared.setShadeAlpha(value: 1 - newValue, displayID: DisplayManager.resolveEffectiveDisplayID(self.identifier))
-      } else {
-        let gammaTableRed = self.defaultGammaTableRed.map { $0 * newValue }
-        let gammaTableGreen = self.defaultGammaTableGreen.map { $0 * newValue }
-        let gammaTableBlue = self.defaultGammaTableBlue.map { $0 * newValue }
-        DisplayManager.shared.moveGammaActivityEnforcer(displayID: self.identifier)
-        CGSetDisplayTransferByTable(self.identifier, self.defaultGammaTableSampleCount, gammaTableRed, gammaTableGreen, gammaTableBlue)
-        DisplayManager.shared.enforceGammaActivity()
-      }
+      let gammaTableRed = self.defaultGammaTableRed.map { $0 * newValue }
+      let gammaTableGreen = self.defaultGammaTableGreen.map { $0 * newValue }
+      let gammaTableBlue = self.defaultGammaTableBlue.map { $0 * newValue }
+      DisplayManager.shared.moveGammaActivityEnforcer(displayID: self.identifier)
+      CGSetDisplayTransferByTable(self.identifier, self.defaultGammaTableSampleCount, gammaTableRed, gammaTableGreen, gammaTableBlue)
+      DisplayManager.shared.enforceGammaActivity()
     }
     self.swBrightnessSemaphore.signal()
     return true
@@ -269,8 +272,8 @@ class Display: Equatable {
     }
     self.swBrightnessSemaphore.wait()
     if self.isVirtual || self.readPrefAsBool(key: .avoidGamma) {
-      let rawBrightnessValue = 1 - (DisplayManager.shared.getShadeAlpha(displayID: DisplayManager.resolveEffectiveDisplayID(self.identifier)) ?? 1)
       self.swBrightnessSemaphore.signal()
+      let rawBrightnessValue = 1 - (DisplayManager.shared.getShadeAlpha(displayID: DisplayManager.resolveEffectiveDisplayID(self.identifier)) ?? 1)
       return self.swBrightnessTransform(value: rawBrightnessValue, reverse: true)
     }
     var gammaTableRed = [CGGammaValue](repeating: 0, count: 256)

diff --git a/MonitorControl/Model/OtherDisplay.swift b/MonitorControl/Model/OtherDisplay.swift
@@ -8,6 +8,10 @@ class OtherDisplay: Display {
   var ddc: IntelDDC?
   var arm64ddc: Bool = false
   var arm64avService: IOAVService?
+  var displayLinkDisplay: DisplayLinkDisplay?
+  private var displayLinkBrightnessRecoveryAttempt = Date.distantPast
+  private var displayLinkContrastRecoveryAttempt = Date.distantPast
+  private let displayLinkRecoveryRetryInterval: TimeInterval = 3
   var isDiscouraged: Bool = false
   let writeDDCQueue = DispatchQueue(label: "Local write DDC queue")
   var writeDDCNextValue: [Command: UInt16] = [:]
@@ -200,14 +204,20 @@ class OtherDisplay: Display {
   }
 
   func stepContrast(isUp: Bool, isSmallIncrement: Bool) {
-    guard !self.readPrefAsBool(key: .unavailableDDC, for: .contrast), !self.isSw() else {
+    guard !self.readPrefAsBool(key: .unavailableDDC, for: .contrast), !self.isSw() || self.hasDisplayLinkContrastControl() else {
       return
     }
     let currentValue = self.readPrefAsFloat(for: .contrast)
     let contrastOSDValue = self.calcNewValue(currentValue: currentValue, isUp: isUp, isSmallIncrement: isSmallIncrement)
     let isAlreadySet = contrastOSDValue == self.readPrefAsFloat(for: .contrast)
     if !isAlreadySet {
-      self.writeDDCValues(command: .contrast, value: self.convValueToDDC(for: .contrast, from: contrastOSDValue))
+      if self.hasDisplayLinkContrastControl() {
+        if !self.setDisplayLinkContrast(contrastOSDValue) {
+          return
+        }
+      } else {
+        self.writeDDCValues(command: .contrast, value: self.convValueToDDC(for: .contrast, from: contrastOSDValue))
+      }
     }
     OSDUtils.showOsd(displayID: self.identifier, command: .contrast, value: contrastOSDValue, roundChiclet: !isSmallIncrement)
     if !isAlreadySet {
@@ -327,12 +337,31 @@ class OtherDisplay: Display {
   }
 
   override func setBrightness(_ to: Float = -1, slow: Bool = false) -> Bool {
+    if self.hasDisplayLinkBrightnessControl() {
+      let value = to == -1 ? self.readPrefAsFloat(for: .brightness) : to
+      return self.setDirectBrightness(value)
+    }
     self.checkGammaInterference()
     return super.setBrightness(to, slow: slow)
   }
 
   override func setDirectBrightness(_ to: Float, transient: Bool = false) -> Bool {
     let value = max(min(to, 1), 0)
+    if self.hasDisplayLinkBrightnessControl() {
+      if DisplayLinkControl.shared.setBrightness(for: self.identifier, value: value) {
+        self.savePref(1, key: .SwBrightness)
+        _ = DisplayManager.shared.destroyShade(displayID: DisplayManager.resolveEffectiveDisplayID(self.identifier))
+        if !transient {
+          self.savePref(value, for: .brightness)
+          self.brightnessSyncSourceValue = value
+          self.smoothBrightnessTransient = value
+        }
+        return true
+      }
+      os_log("DisplayLink brightness write failed for display %{public}@. Falling back to software brightness.", type: .info, String(self.identifier))
+      _ = super.setDirectBrightness(to, transient: transient)
+      return true
+    }
     if !self.isSw() {
       if !prefs.bool(forKey: PrefKey.disableCombinedBrightness.rawValue) {
         var brightnessValue: Float = 0
@@ -362,7 +391,107 @@ class OtherDisplay: Display {
   }
 
   override func getBrightness() -> Float {
-    self.prefExists(for: .brightness) ? self.readPrefAsFloat(for: .brightness) : 1
+    if let displayLinkDisplay = self.displayLinkDisplay, let brightness = displayLinkDisplay.brightness, !self.prefExists(for: .brightness) {
+      return brightness
+    }
+    return self.prefExists(for: .brightness) ? self.readPrefAsFloat(for: .brightness) : 1
+  }
+
+  func bindDisplayLinkDisplay(_ display: DisplayLinkDisplay) {
+    self.applyDisplayLinkDisplay(display, updateSliders: false)
+  }
+
+  func applyDisplayLinkDisplay(_ display: DisplayLinkDisplay, updateSliders: Bool = true) {
+    self.displayLinkDisplay = display
+    guard display.isEnabled else {
+      return
+    }
+    self.savePref(1, key: .SwBrightness)
+    if !display.brightnessRequiresRestore, let brightness = display.brightness {
+      self.savePref(brightness, for: .brightness)
+      self.brightnessSyncSourceValue = brightness
+      self.smoothBrightnessTransient = brightness
+      self.displayLinkBrightnessRecoveryAttempt = .distantPast
+      if updateSliders, let slider = self.sliderHandler[.brightness] {
+        slider.setValue(brightness, displayID: self.identifier)
+      }
+    } else if display.brightnessRequiresRestore {
+      os_log("DisplayLink returned an invalid brightness for %{public}@; keeping the last valid MonitorControl value.", type: .default, display.persistentDisplayId)
+    }
+    if !display.contrastRequiresRestore, let contrast = display.contrast {
+      self.savePref(contrast, for: .contrast)
+      self.savePref(DDC_MAX_DETECT_LIMIT, key: .maxDDC, for: .contrast)
+      self.displayLinkContrastRecoveryAttempt = .distantPast
+      if updateSliders, let slider = self.sliderHandler[.contrast] {
+        slider.setValue(contrast, displayID: self.identifier)
+      }
+    } else if display.contrastRequiresRestore {
+      os_log("DisplayLink returned an invalid contrast for %{public}@; keeping the last valid MonitorControl value.", type: .default, display.persistentDisplayId)
+    }
+    self.savePref(DDC_MAX_DETECT_LIMIT, key: .maxDDC, for: .brightness)
+    _ = DisplayManager.shared.destroyShade(displayID: DisplayManager.resolveEffectiveDisplayID(self.identifier))
+    self.restoreInvalidDisplayLinkValuesIfNeeded(updateSliders: updateSliders)
+  }
+
+  func hasDisplayLinkBrightnessControl() -> Bool {
+    (self.displayLinkDisplay?.isEnabled ?? false) && (self.displayLinkDisplay?.supportsBrightness ?? false)
+  }
+
+  func hasDisplayLinkContrastControl() -> Bool {
+    (self.displayLinkDisplay?.isEnabled ?? false) && (self.displayLinkDisplay?.supportsContrast ?? false)
+  }
+
+  private func restoreInvalidDisplayLinkValuesIfNeeded(updateSliders: Bool) {
+    guard app != nil, app.sleepID == 0, app.reconfigureID == 0, let display = self.displayLinkDisplay, display.isEnabled else {
+      return
+    }
+    let now = Date()
+    if display.supportsBrightness, display.brightnessRequiresRestore,
+       now.timeIntervalSince(self.displayLinkBrightnessRecoveryAttempt) >= self.displayLinkRecoveryRetryInterval,
+       let brightness = self.displayLinkRecoveryBrightness() {
+      self.displayLinkBrightnessRecoveryAttempt = now
+      os_log("Restoring DisplayLink brightness for %{public}@ to %{public}@ after an invalid reconnect value.", type: .default, display.persistentDisplayId, String(format: "%.3f", Double(brightness)))
+      if self.setDirectBrightness(brightness), updateSliders, let slider = self.sliderHandler[.brightness] {
+        slider.setValue(brightness, displayID: self.identifier)
+      }
+    }
+    if display.supportsContrast, display.contrastRequiresRestore,
+       now.timeIntervalSince(self.displayLinkContrastRecoveryAttempt) >= self.displayLinkRecoveryRetryInterval,
+       self.prefExists(for: .contrast),
+       let contrast = DisplayLinkControl.normalizedControlValue(self.readPrefAsFloat(for: .contrast)) {
+      self.displayLinkContrastRecoveryAttempt = now
+      os_log("Restoring DisplayLink contrast for %{public}@ to %{public}@ after an invalid reconnect value.", type: .default, display.persistentDisplayId, String(format: "%.3f", Double(contrast)))
+      if self.setDisplayLinkContrast(contrast), updateSliders, let slider = self.sliderHandler[.contrast] {
+        slider.setValue(contrast, displayID: self.identifier)
+      }
+    }
+  }
+
+  private func displayLinkRecoveryBrightness() -> Float? {
+    if prefs.bool(forKey: PrefKey.enableBrightnessSync.rawValue) {
+      let sourceDisplay = DisplayManager.shared.displays.first { $0 != self && $0.isBuiltIn() }
+        ?? DisplayManager.shared.displays.first { $0 != self && $0 is AppleDisplay }
+      if let sourceDisplay, let brightness = DisplayLinkControl.normalizedControlValue(sourceDisplay.getBrightness()) {
+        return brightness
+      }
+    }
+    if self.prefExists(for: .brightness), let brightness = DisplayLinkControl.normalizedControlValue(self.readPrefAsFloat(for: .brightness)) {
+      return brightness
+    }
+    return DisplayLinkControl.normalizedControlValue(self.displayLinkDisplay?.brightness)
+  }
+
+  @discardableResult
+  func setDisplayLinkContrast(_ value: Float) -> Bool {
+    guard self.hasDisplayLinkContrastControl() else {
+      return false
+    }
+    if DisplayLinkControl.shared.setContrast(for: self.identifier, value: value) {
+      self.savePref(value, for: .contrast)
+      return true
+    }
+    os_log("DisplayLink contrast write failed for display %{public}@.", type: .info, String(self.identifier))
+    return false
   }
 
   func getRemapControlCodes(command: Command) -> [UInt8] {