EchoLens

📱→🖥️ Biến điện thoại Android thành webcam + mic cho Mac
Stream camera & microphone real-time qua H.264/JPEG • macOS 26 Liquid Glass UI

---

✨ Tính năng

• 🎥 Stream Video Real-time — H.264 hardware encoding (fallback JPEG) từ Android camera
• 🎙️ Stream Audio — PCM16 48kHz mono từ Android mic → Mac speaker
• 🔊 Return Audio — Mac audio → Android speaker (nghe Zoom trên điện thoại)
• 📷 Virtual Camera — Hiện như webcam trong Zoom, Google Meet, OBS...
• 🔗 USB & Wi-Fi — Kết nối qua USB (thấp latency nhất) hoặc Wi-Fi
• 📱 QR Code Pairing — Scan QR để kết nối nhanh, không cần nhập IP
• 🎨 macOS 26 UI — Thiết kế Liquid Glass với dark mode, frosted glass panels
• 🔴 Recording — Quay video trực tiếp từ stream
• 🔦 Camera Controls — Torch, zoom, chuyển front/back camera

---

📥 Tải về & Cài đặt

Tải từ GitHub Actions

1. Vào Actions → Build & Release
2. Chọn build mới nhất (✅ màu xanh)
3. Kéo xuống phần Artifacts và tải:
   • EchoLens-Android-APK → cho điện thoại Android
   • EchoLens-macOS-DMG → cho Mac

Cài đặt Android

1. Copy file EchoLens-v1.0-android.apk sang điện thoại
2. Mở file APK → cho phép "Install from unknown sources"
3. Cài đặt xong → mở app EchoLens

Cài đặt macOS

1. Mở file EchoLens-v1.0-macOS.dmg
2. Kéo EchoLens.app vào thư mục Applications
3. Lần đầu mở: chuột phải → Open (vì app chưa ký Developer ID)
4. Nếu bị chặn: vào System Settings → Privacy & Security → Open Anyway

⚠️ Lưu ý: App chưa được ký Apple Developer ID nên macOS sẽ cảnh báo "unidentified developer". Hoàn toàn an toàn — source code công khai.

---

🚀 Hướng dẫn sử dụng

Bước 1: Mở app trên Mac

Mở EchoLens trên Mac → QR code sẽ hiện lên ở sidebar trái.

Bước 2: Kết nối từ Android

Cách 1 — QR Code (Nhanh nhất):

1. Mở EchoLens trên Android
2. Nhấn "Scan QR from Mac"
3. Quét QR code trên màn hình Mac
4. App tự động kết nối!

Cách 2 — Nhập IP thủ công (Wi-Fi):

1. Đảm bảo Mac và Android cùng mạng Wi-Fi
2. Xem IP của Mac ở mục NETWORK trong sidebar
3. Nhập IP vào Android app → nhấn Connect

Cách 3 — USB (Chất lượng tốt nhất):

1. Kết nối điện thoại với Mac qua cáp USB
2. Bật USB debugging trên Android
3. Chạy lệnh trên Terminal:

adb reverse tcp:59090 tcp:59090
adb reverse tcp:59091 tcp:59091
adb forward tcp:59092 tcp:59092

4. Sử dụng IP 127.0.0.1 trên Android app

Bước 3: Bắt đầu stream

1. Nhấn "Start Streaming" trên Android
2. Mac sẽ nhận video + audio ngay lập tức
3. Mở Zoom/Google Meet/OBS → chọn camera EchoLens 🎉

Bước 4: Tính năng bổ sung

Tính năng	Cách dùng
🔦 Torch	Bật/tắt đèn flash trên Android
🔄 Switch Camera	Chuyển front ↔ back camera
🔍 Zoom	Kéo thanh zoom trên Android
🔴 Recording	Nhấn nút Record trên Mac sidebar để quay video
🎧 Phone Mic → Mac	Bật toggle "Phone Mic → Mac" trong Audio section
🔊 Mac → Phone Speaker	Nhập IP + bật "Mac → Phone Speaker" để nghe Mac audio trên điện thoại
🔄 Auto-Rotate	Bật ở bottom bar để tự xoay khi xoay điện thoại

---

🏗️ Build từ source

macOS

# Yêu cầu: Xcode 16+ / macOS 14+
xcodebuild -project EchoLens.xcodeproj \
  -scheme EchoLens \
  -configuration Release \
  build \
  CODE_SIGNING_ALLOWED=NO

Android

# Yêu cầu: JDK 17, Android SDK 36
cd android
./gradlew assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk

---

📁 Cấu trúc dự án

EchoLens/
├── mac/
│   ├── HostApp/          # SwiftUI app chính (Liquid Glass UI)
│   ├── CameraExtension/  # CoreMediaIO virtual camera
│   └── Shared/           # Constants, transport, H264 decoder
├── android/
│   └── app/              # Android sender (CameraX, H264, Audio)
├── docs/                 # Architecture docs, assets
└── .github/workflows/    # CI/CD (GitHub Actions)

---

🔧 Ports mạng

Port	Mục đích
59090	Video stream (H.264/JPEG) — Android → Mac
59091	Audio stream (PCM16 48kHz) — Android mic → Mac
59092	Return audio — Mac → Android speaker

---

📋 Yêu cầu hệ thống

	Tối thiểu	Khuyến nghị
macOS	macOS 13 Ventura	macOS 15 Sequoia+
Android	Android 9 (API 28)	Android 13+
Xcode	15.0	16.0+
JDK	17	17

---

☕ Ủng hộ tác giả

Nếu bạn thấy EchoLens hữu ích, hãy mua cho tôi một ly cafe! 😊

DO TAI
STK: 9021843687798
Timo Digital Bank by BVBank

---

📜 License

MIT License — Tự do sử dụng, chỉnh sửa và chia sẻ.

---

Made with ❤️ by Tai-DT