LumaStage

Открытая VTuber-студия
Desktop для Windows / macOS + трекер на iPhone с Face ID

Electron · React · SwiftUI · ARKit · GPL-3.0

🇷🇺 Русский · 🇬🇧 English · 🇯🇵 日本語 · 🇨🇳 中文 · 🇸🇦 العربية · 🇷🇸 Српски

---

✨ Что это

LumaStage собирает на сцене Live2D-модели (Cubism 3/4/5 и папки из VTube Studio), а мимику снимает iPhone по локальной сети.

• 🚫 без аккаунта
• ☁️ без облака
• 💳 без подписки
• 🏠 треккинг остаётся у тебя дома

---

🧩 Из чего состоит

	Часть	Что делает
🖥️	Desktop	Рендер модели, маппинг, сцены, хоткеи, оверлей под OBS
📱	Tracker	TrueDepth + ARKit на Face ID iPhone, низкая задержка, LAN
📡	Протокол	Открытый TCP / Bonjour — _lumastage._tcp, порт 39510
🔌	VTS API	Plugin API VTube Studio на ws://127.0.0.1:8001

⚠️ Проприетарный Live2D Cubism Core в репозиторий не входит.
Ставится из приложения (официальный CDN Live2D) или из SDK for Web.
Подробности → docs/compatibility.md

---

📦 Скачать

Готовые сборки → Releases

📁 Файл	🖥️ Платформа
LumaStage-macOS-0.1.1.dmg	🍎 macOS · установщик
LumaStage-macOS-0.1.1.zip	🍎 macOS · portable
LumaStage-Windows-0.1.1-Setup.exe	🪟 Windows · установщик
LumaStage-Windows-0.1.1-Portable.exe	🪟 Windows · portable
LumaStage-Tracker-0.1.1-unsigned.ipa	📱 iPhone · нужна своя подпись
LumaStage-0.1.1-source.zip	🧬 исходники релиза

📱 iPhone (Tracker)

IPA не подписан. Ставь через Feather / AltStore / Sideloadly / TrollStore — своим сертификатом.

1. ⬇️ Скачай LumaStage-Tracker-0.1.1-unsigned.ipa из релиза
2. ✍️ Подпиши и установи на iPhone с Face ID
3. 🖥️ Запусти Desktop, открой пару по 6-значному коду
4. 📶 Wi‑Fi: одна сеть или ручной IP из панели Connect Tracker или USB (Personal Hotspot по кабелю + IP ПК)

🔑 Первое подключение: код на десктопе → подтверждение на iPhone.
После этого сохраняется локальный токен устройства.
🪟 На Windows автопоиск (Bonjour) часто не видит ПК — введи IP и порт вручную в трекере. Разреши TCP 39510 в брандмауэре, если connect не проходит.

🖥️ Desktop

1. ⬇️ Поставь macOS / Windows сборку из релиза
2. 📥 При первом импорте модели — скачай Cubism Core (нужно согласие с лицензией Live2D)
3. 📂 Импортируй папку с *.model3.json (можно с *.vtube.json из VTS)
4. 📱 Подключи Tracker или работай в нейтральной позе без iPhone

---

✅ Что уже есть

	Фича
🎭	Импорт Cubism 3/4/5 и метаданных VTube Studio (маппинги, expressions, motions, hotkeys)
🎚️	Калибровка и сглаживание трекинга, живой редактор face → Live2D
🎬	Сцены: фон, трансформ модели, PNG / JPG / GIF items, pin к ArtMesh
📹	Прозрачный always-on-top оверлей под захват в OBS
🧩	Локальный VTS Plugin API (модели, hotkeys, items, physics, post-processing…)
🔒	Без облака: pairing только по LAN, токены только на устройствах

📖 Полная матрица API → docs/compatibility.md
🏗️ Архитектура → docs/architecture.md

---

🛠️ Разработка

Нужен Node.js 22+.

npm install
npm run dev          # desktop
npm test
npm run package:mac  # dmg / zip
npm run package:win  # setup / portable

📁 Структура

apps/desktop           # 🖥️ Electron + React
apps/ios               # 📱 SwiftUI + ARKit tracker
packages/protocol      # 📡 протокол трекинга
packages/vts-api       # 🔌 совместимость VTS Plugin API
packages/scene-core    # 🎬 сцены
packages/tracking-core
packages/model-compat
docs/                  # 📖 docs

iOS-проект: apps/ios. IPA удобнее собирать на Mac с Xcode.

---

📄 Лицензия

Исходники LumaStage — GPL-3.0-only.

Live2D Cubism Core, модели и чужие ассеты — по своим лицензиям.
См. THIRD_PARTY_NOTICES.md и docs/compatibility.md.

---

⭐ Stars

Star history chart ↗

Made with 💜 for VTubers · Download v0.1.1