v0.2.0

v0.2.0

v0.2.0 makes MirrorSim easier to control and moves the Windows distribution to a fully OSI-approved receiver stack. It adds customizable keyboard shortcuts, refreshes the Rust dependencies, and preserves the stable mirroring, audio, capture, recording, orientation, trust, and update experience from v0.1.5.

Customizable controls

• Adds a keyboard-shortcut editor under Preferences > Support.
• Supports custom bindings for audio mute, screenshots, recording, view mode, fullscreen, Minimal controls, Preferences, and diagnostics.
• Detects conflicting assignments before saving and provides a one-click reset to the default bindings.
• Updates in-app shortcut hints to reflect the active bindings.

Open receiver media stack

• Replaces Fraunhofer FDK AAC with FFmpeg 8.1.2's LGPL AAC-ELD decoder.
• Preserves iPhone audio, stereo playback, mute, recording audio, and phone-volume following with the new decoder.
• Removes the obsolete MSYS2 runtime dependency from the shipped receiver.
• Pins the immutable AirPlayServer v0.5.0 runtime and its published SHA-256 checksum.
• Ships a smaller FFmpeg build containing only the AAC and H.264 decoders and the required libavcodec, libavutil, and libswscale libraries.

Distribution and project readiness

• Adds WinGet package metadata and the public policies required for community support, privacy, security reporting, and release provenance.
• Documents the Authenticode signing process while the SignPath Foundation application is under review.
• Refreshes the desktop and receiver Rust dependency sets after full build, lint, test, and audit validation.

Licensing and provenance

• The receiver distribution contains components under OSI-approved MIT, BSD, zlib, LGPL, and GPL licenses.
• AirPlayServer's release workflow rejects any return of the removed FDK source tree and verifies that FFmpeg was built with GPL, nonfree, and version-3 components disabled.
• AirPlayServer v0.5.0 publishes the exact FFmpeg 8.1.2 source archive, source checksum, build configuration, runtime checksum, and GitHub build-provenance attestations.
• MirrorSim's packaged notices describe the receiver files actually included in the release.

Compatibility

The receiver keeps adapter protocol 0.8.0 and its existing pcm-audio, sender-volume, video-geometry, video-sender-state, and external-dnssd capabilities. Existing trusted-device records and application settings are preserved when updating from v0.1.5. MirrorSim remains a Windows x64 application.

Install

Choose one of the attached Windows builds:

• MirrorSim_*_x64-setup.exe - recommended NSIS installer.
• MirrorSim_*_x64_en-US.msi - MSI package for managed or advanced
  installations.
• MirrorSim-portable-*.zip - portable build with no installation required.

Windows may show a SmartScreen warning because the binaries are updater-signed
but are not yet Windows Authenticode-signed. SHA-256 hashes are included in
checksums.txt, and the GitHub release includes updater artifacts and
build-provenance attestations. See MirrorSim's
code signing policy
for the current status and verification details.

v0.1.5

v0.1.5

MirrorSim v0.1.5 is a reliability-focused update for long-running mirroring, app and video transitions, receiver-driven orientation, built-in discovery, and honest protected-picture guidance.

Highlights

• Follows trustworthy receiver-reported phone orientation while keeping manual Rotate as a temporary override.
• Advertises AirPlay with built-in mDNS, so MirrorSim no longer requires Bonjour for Windows.
• Distinguishes sender-paused pictures from a conservative protected-surface heuristic without claiming DRM as a certainty.
• Refines Console and Minimal mode with clearer connection guidance, consistent status states, complete tooltips, and a cleaner command layout.
• Keeps the existing iPhone audio, phone-volume following, framed captures, recording, fullscreen, updater, and support controls from v0.1.4.

Fixed and hardened

