Skip to content
BranchesTags

Repository files navigation

⚡ Elysium Vanguard — Screen Mirror Studio

Low-latency P2P screen mirroring & recording between macOS and Android

Platform Platform WebRTC License


Real-time Android screen streaming to macOS with PIP compositing, neon annotations, and HEVC recording — all over LAN with zero cloud dependency.

Quick Start (Pre-built Release)

No Xcode needed. Download, install, and run in 2 minutes.

macOS — Elysium Vanguard.app

Step Action
1 Download ElysiumVanguard-v1.7-mac.zip
2 Unzip → drag Elysium Vanguard.app to /Applications
3 Right-click → Open (first launch only, bypasses Gatekeeper)
4 Go to System Settings → Privacy & Security → Screen Recording
5 Enable the toggle for Elysium Vanguard
6 Launch the app — no more permission prompts

Android — APK

Step Action
1 Download ElysiumVanguard-v1.7.apk
2 Install on your Android device (enable "Unknown sources")
3 Open the app → tap LINK to grant screen capture permission

Pairing & Recording

  1. Mac: Launch Elysium Vanguard → click MODO DUAL ELYSIUM
  2. Android: Tap LINK → app auto-discovers Mac via Bonjour (same LAN)
  3. WebRTC handshake completes automatically (ICE trickle over TCP:9999)
  4. Mac: Click INICIAR GRABACIÓN to record composited output as MP4
  5. Hotkeys: ⌘⌥1/2/3 to switch Android PIP layouts
  6. Draw neon annotations directly on screen (baked into recording)

Architecture

┌─────────────────────────┐         LAN (TCP:9999 + WebRTC)         ┌──────────────────────────┐
│     Android Sender      │ ◄══════════════════════════════════════► │     macOS Director       │
│    (Honor Magic V2)     │                                         │    (Apple Silicon)       │
│                         │    ┌─────────────────────────────────┐   │                          │
│  MediaProjection        │    │  Signaling: JSON-over-TCP       │   │  ScreenCaptureKit        │
│  → ScreenCapturerHook   │    │  Media: WebRTC VP8/HW           │   │  → MetalCompositor       │
│  → WebRTC PeerConn      │────│  Metadata: DataChannel          │───│  → AVAssetRecorder       │
│  → DataChannel (fold)   │    │  Discovery: Bonjour/NSD         │   │  → AudioMixer            │
│                         │    └─────────────────────────────────┘   │  → EphemeralCanvas       │
└─────────────────────────┘                                         └──────────────────────────┘

Features

macOS Director

  • Screen Capture — 60fps via ScreenCaptureKit with GPU acceleration
  • 3-Pass Metal Compositor — Mac screen + Android PIP + Neon annotations
  • HEVC Recording — H.265 up to 8K with AAC-LC 256kbps audio
  • Dynamic PIP — Cubic-eased transitions for fold state morphing
  • Ephemeral Annotations — Neon glow strokes baked directly into MP4
  • System Audio Mixing — ScreenCaptureKit audio bridged to AVAudioEngine
  • Auto-Discovery — Zero-config Bonjour browser with auto-reconnect
  • Cyberpunk Dashboard — Real-time telemetry: FPS, P2P status, fold state
  • Floating HUD — Glassmorphism toolbar with record, annotate, spotlight, color picker
  • Hotkeys — ⌘⌥1/2/3 for PIP layout switching

Android Sender

  • Hardware Capture — MediaProjection → EGL → WebRTC (zero software copies)
  • Fold State Propagation — WindowInfoTracker → DataChannel → Mac PIP morph
  • Orientation Tracking — Real-time screen rotation sync
  • Premium Haptics — Taptic Engine composition API patterns
  • Foreground Service — Android 14+ compliant background capture
  • Cyberpunk UI — Grid background, neon glow, radar animations, telemetry panel

Build from Source

Prerequisites

  • macOS 14+ with Xcode 15+ and Swift 5.9+
  • Android Studio Hedgehog+ with API 34 SDK
  • Both devices on the same LAN

macOS (Director)

cd mac
swift build -c release
# Binary: .build/release/MacDirector

# To create a signed .app bundle:
# 1. Copy binary to Elysium Vanguard.app/Contents/MacOS/
# 2. Copy WebRTC.framework to Contents/Frameworks/
# 3. Add Info.plist with bundle ID com.jsm.macdirector
# 4. Sign: codesign --force --deep --sign - --entitlements Elysium.entitlements "Elysium Vanguard.app"

Android (Sender)

cd android
./gradlew assembleRelease
# APK: android/app/build/outputs/apk/release/

macOS Permissions

Elysium Vanguard requires Screen Recording permission to capture your display.

First Launch

  1. macOS will prompt: "Elysium Vanguard would like to record this computer's screen"
  2. Click Open System Settings
  3. Enable the toggle for Elysium Vanguard
  4. Quit and relaunch the app

Troubleshooting Permissions

  • "Elysium Vanguard" not in the list? Launch the app once, then check Settings
  • Toggle won't stick? Remove the entry with tccutil reset ScreenCapture com.jsm.macdirector, then relaunch
  • App opens Settings every time? This was fixed in v1.7 — update to the latest release

