Skip to content

Latest commit

 

History

History
63 lines (41 loc) · 4.23 KB

README.en.md

File metadata and controls

63 lines (41 loc) · 4.23 KB

Linkage

Your Windows workstation, from your Mac

Website · 简体中文 · Development guide

Concept diagram: Windows renders and encodes; Mac decodes and displays; input returns to Windows.

Treat the Mac as a network display for a Windows workstation. Windows applications and CAD computation stay on Windows x86-64. The Mac receives video and audio, presents the desktop, and sends keyboard and pointer input back.

Development preview. No general-purpose installer yet. The working media path uses a modified Moonlight client and a Sunshine host with a virtual display. Native interaction, display clarity and portable configuration are still under development. The illustration above is a concept diagram, not a screenshot.

What we're building

  • Readable pixels: HEVC 4:4:4, actual VideoToolbox hardware-session verification, Metal presentation and reproducible pixel diagnostics.
  • Familiar input: Command editing shortcuts, configurable Option-to-Win/Alt mapping, hold Command-Q, cursor modes and trackpad release handling.
  • A Mac entry point: Swift/AppKit launcher, settings, fullscreen controls and audio streaming. The media component still uses Qt and SDL.
  • Cross-device clipboard: text and image transfer in both directions through a separate Windows session agent. Application-level acceptance is ongoing; file transfer is out of scope.

Current path: Windows applications → virtual display → DXGI → Sunshine/NVENC → network → modified Moonlight → VideoToolbox → Metal. Direct IDD texture capture is a future investigation, not an implemented feature. This is a streamed desktop, not per-application macOS window integration.

Evidence, with boundaries

A development setup using an RTX 4070 Ti SUPER and Apple M4 has streamed 2940 × 1846 at 60 Hz, HEVC 4:4:4, with a 100 Mbps bitrate configuration and verified hardware decoding. This does not establish universal codec support or physical-panel 1:1 mapping.

A physical scroll test produced 1,599 unambiguous event pairs. AppKit callback → SDL dispatch measured 0.529 ms median / 0.760 ms p95. This is one client-side stage, not end-to-end latency. Network, Windows application response, return video and panel scanout are excluded. See validation.

Build the independent tools

macOS 14+, Xcode Command Line Tools, Swift, CMake and Python 3.11+:

git clone https://github.com/Functionhx/Linkage.git
cd Linkage
python3 scripts/panebridge.py doctor
bash scripts/build-all.sh
bash scripts/check.sh

These build and test independent tools and cores, not a complete streaming installation. The current experimental GUI dependency set requires macOS 26+ on Apple Silicon. See the development guide for patch preparation, host requirements and limitations.

Website

cd website
npm ci
npm run dev
npm run build

Astro, Tailwind and TypeScript; static output, Chinese and English pages, build-time release discovery. Website task · Roadmap.

Contribute

Start with the independent cores and diagnostics. Report your hardware, viewport, codec, expected behavior and reproduction steps in an issue. Do not attach clipboard content, credentials or private desktop captures.

Acknowledgments and licenses

Built with Moonlight, Sunshine, Virtual Display Driver, FFmpeg and SDL.

Original components use MIT. Moonlight/Sunshine-derived patches retain GPL-3.0; FFmpeg and SDL retain their respective licenses. The combined client must comply with its dependency licenses. See LICENSE and THIRD_PARTY.md.

Independent project, unaffiliated with Apple, Microsoft, NVIDIA, Dassault Systèmes or MathWorks. Windows applications require their own valid licenses.