• Console mode now keeps its title centered, makes the full empty titlebar draggable, removes duplicate controls, and presents connection steps at a readable size in the Session panel.
• Listening, mirroring, recording, and error states now use consistent labels and colors without exposing the receiver adapter identifier in primary UI.
• Preferences can open directly to Capture or Devices, reset scroll position between sections, include a keyboard-shortcut reference, and use a conventional settings cog.
• Disabled capture controls explain when video must become ready, Minimal controls can be restored from the context menu, and keyboard shortcuts require their intended modifiers.
• Console capture notices live with Captures, its inspector remains scrollable at small window sizes, and live telemetry reports the actual source resolution.
• Long Minimal-mode errors wrap and remain readable instead of being truncated.
• Exported diagnostics redact stable device IDs, trust keys, session IDs, and pairing challenge IDs, including occurrences copied into sidecar logs.
• Automatic orientation follows receiver-reported source-screen geometry without mistaking a landscape media surface for a rotated phone; manual Rotate remains available as a temporary override.
• Protected-playback guidance now distinguishes an explicit sender-paused picture from a conservative multi-frame protected-surface heuristic, avoiding warnings for frozen frames, silent black screens, short fades, and detailed dark interfaces.
• Built-in discovery now reports its actual stopped, advertising, or failed state, and Refresh discovery re-registers an active receiver after network changes.
• Receiver discovery uses a private per-installation identity instead of exposing a physical adapter address or sharing a global fallback identity.
• PCM events are format-validated and size-limited at both the native adapter and Rust boundary.
• Invalid or missing audio packets are dropped and rate-limited without changing the live video state or flooding connection history.
• Recoverable receiver warnings no longer own the session state machine or rebuild a healthy video decoder; only explicit stream discontinuities can reset live media.
• The initial connection watchdog retires after the first accepted video frame, so a later recoverable audio fault cannot reset an established mirroring session back to Listening.
• The desktop audio queue is bounded and drops stale frames rather than allowing a stalled UI to grow memory indefinitely.
• Audio scheduling resets after timestamp discontinuities and excessive backlog to stay close to live playback.
• H.264 serialization now runs on a bounded receiver worker so a busy desktop UI cannot back-pressure and lag the iPhone.
• Live AirPlay video now uses a continuous WebCodecs H.264 decoder instead of retaining an ever-growing Media Source buffer, preventing long sessions from exhausting the browser media buffer.
• WebCodecs frames render directly to a persistent canvas instead of depending on a second browser video-presentation pipeline.
• The live canvas is preserved and moved with the video host across Minimal/Console remounts, preventing a healthy decoder from continuing inside a detached window surface.
• Decoder ownership changes are explicit instead of masquerading as an empty queue; stale clients automatically reacquire the stream and preview generations remain monotonic across resets.
• Overlapping development/HMR attachments serialize decoder preparation, closing a race where an already-disposed preview could invalidate the active one.
• Equivalent receiver descriptor refreshes no longer recreate the decoder, and recoverable connection transitions preserve the last drawable frame instead of erasing it.
• Canvas capture is now created only while recording instead of duplicating every decoded frame through an always-on hidden video bridge.
• Standalone AirPlay SPS/PPS changes are staged until the next real IDR, so codec metadata cannot invalidate an otherwise healthy decoder chain.
• Catch-up and stall recovery no longer seek into dependent H.264 frames; AirPlay sessions that provide only one initial IDR keep their decoder continuity.
• Explicit preview rebuilds are primed from a bounded keyframe group when one is available and otherwise report that a fresh Screen Mirroring connection is required instead of loading forever.
• Live playback no longer performs keyframe-unaware 20-second MSE eviction, which could erase the active H.264 dependency chain and freeze on an old frame.
• Preview diagnostics now report buffered ranges, keyframe distance, empty appends, decoder-client recoveries, canvas attachment/context loss, sampled pixel luma, and the latest browser media event/error.
• Frontend decoder diagnostics are retained in exported support reports every two seconds, so a future black-frame report can distinguish handoff, decoding, canvas, and source failures.
• Screenshots retain and capture the last decoded canvas frame across playback errors and preview retries, making freeze reports diagnosable even after the video bridge is torn down.
• Connection-history rows receive collision-resistant IDs and legacy duplicates no longer produce repeated React key errors.
• The native receiver keeps its mirror listener alive when an iPhone cycles the data socket during an app or video transition.
• Mirror-data socket interruptions now leave the AirPlay control session attached while preserving the decoder and last drawable frame; a resumed socket restores the live session without making the user select MirrorSim again.
• A sender pause immediately followed by a closed mirror-data socket no longer remains falsely Live or leaves the last frame looking like an active stream. MirrorSim reports that it is reconnecting and waits for the existing AirPlay session until the iPhone or user disconnects.
• Mirror timing probes now use the protocol's multi-second cadence and a realistic response window instead of retrying roughly 100 times per second when the iPhone takes longer than 1 ms to answer.
• Native diagnostics now preserve more than thirty minutes of pipeline history and record AirPlay control requests, control-socket lifecycle, timing timeouts, and mirror-data generations around an interruption.
• A malformed H.264 access unit is dropped instead of terminating the complete AirPlay session.
• Development diagnostics now retain native transport transitions and two-second video/audio pipeline counters.