Bundle Info

Property Value
Bundle ID com.jsm.macdirector
Entitlements sandbox OFF, JIT, unsigned memory, audio input
Code Sign ad-hoc (no developer account required)
WebRTC embedded in Contents/Frameworks/

Project Structure

├── android/
│   └── app/src/main/java/com/jsm/core/
│       ├── MainActivity.kt            # Compose UI + orchestration
│       ├── foldable/
│       │   └── FoldStateListener.kt   # WindowInfoTracker bridge
│       ├── sensory/
│       │   └── SensoryFeedbackManager.kt  # Haptic patterns
│       ├── signaling/
│       │   ├── NsdBroadcaster.kt      # Bonjour/NSD registration
│       │   └── SignalingServer.kt     # TCP JSON signaling server
│       └── webrtc/
│           ├── CaptureForegroundService.kt  # Android 14+ lifecycle
│           ├── RTCClient.kt           # PeerConnection + DataChannel
│           └── ScreenCapturerHook.kt  # MediaProjection → WebRTC
├── mac/
│   ├── Package.swift
│   ├── Elysium.entitlements
│   └── Sources/MacDirector/
│       ├── JSMApp.swift               # SwiftUI entry point
│       ├── MainRouter.swift           # Central orchestrator
│       ├── Capture/
│       │   ├── AudioMixer.swift       # System audio → AVAudioEngine
│       │   └── ScreenCaptureManager.swift  # SCStream 60fps
│       ├── Recorder/
│       │   └── AVAssetRecorder.swift  # HEVC + AAC writer
│       ├── Renderer/
│       │   ├── EphemeralCanvas.swift   # Neon annotations + cache
│       │   ├── LayoutMorphEngine.swift # Cubic PIP transitions
│       │   └── MetalCompositor.swift   # 3-pass GPU pipeline
│       ├── Sensory/
│       │   └── SensoryFeedbackManager.swift  # Haptics + sounds
│       ├── Signaling/
│       │   ├── BonjourBrowser.swift    # Zero-config discovery
│       │   └── SignalingClient.swift   # TCP client + auto-reconnect
│       ├── UI/
│       │   ├── DashboardView.swift    # Cyberpunk dashboard
│       │   ├── HotKeyObserver.swift   # ⌘⌥ keyboard shortcuts
│       │   └── MainHUD.swift          # Floating glassmorphism toolbar
│       └── WebRTC/
│           ├── RTCController.swift    # PeerConnection receiver
│           └── RTCVideoSink.swift     # CVPixelBuffer extractor
├── release_assets/
│   ├── ElysiumVanguard-v1.7-mac.zip   # Signed macOS app
│   ├── ElysiumVanguard-v1.7.apk       # Android APK
│   └── MacDirector-v1.7.zip           # Source build
└── README.md

Tech Stack

Layer macOS Android
UI SwiftUI + AppKit Jetpack Compose + Material3
Capture ScreenCaptureKit (SCStream) MediaProjection + EGL
Compositing Metal + Core Image —
Recording AVAssetWriter (HEVC/AAC) —
Audio AVAudioEngine + PCM bridging —
WebRTC WebRTC.framework (M125) io.github.webrtc-sdk:android:125.6422.07
Signaling NWConnection (TCP client) ServerSocket (TCP server)
Discovery NWBrowser (Bonjour) NsdManager (mDNS)
Haptics NSHapticFeedbackManager VibratorManager + Composition API

Thread Safety Model

Resource Protection Threads
LayoutMorphEngine.currentLayout os_unfair_lock Main ↔ SCStream Capture
EphemeralEngine._cachedStrokes os_unfair_lock Main ↔ SCStream Capture
AudioMixer.systemAudioNode NSLock SCStream Audio ↔ AVAudioEngine Render
SignalingServer.clientWriter synchronized Accept ↔ Client Handler

Signaling Protocol

// Newline-delimited JSON over TCP:9999
{"type":"offer","sdp":"<base64-encoded-SDP>"}
{"type":"answer","sdp":"<base64-encoded-SDP>"}
{"type":"ice","candidate":"...","sdpMid":"audio","sdpMLineIndex":0}

Security

  • LAN-only — No STUN/TURN servers, zero cloud exposure
  • No credentials in repo — All secrets excluded via .gitignore
  • TCP_NODELAY — Minimal signaling latency, no buffering

Release Assets

File Description Size
ElysiumVanguard-v1.7-mac.zip Signed macOS .app bundle ~13 MB
ElysiumVanguard-v1.7.apk Android APK ~60 MB
MacDirector-v1.7.zip macOS source build ~1.1 MB

License

Proprietary. All rights reserved. © 2026 JSM Engineering.

About

Real-time Android ↔ macOS screen streaming and recording platform using WebRTC, MediaProjection, ScreenCaptureKit, Metal and AVFoundation over local networks.

Topics

androidavfoundationkotlinmacosmediaprojectionmetalnetworkingreal-timescreen-mirroringscreencapturekitswiftwebrtc

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages