iPhone-Mirror

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #rust #macos #java #awesome #cli #kubernetes #awesome-list #security #ios #openai

(★ 16)

No description available.

iPhone-Mirror Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# iPhone Mirror - AirPlay Receiver

App Electron nhận AirPlay mirroring từ iPhone/iPad để trình chiếu/quay màn hình iPhone trên PC Windows.

## Cách dùng nhanh

1. Chạy bản portable mới: `electron-app/dist-stable-window/iPhoneMirror.exe` hoặc file `iPhoneMirror.exe` đã copy ra Desktop.
2. Bấm **▶️ Khởi động AirPlay**.
3. Trên iPhone: mở Control Center → **Screen Mirroring/AirPlay** → chọn **iPhone Mirror**.
4. Khi iPhone kết nối, màn hình iPhone sẽ mở trong **một cửa sổ mirror riêng** của UxPlay/GStreamer.
5. Khi quay demo, quay cửa sổ mirror riêng đó. Không để iPhone quay lại đúng màn PC đang mirror để tránh vòng lặp hình gây lag/đơ.

## Bản sửa 2026-06-27 22:40: stable window mode

Bản trước cố nhúng native window của UxPlay/GStreamer vào Electron bằng Win32 `SetParent`. Trên Windows/GStreamer, hướng này dễ gây đen màn/kẹt render/đơ khi AirPlay đã bắt được nhưng video không vẽ ổn định.

Bản mới đổi sang hướng ổn định hơn:

- Electron chỉ làm **controller/log/status**.
- UxPlay/GStreamer giữ cửa sổ renderer riêng, không bị ép re-parent vào Electron.
- Trước khi start, app tự kill `uxplay.exe` cũ để tránh process treo giữ port/window.
- Có tùy chọn fullscreen (`-fs`) nếu anh bật trong UI.
- Package không còn đóng gói `window-embedder.ps1` vì không dùng nhúng nữa.
- UI/README đổi wording rõ: mirror mở ở cửa sổ riêng.

> Trade-off: giao diện không còn “nằm gọn trong khung iPhone” như mockup, nhưng ổn định hơn cho demo/quay màn hình. Nếu sau này cần khung đẹp, nên làm overlay/device-frame bằng OBS/capture window thay vì ép native window vào Electron.

## Bản sửa 2026-06-28 00:15: giảm chớp nháy Direct3D

Nguyên nhân chớp nháy là app liên tục gọi `SetWindowPos` để kéo cửa sổ `Direct3D11 renderer` đi theo frame realtime. Bản này đổi sang cơ chế ổn định hơn:

- Không sync video theo frame liên tục khi kéo/resize nữa.
- Khi start, app chỉ thử đặt video vào frame một số lần ban đầu.
- Sau khi kéo/resize frame, bấm **Mở/đặt lại khung iPhone kéo được** để sync video lại một lần.

Đổi lại: bớt chớp nháy hơn, nhưng video không tự chạy theo frame realtime.

## Bản sửa 2026-06-28 00:10: polish khung iPhone

Tinh chỉnh frame giả lập theo feedback:

- Nền ngoài viền trong suốt hơn, bỏ mảng/hint chữ gây rối.
- Chỉ giữ viền đen bo góc, notch và home bar nhẹ.
- Thêm dấu resize mờ ở góc dưới phải.
- Video được đặt sát hơn vào vùng màn hình bên trong frame.

## Bản sửa 2026-06-27 23:40: khung iPhone kéo được

Bản auto-style trước bỏ viền cửa sổ video nên không kéo được và vẫn không có cảm giác bo viền iPhone. Bản này đổi sang mô hình mới:

- App tạo một cửa sổ **iPhone Frame** riêng bằng Electron, trong suốt, always-on-top, có notch/home bar và kéo được ở vùng trên notch.
- Cửa sổ video `Direct3D11 renderer` được đặt đúng vào vùng màn hình bên trong frame.
- Khi kéo/resize frame, app gọi styler để đưa video đi theo frame.
- Nút **Mở/đặt lại khung iPhone kéo được** sẽ mở frame và sync lại video vào trong khung.

Cách này không bo góc trực tiếp video Direct3D, nhưng tạo khung iPhone kéo được thực dụng hơn cho quay demo.

## Bản sửa 2026-06-27 23:30: bắt đúng Direct3D11 renderer

Ảnh test thực tế cho thấy cửa sổ video thật có title **Direct3D11 renderer** và class **GSTD3D11**. Bản trước chỉ tìm theo PID UxPlay nên có thể không bắt đúng cửa sổ này. Bản này sửa `window-styler.ps1` để:

- Ưu tiên tìm theo PID như cũ.
- Nếu không trúng, fallback enum toàn bộ cửa sổ visible và ưu tiên `Direct3D11 renderer` / `GSTD3D11` / GStreamer.
- Log rõ title/class/hwnd khi style thành công.

Nếu cửa sổ video đã mở mà chưa thành kiểu iPhone, bấm **Đặt lại cửa sổ mirror kiểu iPhone**.

## Bản sửa 2026-06-27 23:15: auto-style mirror window

Bản overlay rời không đúng kỳ vọng vì cửa sổ mirror thật vẫn do GStreamer mở riêng ở giữa màn hình. Bản này đổi sang cách thực dụng hơn:

- Không dùng `SetParent`, không nhúng native window vào Electron.
- Khi iPhone kết nối và UxPlay/GStreamer tạo cửa sổ mirror, app tự tìm cửa sổ đó theo PID.
- App tự bỏ viền, đặt topmost và resize/center thành portrait `430x860` như màn hình iPhone.
- Có nút **Đặt lại cửa sổ mirror kiểu iPhone** nếu Windows/GStreamer mở lệch hoặc cần apply lại.

Đây là hướng gần nhất với mong muốn “kết nối là hiện overlay luôn” nhưng vẫn giữ renderer native ổn định.

## Bản sửa 2026-06-27 23:00: audio + iPhone frame overlay

Bản này bổ sung 2 điểm theo feedback test thật:

- **Âm thanh bật mặc định** qua Windows default output (`wasapisink`). Nếu không nghe tiếng, kiểm tra Windows Sound → Output device mặc định và Volume Mixer của app. Có thể bỏ tick âm thanh trong UI nếu chỉ cần hình mượt.
- **Khung iPhone overlay**: app mở thêm một cửa sổ trong suốt/always-on-top có viền iPhone, notch và home bar. Đặt/resize cửa sổ mirror của UxPlay nằm dưới overlay này để quay demo trông giống màn hình điện thoại, nhưng vẫn tránh nhúng native window vào Electron nên ổn định hơn.

Lưu ý: overlay không phải renderer video; nó là khung trang trí đặt lên trên cửa sổ mirror. Nếu cần bo góc video thật tuyệt đối thì nên dùng OBS crop/mask hoặc viết pipeline video riêng, không nên quay lại SetParent vì dễ kẹt render.

## Yêu cầu

- iPhone và PC cùng Wi-Fi.
- Bonjour/mDNS hoạt động (thường có nếu đã cài iTunes/Apple Bonjour).
- MSYS2 + GStreamer ở `C:\tools\msys64`.
- `uxplay.exe` đã build tại `uxplay-src/build/uxplay.exe`.

## Build

```powershell
cd electron-app
npm install

# Build portable vào thư mục mới, tránh lock dist cũ
npx electron-builder --win portable --config.directories.output=dist-stable-window
```

Nếu `npm run build` lỗi vì `dist/win-unpacked/resources/app.asar` bị Windows giữ lock, đóng app cũ hoặc build sang output mới như trên.

## File build đã verify

```text
electron-app/dist-stable-window/iPhoneMirror.exe
```

Đã chạy các check:

```powershell
node --check main.js
node -e "JSON.parse(require('fs').readFileSync('package.json','utf8')); console.log('package ok')"
npx electron-builder --win portable --config.directories.output=dist-stable-window
```

## Cấu trúc

```text
iphone-mirror/
├── uxplay-src/      # UxPlay AirPlay receiver
├── electron-app/    # Electron controller UI
│   ├── main.js      # Main process + start/stop UxPlay stable-window mode
│   ├── preload.js   # IPC bridge
│   ├── index.html   # UI + logs/status
│   └── package.json
└── README.md
```

## Test nhanh cho anh

1. Tắt AirPlay trên iPhone.
2. Đóng app iPhone Mirror cũ nếu đang mở.
3. Mở Task Manager, kill `uxplay.exe` nếu còn.
4. Chạy `iPhoneMirror.exe` bản mới.
5. Bấm **Khởi động AirPlay**.
6. iPhone cùng Wi-Fi → Screen Mirroring → chọn **iPhone Mirror**.
7. Nếu cửa sổ mirror nằm sau app, bấm `Alt+Tab` hoặc thu nhỏ cửa sổ controller.

## Use case

- Quay video demo app mobile cho khóa học.
- Trình chiếu màn hình iPhone lên monitor/projector.
- Dùng như AirPlay receiver nhẹ trên Windows.

iPhone-Mirror

iPhone-Mirror Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

iPhone-Mirror

iPhone-Mirror Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README