Receiver requirement

This release bundles AirPlayServer v0.4.1 and requires adapter protocol 0.8.0 with the pcm-audio, sender-volume, video-geometry, video-sender-state, and external-dnssd capabilities.

Install

Choose one of the attached Windows builds:

• MirrorSim_*_x64-setup.exe — recommended NSIS installer.
• MirrorSim_*_x64_en-US.msi — MSI package for managed or advanced installations.
• MirrorSim-portable-*.zip — portable build with no installation required.

Windows may show a SmartScreen warning because the binaries are updater-signed but are not yet backed by a commercial Windows code-signing certificate. SHA-256 hashes are included in checksums.txt, and the GitHub release includes updater artifacts and build-provenance attestations.

v0.1.4

MirrorSim v0.1.4

MirrorSim v0.1.4 adds local iPhone audio, presentation-ready framed exports, and a focused production-readiness pass across the desktop UI, privacy controls, and native receiver boundary.

Highlights

• Plays decoded iPhone audio locally with mute and master-volume controls in Console, Minimal, and Preferences.
• Optionally follows the iPhone volume buttons using AirPlay's decibel attenuation without changing Windows system volume.
• Adds stereo and mono-compatibility playback plus a separate option to include full-level iPhone audio in new .webm recordings.
• Adds independent Include device frame options for screenshots and recordings.
• Splits Preferences into General, Audio, Capture, Connection, Devices, and Support sections.
• Adds About & Support with the installed version, a manual update check, project and issue links, licensing, privacy behavior, and known limitations.
• Uses genuine Windows fullscreen instead of maximizing the app window.
• Lets update notices be hidden until the next launch.

Fixed and hardened

• Long Minimal-mode errors wrap and remain readable instead of being truncated.
• Exported diagnostics redact stable device IDs, trust keys, session IDs, and pairing challenge IDs, including occurrences copied into sidecar logs.
• Orientation copy now matches actual behavior: rotation stays explicit because media dimensions do not reliably describe the physical phone orientation.
• PCM events are format-validated and size-limited at both the native adapter and Rust boundary.
• Invalid or missing audio packets are dropped and rate-limited without changing the live video state or flooding connection history.
• Recoverable receiver warnings no longer own the session state machine or rebuild a healthy video decoder; only explicit stream discontinuities can reset live media.
• The initial connection watchdog retires after the first accepted video frame, so a later recoverable audio fault cannot reset an established mirroring session back to Listening.
• The desktop audio queue is bounded and drops stale frames rather than allowing a stalled UI to grow memory indefinitely.
• Audio scheduling resets after timestamp discontinuities and excessive backlog to stay close to live playback.
• H.264 serialization now runs on a bounded receiver worker so a busy desktop UI cannot back-pressure and lag the iPhone.
• Live AirPlay video now uses a continuous WebCodecs H.264 decoder instead of retaining an ever-growing Media Source buffer, preventing long sessions from exhausting the browser media buffer.
• WebCodecs frames render directly to a persistent canvas instead of depending on a second browser video-presentation pipeline.
• The live canvas is preserved and moved with the video host across Minimal/Console remounts, preventing a healthy decoder from continuing inside a detached window surface.
• Decoder ownership changes are explicit instead of masquerading as an empty queue; stale clients automatically reacquire the stream and preview generations remain monotonic across resets.
• Overlapping development/HMR attachments serialize decoder preparation, closing a race where an already-disposed preview could invalidate the active one.
• Equivalent receiver descriptor refreshes no longer recreate the decoder, and recoverable connection transitions preserve the last drawable frame instead of erasing it.
• Canvas capture is now created only while recording instead of duplicating every decoded frame through an always-on hidden video bridge.
• Standalone AirPlay SPS/PPS changes are staged until the next real IDR, so codec metadata cannot invalidate an otherwise healthy decoder chain.
• Catch-up and stall recovery no longer seek into dependent H.264 frames; AirPlay sessions that provide only one initial IDR keep their decoder continuity.
• Explicit preview rebuilds are primed from a bounded keyframe group when one is available and otherwise report that a fresh Screen Mirroring connection is required instead of loading forever.
• Live playback no longer performs keyframe-unaware 20-second MSE eviction, which could erase the active H.264 dependency chain and freeze on an old frame.
• Preview diagnostics now report buffered ranges, keyframe distance, empty appends, decoder-client recoveries, canvas attachment/context loss, sampled pixel luma, and the latest browser media event/error.
• Frontend decoder diagnostics are retained in exported support reports every two seconds, so a future black-frame report can distinguish handoff, decoding, canvas, and source failures.
• Screenshots retain and capture the last decoded canvas frame across playback errors and preview retries, making freeze reports diagnosable even after the video bridge is torn down.
• Connection-history rows receive collision-resistant IDs and legacy duplicates no longer produce repeated React key errors.
• The native receiver keeps its mirror listener alive when an iPhone cycles the data socket during an app or video transition.
• Mirror-data socket interruptions now leave the AirPlay control session attached while preserving the decoder and last drawable frame; a resumed socket restores the live session without making the user select MirrorSim again.
• A sender pause immediately followed by a closed mirror-data socket no longer remains falsely Live or leaves the last frame looking like an active stream. MirrorSim reports that it is reconnecting and waits for the existing AirPlay session until the iPhone or user disconnects.
• Mirror timing probes now use the protocol's multi-second cadence and a realistic response window instead of retrying roughly 100 times per second when the iPhone takes longer than 1 ms to answer.
• Native diagnostics now preserve more than thirty minutes of pipeline history and record AirPlay control requests, control-socket lifecycle, timing timeouts, and mirror-data generations around an interruption.
• A malformed H.264 access unit is dropped instead of terminating the complete AirPlay session.
• Development diagnostics now retain native transport transitions and two-second video/audio pipeline counters.

Receiver requirement

This release requires AirPlayServer adapter protocol 0.7.0 with the pcm-audio and sender-volume capabilities. Publish and pin the matching AirPlayServer runtime release before tagging MirrorSim v0.1.4.

Install

Choose one of the attached Windows builds:

• MirrorSim_*_x64-setup.exe — recommended NSIS installer.
• MirrorSim_*_x64_en-US.msi — MSI package for managed or advanced installations.
• MirrorSim-portable-*.zip — portable build with no installation required.

Windows may show a SmartScreen warning because the binaries are updater-signed but are not yet backed by a commercial Windows code-signing certificate. SHA-256 hashes are included in checksums.txt, and the GitHub release includes updater artifacts and build-provenance attestations.

v0.1.3

MirrorSim v0.1.3

MirrorSim v0.1.3 is a reliability and security release focused on real iPhone connections, pairing, preview recovery, recording safety, and dependable updates.

Highlights

