chore: synchronize main with TargetBridge 3.5.2

.github/workflows/ci.yml

@@ -2,14 +2,21 @@ name: CI Build Verification
 
 on:
   push:
-    branches: [ main, 3.1-maint, 3.2-dev, dev-3.3.0 ]
+    branches: [ main, 3.1-maint, maint-3.5, 3.2-dev, dev-3.3.0, dev-3.4.0 ]
   pull_request:
-    branches: [ main, 3.1-maint, 3.2-dev, dev-3.3.0 ]
+    branches: [ main, 3.1-maint, maint-3.5, 3.2-dev, dev-3.3.0, dev-3.4.0 ]
 
 jobs:
   build-sender:
-    name: Build Sender (macOS 15 - Apple Silicon)
-    runs-on: macos-15
+    name: Build Sender (${{ matrix.os }} - ${{ matrix.arch }})
+    strategy:
+      matrix:
+        include:
+          - os: macos-15-intel
+            arch: x86_64
+          - os: macos-15
+            arch: arm64
+    runs-on: ${{ matrix.os }}
     steps:
       - name: Checkout Code
         uses: actions/checkout@v6
@@ -26,12 +33,19 @@ jobs:
         run: |
           cd TargetBridge-Sender
           ./scripts/build_targetbridge_sender_app.sh
+          file ../build/TargetBridge.app/Contents/MacOS/TargetBridge | grep -q "${{ matrix.arch }}"
 
       - name: Run Sender Unit Tests
         run: |
           cd TargetBridge-Sender
           xcodebuild test -project TargetBridge.xcodeproj -scheme TBDisplaySender -destination 'platform=macOS' -derivedDataPath .build/DerivedData
 
+      - name: Check Integrated Video Queue Guards
+        run: ruby TargetBridge-Sender/scripts/test_video_queue_budget.rb
+
+      - name: Check Sender Permission Probe
+        run: ruby TargetBridge-Sender/scripts/test_permission_status.rb sender build/TargetBridge.app/Contents/MacOS/TargetBridge
+
   build-receiver:
     name: Build Receiver (${{ matrix.os }} - ${{ matrix.arch }})
     strategy:
@@ -63,3 +77,6 @@ jobs:
         run: |
           cd TargetBridge-Receiver
           ./scripts/build_tbreceiver_c_app.sh
+
+      - name: Check Receiver Permission Probe
+        run: ruby TargetBridge-Sender/scripts/test_permission_status.rb receiver 'build/TargetBridge Receiver.app/Contents/MacOS/TargetBridgeReceiver'

.github/workflows/release.yml

@@ -12,8 +12,15 @@ permissions:
 
 jobs:
   build-sender:
-    name: Build Sender (Apple Silicon)
-    runs-on: macos-15
+    name: Build Sender (${{ matrix.os }} - ${{ matrix.arch }})
+    strategy:
+      matrix:
+        include:
+          - os: macos-15-intel
+            arch: x86_64
+          - os: macos-15
+            arch: arm64
+    runs-on: ${{ matrix.os }}
     steps:
       - name: Checkout Code
         uses: actions/checkout@v6
@@ -26,22 +33,23 @@ jobs:
         run: |
           cd TargetBridge-Sender
           ./scripts/build_targetbridge_sender_app.sh
+          file ../build/TargetBridge.app/Contents/MacOS/TargetBridge | grep -q "${{ matrix.arch }}"
 
       - name: Zip App Bundle
         run: |
           cd build
-          zip -r TargetBridge-arm64.app.zip TargetBridge.app
+          zip -r TargetBridge-${{ matrix.arch }}.app.zip TargetBridge.app
 
       - name: Generate build provenance attestation
         uses: actions/attest@v4
         with:
-          subject-path: build/TargetBridge-arm64.app.zip
+          subject-path: build/TargetBridge-${{ matrix.arch }}.app.zip
 
       - name: Upload Sender Artifact
         uses: actions/upload-artifact@v7
         with:
-          name: TargetBridge-arm64.app.zip
-          path: build/TargetBridge-arm64.app.zip
+          name: TargetBridge-${{ matrix.arch }}.app.zip
+          path: build/TargetBridge-${{ matrix.arch }}.app.zip
           retention-days: 1
 
   build-receiver:
@@ -93,6 +101,12 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Download Sender Artifact
+        uses: actions/download-artifact@v8
+        with:
+          name: TargetBridge-x86_64.app.zip
+          path: ./artifacts
+
+      - name: Download Sender Artifact (arm64)
         uses: actions/download-artifact@v8
         with:
           name: TargetBridge-arm64.app.zip
@@ -115,6 +129,7 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           gh release create "${{ github.ref_name }}" \
+            ./artifacts/TargetBridge-x86_64.app.zip \
             ./artifacts/TargetBridge-arm64.app.zip \
             ./artifacts/TargetBridge-Receiver-x86_64.app.zip \
             ./artifacts/TargetBridge-Receiver-arm64.app.zip \

.gitignore

@@ -19,4 +19,8 @@ tbreceiver
 
 # C test outputs
 test_net_parser
+test_input_queue
+test_idle_watchdog
+test_receiver_profile
+test_monitor_shield
 *.dSYM/

README.md

@@ -21,10 +21,44 @@ contributions help keep the project moving forward.
 
 [![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink?logo=github)](https://github.com/sponsors/swellweb)
 
-## TargetBridge 3.3
+## Contributors
 
-TargetBridge 3.3 improves the reliability of the display connection while
-keeping the established multi-Mac workspace features:
+Thank you to everyone who tests TargetBridge on real hardware, reports issues,
+and improves the project. A special thank-you for this release goes to:
+
+- [@aalpgiray](https://github.com/aalpgiray) for receiver brightness, volume, Night Shift, and True Tone controls.
+- [@preggocl](https://github.com/preggocl) for the physical Receiver display profile and the software decode fallback.
+- [@Betafer](https://github.com/Betafer) for input-queue safety, cursor work, idle audio/display handling, watchdog protection, monitor shielding, and build improvements.
+
+## TargetBridge 3.5.2
+
+TargetBridge 3.5.2 is a focused maintenance update to the Input Dockstation.
+When the Receiver is the input master, Shift and Command now remain active for
+multi-file selection even when the keyboard is connected to the Receiver and
+the mouse or trackpad is used locally on the Sender. This fixes Finder range
+selection and non-contiguous selection without changing ordinary local input.
+
+It also includes the video queue, capture-health and permission-status fixes
+prepared for this maintenance line. For the wider 3.5.1 maintenance work,
+including Receiver display profiles, idle resource handling, and compatibility
+with older Macs:
+
+- preserve keyboard and mouse release events when the Receiver input queue is under pressure
+- preserve native macOS cursor shapes by default, including the screenshot crosshair; the custom overlay is reserved for the explicit large-cursor option
+- advertise the Receiver's actual panel geometry instead of always reporting a fixed 5K profile
+- preserve native 5K panel dimensions when macOS uses a scaled HiDPI desktop
+- fall back safely to software video decode when VideoToolbox cannot decode a stream on older hardware
+- allow display sleep while the Receiver is waiting, including before the first session
+- open audio output only when audio arrives and release it when the session ends
+- handle watchdog clock underflow without incorrectly dropping the connection
+- keep local notification banners behind the active monitor surface across display/fullscreen transitions
+- package SDL runtimes safely and support explicit build/version overrides
+
+See the [full 3.5.2 release notes](docs/releases/3.5.2.md), the
+[3.5.1 release notes](docs/releases/3.5.1.md), and the
+[testing guide](docs/Testing.md), including the new monitor-shield lifecycle test.
+
+It also keeps the established multi-Mac workspace features:
 
 - mirror mode and extended desktop mode
 - multiple receivers from one sender
@@ -54,8 +88,9 @@ keeping the established multi-Mac workspace features:
 - Network Link (experimental): [docs/Features.md#network-link-experimental](docs/Features.md#network-link-experimental)
 - Audio Relay: [docs/Features.md#audio-relay](docs/Features.md#audio-relay)
 - Input Dockstation, clipboard sync, master/slave roles, and Receiver Master shortcuts: [docs/Features.md#input-dockstation](docs/Features.md#input-dockstation)
-- Remote brightness control: [docs/Features.md#remote-brightness-control](docs/Features.md#remote-brightness-control)
+- Receiver device controls (brightness, volume, Night Shift, True Tone): [docs/Features.md#receiver-device-controls](docs/Features.md#receiver-device-controls)
 - Remote connection & automation (URL scheme, launch args, SSH, login/wake): [docs/Automation.md](docs/Automation.md)
+- Measured connection-path selection (Thunderbolt, USB/USB4, Ethernet, Wi-Fi): [docs/Automation.md#1-targetbridge-cli](docs/Automation.md#1-targetbridge-cli)
 - Shared translations (English, Italian, German, French, and Chinese): [docs/Features.md#shared-translations](docs/Features.md#shared-translations)
 - Thunderbolt networking extras (SSH/SFTP, file sharing, Internet Sharing): [docs/Features.md#thunderbolt-networking-extras](docs/Features.md#thunderbolt-networking-extras)
 
@@ -66,6 +101,7 @@ keeping the established multi-Mac workspace features:
 - Stream profiles range from `2560 x 1440` to `5120 x 2880` with H.264/HEVC selection based on capability. `5K 60` is an experimental profile for recent Apple Silicon; `5K 48` remains recommended for reliable daily work. See [Display Modes](docs/Features.md#display-modes).
 - Receiver discovery is automatic over Bonjour. Extended-display arrangement is remembered per receiver when possible. See [Display Modes](docs/Features.md#display-modes).
 - Thunderbolt Bridge remains the primary low-latency path, with `Network Link` available as an experimental addon-gated transport. See [Network Link](docs/Features.md#network-link-experimental).
+- The Sender menu can control a connected receiver's brightness, volume, Night Shift, and True Tone when supported. See [Receiver Device Controls](docs/Features.md#receiver-device-controls).
 
 ## Official Addons
 
@@ -77,7 +113,7 @@ TargetBridge now has a conservative manifest-based addon system. Official manife
 
 ## Requirements
 
-- Sender: Apple Silicon Mac (M1 or later), macOS 14 Sonoma or later
+- Sender: Apple Silicon Mac (M1 or later) or Intel Mac, macOS 14 Sonoma or later. Apple Silicon remains the primary tested path; Intel Sender builds are available for broader testing.
 - Receiver: Intel or Apple Silicon Mac, macOS 11 Big Sur or later
 - Thunderbolt cable
 - See also [docs/Hardware.md](docs/Hardware.md) for hardware details, tested cables, adapters, and Thunderbolt networking ideas.
@@ -87,6 +123,7 @@ TargetBridge now has a conservative manifest-based addon system. Official manife
 **[→ Download latest release (pre-built apps, no Xcode needed)](https://github.com/swellweb/targetBridge/releases/latest)**
 
 - `TargetBridge-arm64.app.zip` — Sender (for Apple Silicon Macs)
+- `TargetBridge-x86_64.app.zip` — Sender (for Intel Macs)
 - `TargetBridge-Receiver-arm64.app.zip` — Apple Silicon Receiver (use machine as monitor for sender)
 - `TargetBridge-Receiver-x86_64.app.zip` — Intel Receiver (use machine as monitor for sender)
 

TargetBridge-Receiver/TBReceiverC/Makefile

@@ -16,26 +16,26 @@
 
 CC       ?= clang
 PKG      ?= pkgconf
-APP_VERSION ?= 3.2.0
+APP_VERSION ?= 3.5.2
 APP_BUILD   ?= dev
 
 MACOSX_DEPLOYMENT_TARGET ?= 11.0
 export MACOSX_DEPLOYMENT_TARGET
 
 CFLAGS   += -O2 -g -Wall -Wextra -Wno-unused-parameter -std=c11
-CFLAGS   += $(shell $(PKG) --cflags libavcodec libavutil sdl2)
+CFLAGS   += $(shell $(PKG) --cflags libavcodec libavutil libswscale sdl2)
 CFLAGS   += -DTB_RECEIVER_VERSION=\"$(APP_VERSION)\" -DTB_RECEIVER_BUILD=\"$(APP_BUILD)\"
 CFLAGS   += -DTB_LANGUAGE_SOURCE_DIR=\"$(abspath ../../TargetBridge-Shared/Languages)\"
 
-LDFLAGS  += $(shell $(PKG) --libs libavcodec libavutil sdl2)
+LDFLAGS  += $(shell $(PKG) --libs libavcodec libavutil libswscale sdl2)
 
 UNAME_S  := $(shell uname -s)
 ifeq ($(UNAME_S),Darwin)
-LDFLAGS  += -framework ApplicationServices -framework AppKit -framework CoreFoundation -framework CoreGraphics -framework CoreText -framework VideoToolbox -framework CoreMedia -framework CoreVideo -framework IOSurface -framework CoreServices -framework CoreAudio
+LDFLAGS  += -framework ApplicationServices -framework AppKit -framework CoreFoundation -framework CoreGraphics -framework CoreText -framework VideoToolbox -framework CoreMedia -framework CoreVideo -framework IOSurface -framework CoreServices -framework CoreAudio -framework SystemConfiguration
 endif
 
-C_SRC = src/main.c src/net.c src/decoder.c src/display.c src/tb_i18n.c
-OBJC_SRC = src/tb_gesture_bridge.m
+C_SRC = src/main.c src/net.c src/decoder.c src/display.c src/input_queue.c src/idle_watchdog.c src/receiver_profile.c src/tb_i18n.c
+OBJC_SRC = src/tb_gesture_bridge.m src/tb_display_tweaks.m
 OBJ = $(C_SRC:.c=.o) $(OBJC_SRC:.m=.o)
 BIN = tbreceiver
 
@@ -51,17 +51,43 @@ $(BIN): $(OBJ)
 	$(CC) $(CFLAGS) -fobjc-arc -c -o $@ $<
 
 clean:
-	rm -f $(OBJ) $(BIN) $(TEST_BIN)
+	rm -f $(OBJ) $(BIN) $(TEST_BIN) $(TEST_INPUT_QUEUE_BIN) $(TEST_IDLE_WATCHDOG_BIN) $(TEST_RECEIVER_PROFILE_BIN) test_monitor_shield
 
 # Unit tests for the packet parser. net.c is pure POSIX, so this needs no
 # ffmpeg/SDL/pkgconf — it runs anywhere, including CI, with no hardware.
 TEST_CFLAGS = -O2 -g -Wall -Wextra -Wno-unused-parameter -std=c11
+TEST_LDFLAGS =
+ifeq ($(UNAME_S),Darwin)
+TEST_LDFLAGS += -framework CoreFoundation -framework SystemConfiguration
+endif
 TEST_BIN = test_net_parser
+TEST_INPUT_QUEUE_BIN = test_input_queue
+TEST_IDLE_WATCHDOG_BIN = test_idle_watchdog
+TEST_RECEIVER_PROFILE_BIN = test_receiver_profile
+
+test_net_parser: tests/test_net_parser.c src/net.c src/net.h src/proto.h
+	$(CC) $(TEST_CFLAGS) -Isrc tests/test_net_parser.c src/net.c $(TEST_LDFLAGS) -o $@
+
+$(TEST_INPUT_QUEUE_BIN): tests/test_input_queue.c src/input_queue.c src/input_queue.h
+	$(CC) $(TEST_CFLAGS) -Isrc tests/test_input_queue.c src/input_queue.c -o $@
 
-$(TEST_BIN): tests/test_net_parser.c src/net.c src/net.h src/proto.h
-	$(CC) $(TEST_CFLAGS) -Isrc tests/test_net_parser.c src/net.c -o $@
+$(TEST_IDLE_WATCHDOG_BIN): tests/test_idle_watchdog.c src/idle_watchdog.c src/idle_watchdog.h
+	$(CC) $(TEST_CFLAGS) -Isrc tests/test_idle_watchdog.c src/idle_watchdog.c -o $@
 
-test: $(TEST_BIN)
+$(TEST_RECEIVER_PROFILE_BIN): tests/test_receiver_profile.c src/receiver_profile.c src/receiver_profile.h
+	$(CC) $(TEST_CFLAGS) -Isrc tests/test_receiver_profile.c src/receiver_profile.c -o $@
+
+test: $(TEST_BIN) $(TEST_INPUT_QUEUE_BIN) $(TEST_IDLE_WATCHDOG_BIN) $(TEST_RECEIVER_PROFILE_BIN)
 	./$(TEST_BIN)
+	./$(TEST_INPUT_QUEUE_BIN)
+	./$(TEST_IDLE_WATCHDOG_BIN)
+	./$(TEST_RECEIVER_PROFILE_BIN)
+
+# AppKit lifecycle coverage requires a logged-in macOS GUI session.
+test_monitor_shield: tests/test_monitor_shield.m src/tb_gesture_bridge.m src/tb_gesture_bridge.h
+	$(CC) -fobjc-arc -framework AppKit -framework CoreGraphics tests/test_monitor_shield.m -o $@
+
+test-monitor-shield: test_monitor_shield
+	./test_monitor_shield
 
-.PHONY: all clean test
+.PHONY: all clean test test-monitor-shield