Repository navigation
Releases
AppleTVCrestronDriver 1.5.1
AppleTVCrestronDriver 1.5.1
This patch corrects the dependency and lifecycle issues described below.
- Use AppleTVControlLibrary and Discovery 2.2.8.
- Keep queued Video Server commands tied to the session that accepted them. Drop retired commands and drain held-key release and session shutdown before replacement.
- Preserve the existing V1/V2 bridge, pairing files, source routing and Quick Action configuration.
Installation
Use the driver package from GitHub or the matching NuGet distribution. Import the package, then update the existing driver in Home Setup or Configure Pro. Importing alone does not update the running instance. Existing pairing and configuration formats are retained; removal and re-add is not a routine update step.
Both the V1 Video Server and V2 companion are released together as 1.5.1. Updating an existing V1 driver requires a full processor reboot; the V2 companion does not require a reboot. Preserve the existing pairing files. Quick Actions keep the two-step Route AppleTV -> Launch app setup.
Validation
Passed 167 workstation Debug and 167 Release test executions, plus 167 native net472/Mono processor tests. Processor validation used fake transports and synthetic credentials; no new physical-device acceptance or endurance run is claimed. Existing processor configuration and all pairing files were preserved. See development history for provenance and limits.
This GitHub/NuGet release does not replace any submitted Crestron package. Submission-specific PDFs and correspondence are excluded from public artifacts.
Apple TV drivers 1.5.0
Apple TV drivers 1.5.0
The companion media extension now exposes a separate Launch command for each installed Apple TV app. Configure a Quick Action as Route AppleTV → Launch app. The extension wakes Apple TV when needed and waits for confirmed awake state before submitting the launch request. An already-on device launches without an extra Home command or mandatory startup wait.
App command identities remain stable across list reordering and app renaming. Pending launches stop when the connection/configuration changes or the app becomes unavailable. Requests are serialized, and selection feedback is updated after an accepted launch submission; it is not foreground-app or movie-title confirmation.
See the Quick Action setup instructions for Crestron Home Setup and Configure Pro. Keep both existing devices: the V1 Video Server still owns pairing, the session and native routing/TSR-310 support. Neither tile visibility nor source selection is changed. No synthetic metadata or artwork probe is included.
Both packages use version 1.5.0 (driver version 1.5.000.0000). V1 runtime behavior is unchanged. Retain the existing paired devices and configuration; updating V1 requires a full processor reboot, while the V2 extension supports an in-place update.
Validation: 149 logic tests and 15 real-SDK lifecycle tests passed on the workstation; all 164 also passed in the packaged processor test host with no failures or skips. The temporary test instance and its package were removed, the workflow reservation was released and all three saved pairing files were unchanged. The two-step TV-off / BBC iPlayer live test passed on the experimental 1.4.005.0002 build; the prepared 1.5.0 production packages have not replaced the installed drivers.
Apple TV drivers 1.4.5
Apple TV drivers 1.4.5
The Video Server uses AppleTVControlLibrary and Discovery 2.2.7 and validates the accessory's SRP proof, the pairing response states and the final Pair Verify acknowledgement. Existing pairings are reused. A working endpoint recovered through mDNS is saved in the driver's settings while preserving the pairing file.
Credential writes commit complete records through a temporary file and preserve unknown data-contract fields. Connection disposal cancels pending initialization, stale sessions cannot publish current feedback, and reconnects retain a single bridge event subscription. Concurrent bridge writes are serialized.
The companion extension rejects superseded bridge callbacks, waits for confirmed Apple TV connection status and refreshes keyboard focus after reconnecting. Unavailable state clears stale keyboard text and volume controls. Routine informational logs are limited to Debug builds, and bridge diagnostics omit keyboard payloads.
Update both drivers together. The V1 Video Server requires a full processor reboot. The Entity V2 companion supports an in-place driver update. Retain the existing devices, configuration and saved pairing.
Workstation validation passed 130 net472 offline tests and 13 real-SDK extension lifecycle tests. All 143 cases also passed on the processor with no failures or skips. The temporary test instance and stored package were removed and its reservation released. Processor pairing-file hashes remained unchanged. Both existing drivers were then updated to 1.4.005.0000 on the lab processor, with one full reboot for V1. Loaded versions, device identities, rooms, online/ready state, app enumeration and extracted payload hashes were verified. Home navigation, confirmed sleep/wake feedback with a five-second settling pause, and an in-place V2 reload passed. All three pairing files remained byte-for-byte unchanged. A wake sent immediately after reported sleep was ignored; the five-second test interval is not a proven minimum delay.
AppleTVCrestronDriver v1.4.4
Apple TV drivers 1.4.4
Patch release of the video driver and companion extension. Updates stable SDK/compatibility dependencies and the video driver's AppleTvControlLibrary dependency to 2.2.6. Existing pairing files, configuration and driver interfaces remain compatible. No re-pairing is required by this update.
Credential field names are explicitly controlled by data-contract attributes. Merged runtime patching preserves custom-attribute metadata. Neither driver adds Newtonsoft.Json or log4net application dependencies.
Validation covers 108 net472 offline tests, 11 .NET 10 extension lifecycle tests, and the same 119 cases in a temporary processor test host. Neither actual driver is deployed for this validation and no processor reboot is performed. Real-driver installation and Apple TV control are not claimed as tested by these simulated suites.
See test dependencies and instructions.
NUnit 5 test package 1.1.0 - 1 October 2026
This is a test-tooling update attached to the existing release. Product binaries, product version and NuGet packages are unchanged.
Processor test package | Documentation | Validation receipt | Build sources | SHA-256 checksums
Uses NUnit 5.0.0. 108 offline cases passed in each of two runs from the packaged assembly on Windows. Processor-only lifecycle fixtures are skipped on Windows and are not included in that pass count. All packaged suite identities were checked against source discovery. Live/manual and processor runtime tests were not repeated for this migration; previous hardware results do not certify this package. The test package version is independent of the product version.
AppleTVCrestronDriver Tests v1.0.2
AppleTVCrestronDriver Tests
1.0.2
- Classify the 11 simulated extension lifecycle tests as an automatic processor suite, alongside the 105 unit/integration cases. A test-only workflow can now execute all 116 cases without live-test opt-in.
- The lifecycle tests construct isolated test entities and supply synthetic bridge events. They do not connect to a physical Apple TV or configure the installed production driver.
- This updates only the GitHub processor test package. No production driver or NuGet release is included.
1.0.1
- Rebuild with CrestronHomeNUnit 1.2.1. Test execution now participates in the shared processor reservation used by the runner, Test Explorer, CLI and hardware CI.
- The net472 package contains 116 discovered cases, with 105 in automatic suites. Live suites remain optional and require private inputs where documented.
- Use the standalone Utility tile, Windows runner, or the solution's Test Explorer workflow project. Private workflow plans can remove the temporary instance after testing.
- This is an independent processor-test package release on GitHub; it does not publish or update a driver/library NuGet package.
1.0.0 — 2026-09-14
- 105 offline tests and 11 SDK lifecycle tests, shared between desktop validation and the net472 processor package.
- Cover saved pairing, shared credential restoration, discovery identity persistence, configured-name changes, retry recovery and superseded discovery/connection attempts. Cancellation prevents old connection attempts from persisting identity or reporting a paired state for a newer configuration.
- Install the standalone test package from Configure’s Utility category. Select suites using its Home tile or the Windows NUnit runner.
- Processor test packages are GitHub release assets and are not published to NuGet. Private test inputs and deployment settings are excluded.
AppleTVCrestronDriver Tests v1.0.1
AppleTVCrestronDriver Tests
1.0.1
- Rebuild with CrestronHomeNUnit 1.2.1. Test execution now participates in the shared processor reservation used by the runner, Test Explorer, CLI and hardware CI.
- The net472 package contains 116 discovered cases, with 105 in automatic suites. Live suites remain optional and require private inputs where documented.
- Use the standalone Utility tile, Windows runner, or the solution's Test Explorer workflow project. Private workflow plans can remove the temporary instance after testing.
- This is an independent processor-test package release on GitHub; it does not publish or update a driver/library NuGet package.
1.0.0 — 2026-09-14
- 105 offline tests and 11 SDK lifecycle tests, shared between desktop validation and the net472 processor package.
- Cover saved pairing, shared credential restoration, discovery identity persistence, configured-name changes, retry recovery and superseded discovery/connection attempts. Cancellation prevents old connection attempts from persisting identity or reporting a paired state for a newer configuration.
- Install the standalone test package from Configure’s Utility category. Select suites using its Home tile or the Windows NUnit runner.
- Processor test packages are GitHub release assets and are not published to NuGet. Private test inputs and deployment settings are excluded.
AppleTVCrestronDriver v1.4.3
AppleTVCrestronDriver v1.4.3
The 1.4.2 publication attempt stopped before producing driver binaries or publishing NuGet because an existing Git exclusion omitted the required versioning script. Version 1.4.3 includes that script and the fixes above; the earlier tag is preserved.
Patch release correcting lifecycle, configuration and recovery defects while preserving the public API and intended driver behavior.
Fixes
- Cancel superseded discovery and connection attempts before they can persist stale identity or report an obsolete paired state.
- Initialize the extension app list as an empty collection. Clearing its configuration also clears apps, selected app, keyboard state, volume capability and power state.
- Add regression coverage for saved pairing, shared credential restoration, configured-name changes, reconnect recovery and extension configuration cleanup.
Tests and build process
- 105 offline tests and 11 SDK lifecycle tests. The current implementation passes on Windows in Debug and Release; both processor suites passed twice in the same host process.
- The shared net472 processor test package is available in the solution and appears under Utility in Configure. Its standalone Home tile and Windows NUnit runner select the test suites.
- Driver Debug build versions follow the manifest; three-part release tags select the CI release version. Test builds do not increment or deploy the production driver.
- Processor test packages are not published to NuGet. Private deployment settings, live inputs and desktop SDK runtime dependencies are excluded from source and release assets.
Installation and documentation
The GitHub release includes the production driver package and a separate processor test package. The test package appears under Utility in Configure and is not included in the driver NuGet package. See CHANGELOG.md for release history and README.md for installation and testing.
AppleTVCrestronDriver v1.4.2 — incomplete publication
This publication attempt stopped before driver binaries or NuGet packages were published because a required build script was excluded from Git. The tag and test artifacts are retained for provenance. The corrected driver release is v1.4.3.
AppleTVCrestronDriver v1.4.2 Patch release correcting lifecycle, configuration and recovery defects while preserving the public API and intended driver behavior. ## Fixes - Cancel superseded discovery and connection attempts before they can persist stale identity or report an obsolete paired state. - Initialize the extension app list as an empty collection. Clearing its configuration also clears apps, selected app, keyboard state, volume capability and power state. - Add regression coverage for saved pairing, shared credential restoration, configured-name changes, reconnect recovery and extension configuration cleanup. ## Tests and build process - 105 offline tests and 11 SDK lifecycle tests. The current implementation passes on Windows in Debug and Release; both processor suites passed twice in the same host process. - The shared net472 processor test package is available in the solution and appears under Utility in Configure. Its standalone Home tile and Windows NUnit runner select the test suites. - Driver Debug build versions follow the manifest; three-part release tags select the CI release version. Test builds do not increment or deploy the production driver. - Processor test packages are not published to NuGet. Private deployment settings, live inputs and desktop SDK runtime dependencies are excluded from source and release assets. ## Installation and documentation The GitHub release includes the production driver package and a separate processor test package. The test package appears under Utility in Configure and is not included in the driver NuGet package. See CHANGELOG.md for release history and README.md for installation and testing.
v1.4.1
Patch release fixing two extension driver regressions introduced in 1.4.0's restructuring: the app-selector no longer re-selects/retains a previously launched app across app-list refreshes, bridge reconnects, or driver reloads (and no longer undoes Home clearing the selection), and the app-selector label no longer shows a blank dash on startup instead of the Launch Application placeholder. See CHANGELOG.md and AppleTVCrestronExtensionDriver/CHANGELOG.md for details.
v1.4.0
Internal restructuring to facilitate unit testing (orchestration logic for pairing, stored-device persistence, connection/reconnect handling, discovery, and keyboard/text bridging extracted behind small internal interfaces). No functional or behavioral change. See CHANGELOG.md and AppleTVCrestronExtensionDriver/CHANGELOG.md for details.