• Keeps the receiver listening after an iPhone disconnects and clearly restores the connection instructions.
• Uses the AirPlay pairing public key as the persistent device identity instead of trusting sender-provided metadata.
• Binds trust approval to the exact receiver session and pairing challenge so stale prompts cannot approve a later request.
• Restarts a crashed receiver with bounded backoff and restores the active listening session automatically.
• Shows explicit initialization, Bonjour, connection, and preview-recovery states with contextual actions.
• Reworks the opening flow around a single “Start listening” action, shows iPhone connection steps immediately, and only reports “Listening” after the receiver is actually ready.
• Makes the device preview fit smaller Console windows and makes zoom work consistently in Minimal mode.
• Keeps Minimal mode's title bar and drag surface spanning the full window when the phone frame is centered inside a wider viewport.

Fixed

• Interrupted recordings are finalized instead of silently discarded on disconnect or app close, and failed finalization remains retryable with the recovery path reported.
• Screenshot and recording filenames never overwrite an existing capture, even when timestamps collide.
• Recording finalization uses a no-overwrite move rather than filesystem hard links, so custom FAT, exFAT, network, and cloud-backed folders remain supported.
• Preview buffering now evicts only to a decodable keyframe boundary and waits for random access after a full queue drop.
• Oversized receiver messages and H.264 access units are rejected before unbounded allocation.
• Malformed H.264 SPS and Exp-Golomb data is rejected with checked parsing rather than risking overflow or a panic.
• Bonjour detection uses the Windows Service Control Manager API and no longer depends on localized sc.exe output.
• Preferences save in order, keep a revisioned fallback through quick closes or native-store failures, and report persistence errors.
• Only one MirrorSim instance can run at a time, preventing competing receiver and registry writers.
• Trust and history registries use durable, atomic replacement with a recoverable backup.
• Pairing preempts Preferences, only one focus trap can be active, and global shortcuts cannot mutate the app behind an open dialog.
• Destructive trusted-device resets and forget actions now require an explicit second confirmation.
• Receiver shutdown cancels pending pairing waits instead of hanging for the full approval timeout.

Runtime and release integrity

• Moves compressed H.264 directly through the headless sidecar path without unnecessary decode and audio allocation.
• Separates validation, signed artifact construction, and GitHub publishing into least-privilege jobs.
• Pins every GitHub Action to an immutable commit.
• Scans both Rust lockfiles against RustSec during CI, weekly scheduled validation, and every release; the two current quick-xml advisories are resolved.
• Cryptographically verifies every generated updater signature against the public key embedded in MirrorSim before publishing.
• Validates the native runtime file inventory, x64 architecture, and protocol handshake before packaging.
• Publishes SHA-256 checksums and GitHub build-provenance attestations with the installer, MSI, portable zip, updater signatures, and updater manifest.

Install

Choose one of the attached Windows builds:

• MirrorSim_*_x64-setup.exe - recommended NSIS installer.
• MirrorSim_*_x64_en-US.msi - MSI package for managed or advanced installations.
• MirrorSim-portable-*.zip - portable build with no installation required.

Windows may show a SmartScreen warning because the binaries are updater-signed but are not yet backed by a commercial Windows code-signing certificate.

Requirements

• Windows 10 or Windows 11, 64-bit.
• Bonjour for Windows.
• An iPhone and PC reachable on the same local network.
• Permission for MirrorSim to communicate through Windows Firewall on private networks.

SHA-256 hashes are included in checksums.txt. The GitHub release also includes signed updater artifacts, latest.json, and build-provenance attestations.

v0.1.2

MirrorSim v0.1.2

MirrorSim v0.1.2 is a focused connection-flow hotfix for returning to a ready state after an iPhone stops mirroring.

Fixed

• A normal iPhone disconnect now returns MirrorSim to Listening for your iPhone instead of leaving an empty preview in the connecting state.
• Connection instructions reappear immediately after the phone disconnects.
• The AirPlay receiver remains active, allowing the same or another iPhone to reconnect without clicking Start AirPlay again.
• The previous phone identity, preview buffer, and pairing state are cleared while the selected receiver access policy remains in effect.
• Disconnects are recorded as normal informational history events rather than stream warnings.

Install

Choose one of the attached Windows builds:

• MirrorSim_*_x64-setup.exe — recommended NSIS installer.
• MirrorSim_*_x64_en-US.msi — MSI package for managed or advanced installations.
• MirrorSim-portable-*.zip — portable build with no installation required.

Windows may show a SmartScreen warning because the binaries are updater-signed but are not yet backed by a commercial Windows code-signing certificate.

Requirements

• Windows 10 or Windows 11, 64-bit.
• An iPhone and PC reachable on the same local network.
• Permission for MirrorSim to communicate through Windows Firewall on private networks.

Verify downloads

SHA-256 hashes for every published artifact are provided in checksums.txt. Signed updater artifacts and latest.json are included for in-app update support.

v0.1.1

MirrorSim v0.1.1

MirrorSim v0.1.1 is a reliability and usability release focused on making the complete AirPlay connection flow predictable—from starting the receiver to approving, connecting, mirroring, recording, and disconnecting an iPhone.

Highlights

• Clear connection stages for starting, listening, approval, verification, attachment, and live video.
• More reliable receiver startup, shutdown, reconnection, and process cleanup.
• Correct approval behavior across Ask Every Time, Remember Trusted Devices, and Known Devices Only modes.
• Safer handling of rejected, blocked, and unknown devices before media begins.
• Improved capture, screenshot, recording, and session cleanup behavior.
• Better settings safeguards while the receiver is active.
• Hardened release packaging with validated PowerShell scripts and guarded bundle cleanup.
• Expanded automated coverage across the React UI, Tauri application, and native receiver integration.

Install

Choose one of the attached Windows builds:

• MirrorSim_*_x64-setup.exe — recommended NSIS installer.
• MirrorSim_*_x64_en-US.msi — MSI package for managed or advanced installations.
• MirrorSim-*-windows-x64-portable.zip — portable build with no installation required.

Windows may show a SmartScreen warning because the binaries are updater-signed but are not yet backed by a commercial Windows code-signing certificate.

Requirements

• Windows 10 or Windows 11, 64-bit.
• An iPhone and PC reachable on the same local network.
• Permission for MirrorSim to communicate through Windows Firewall on private networks.

Verify downloads

SHA-256 hashes for every published artifact are provided in checksums.txt. Signed updater artifacts and latest.json are included for in-app update support.

v0.1.0-1

MirrorSim v0.1.0-beta.1

First public beta of MirrorSim: a Windows app for mirroring an iPhone over AirPlay in a clean, presentation-ready device frame.

What’s included

• Live iPhone screen mirroring over Wi-Fi
• Minimal mode for a clean floating phone view
• Console mode with diagnostics, connection status, and controls
• Portrait/landscape framing with rotation support
• Screenshots to disk and/or clipboard
• Local .webm recording from the preview surface
• Installer and portable zip builds

Requirements

• Windows 10 or later, x64
• Bonjour for Windows
• iPhone and PC on the same Wi-Fi network
• Windows Firewall allowing MirrorSim on the current network

Unsigned beta notice

MirrorSim is currently unsigned while the project is early-stage. Windows SmartScreen may show a warning on first launch.

To run it:

1. Click More info
2. Click Run anyway

Only download MirrorSim from this official GitHub Releases page. SHA-256 checksums are included in checksums.txt.

Current limitations

• Audio capture/playback is not included yet
• DRM-protected video playback is not supported
• AirPlay discovery depends on Bonjour, firewall, and local network behavior
• Sleep/wake reconnect behavior can still depend on how iOS resumes the AirPlay session

Downloads

Most users should use the installer.

• MirrorSim_*_x64-setup.exe - installer
• MirrorSim-portable-v0.1.0-beta.1.zip - portable build
• checksums.txt - SHA-256 hashes