Skip to content
MagerkoPublic

About

Android-телефон как веб-камера: OBS-плагин, виртуальная камера Windows 11, веб-панель (аналог DroidCam)

Topics

Resources

Stars

71 stars

Watchers

0 watching

Forks

Repository files navigation

MagerCam — телефон как веб-камера

Версия Скачивания Android 8.0+ Windows 11 Linux: плагин OBS Плагин OBS Studio GPL-2.0

Android-телефон становится веб-камерой и микрофоном для компьютера
по Wi-Fi или USB, для Zoom, Discord, Teams, Telegram, браузера и OBS. Бесплатно, без рекламы и водяных знаков.

⬇ Скачать · Установка · Возможности · Протокол

Программа MagerCam для Windows

Главное

📷 Настоящая веб-камера в Windows 11 Камера «MagerCam» видна в любой программе без драйверов. Можно подключить до четырёх телефонов сразу
⚡ Быстро и чётко Аппаратный H.264/H.265 до 4K и 60 к/с, адаптивный битрейт, низкая задержка
🔗 Подключение за секунды QR-код вместо IP-адресов, автопоиск в сети, USB через ADB с автозапуском приложения
🎙 Звук с телефона Микрофон с шумоподавлением, синхронно с видео
🪄 Обработка на телефоне Размытие и замена фона, автокадрирование по лицу, профили «Звонок / Стрим / Документ»
🎨 Цвет на компьютере Яркость, контраст, теплота, свои LUT .cube, режим документа для чёткого текста
🎬 Плагин OBS Источник с видео, звуком и полным управлением камерой прямо из OBS
🌐 Веб-панель Управление из браузера, MJPEG для VLC и IP-камер, детектор движения
🔒 Код доступа Чужой в той же сети не подключится к камере

Скриншоты

Приложение
Приложение
Настройки
Настройки
Плагин OBS
Плагин OBS

Веб-панель
Веб-панель в браузере

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

Часть Где Что делает
Android-приложение android/ → MagerCam.apk Камера (Camera2) → H.264/H.265 (аппаратный MediaCodec) + звук 48 кГц → сеть
Программа для Windows windows/ → MagerCam.exe Принимает видео с телефона и показывает его как веб-камеру «MagerCam» в Zoom, Discord, Teams, Telegram, браузере
Плагин OBS obs-plugin/ Источник «MagerCam (телефон)» прямо в OBS на Windows и Linux: видео + звук, управление камерой телефона
Веб-панель встроена в приложение http://IP:4848/: просмотр и управление из браузера, MJPEG для любых программ

Установка

Готовые файлы лежат в Releases: MagerCam.apk, MagerCam-Windows.zip, MagerCam-OBS-plugin.zip и MagerCam-OBS-plugin-linux.tar.gz.

1. Приложение на телефон

Скопируйте MagerCam.apk на телефон и откройте его (Android 8.0+). Разрешите камеру, микрофон и уведомления. Если телефон подключён по USB с включённой «Отладкой по USB», можно запустить install-apk.bat.

Начиная с 1.1.0 приложение подписано новым ключом. Если у вас стоит 1.0.0, удалите её перед установкой: поверх она не обновится.

2а. Программа для Windows (веб-камера для Zoom/Discord)

  1. Распакуйте MagerCam-Windows.zip и запустите install-windows.bat (он попросит права администратора). Если Windows покажет «Система Windows защитила ваш компьютер», нажмите «Подробнее» → «Выполнить в любом случае»: у программы пока нет платной цифровой подписи. Программа ставится в C:\Program Files\MagerCam, появляются ярлыки в «Пуске» и на рабочем столе. Для режима USB установщик сам скачает adb с официального сайта Google (Android platform-tools).
  2. Откройте MagerCam, выберите телефон и нажмите «Подключить»:
    • Wi-Fi: телефон находится кнопкой «Найти», или впишите IP с экрана телефона;
    • USB: переключатель «USB». Программа сама найдёт adb и сделает adb forward.
  3. В Zoom, Discord, Teams или браузере выберите камеру MagerCam.

Быстрее всего подключиться по QR: нажмите в программе «QR-сопряжение…» и отсканируйте код кнопкой QR в приложении (или обычной камерой телефона). Телефон сам передаст свой адрес и код доступа, вводить ничего не нужно. Установщик открывает для этого входящие TCP-порты 4850–4859 только для MagerCam.exe, во всех профилях сети: домашний Wi-Fi Windows часто помечает как общедоступный. Порт слушается, только пока открыто окно с QR-кодом.

Что умеет программа:

  • Виртуальная камера «MagerCam» без отдельного драйвера. Используется встроенный в Windows 11 механизм виртуальных камер (Media Foundation, MFCreateVirtualCamera). Отдаёт NV12 от 640×360 до 3840×2160 (4K) при 30 и 60 к/с. Пока телефон не подключён, показывает заставку «Нет сигнала».
  • Камера существует, пока открыта программа. Поэтому есть галочки «Запускать вместе с Windows» (стартует свёрнутой) и «Сворачивать в трей»: крестик и сворачивание прячут окно к часам, а не закрывают его. Выход через меню значка в трее.
  • Выбор объектива: в списке все камеры телефона. Это фронтальная и задняя, а на телефонах, которые это поддерживают, ещё и отдельные широкоугольный и телевик.
  • Разрешение и к/с из того, что реально умеют камера и кодер подключённого телефона (до 4K), битрейт до 50 Мбит/с, фонарик, автофокус, зум, экспозиция.
  • Поворот 0/90/180/270, зеркало, режим «Без полей (обрезать)» для вертикального телефона.
  • Звук с телефона выводится на выбранное устройство. Чтобы он стал микрофоном в Zoom/Discord, поставьте бесплатный VB-CABLE, выберите в MagerCam «CABLE Input», а в Zoom/Discord микрофон «CABLE Output».
  • Предпросмотр в окне, одна копия программы на каждую камеру (повторный запуск разворачивает уже открытую).
  • До четырёх телефонов сразу: кнопка «Ещё телефон…» открывает второе окно, и в системе появляется камера «MagerCam 2» (до «MagerCam 4»). У каждой свои настройки и свой автозапуск.
  • H.265: галочка «H.265 (меньше трафика)» вдвое снижает поток при том же качестве. Нужны кодер H.265 на телефоне и «Расширения для видео HEVC» из Microsoft Store (или драйвер видеокарты с HEVC) на ПК; без них программа сама остаётся на H.264.
  • Цвет: яркость, контраст, насыщенность, теплота, свои 3D-LUT в формате .cube и режим документа, который вытягивает белый лист и делает текст резче. Всё применяется к кадру до виртуальной камеры, поэтому видно в любой программе.
  • Функции телефона прямо из программы: профили «Звонок / Стрим / Документ», автокадрирование по лицу, размытие или замена фона (картинку можно выбрать на ПК), блокировка экспозиции и баланса белого, адаптивный битрейт, защита от перегрева, запись видео на телефон.
  • Код доступа с телефона вводится один раз и хранится в настройках. По USB он не нужен.
  • По USB программа сама запускает приложение на телефоне, если оно закрыто.

Удаление: uninstall-windows.bat (или install.ps1 -Uninstall из папки программы).

Windows 10 не поддерживает виртуальные камеры Media Foundation. Там используйте OBS: плагин MagerCam + кнопку «Запустить виртуальную камеру» в OBS.

2б. Плагин OBS

Подходит OBS Studio 30 и новее, включая 33: обычная установка, Steam и портативная версия из zip, x64 и Windows на ARM.

  1. Распакуйте MagerCam-OBS-plugin.zip целиком и запустите install-obs-plugin.bat. Установщик сам находит OBS и кладёт плагин туда, где его ищет именно ваша версия (обычно C:\ProgramData\obs-studio\plugins\magercam). Если нужно, он попросит права администратора. Портативную OBS он находит, если она запущена; ещё можно перетащить папку OBS на install-obs-plugin.bat. Перезапустите OBS. Если источник не появился, в конце установки есть блок с версиями Windows и OBS: пришлите его вместе с вопросом.
  2. Источники → + → MagerCam (телефон) → выберите телефон из «Найденные телефоны» или впишите IP. Для USB выберите «Подключение» → «USB (через ADB)».
  3. Звук с микрофона телефона идёт в OBS вместе с видео, синхронно. Отключается галочкой «Передавать звук с микрофона телефона».
  4. Если на телефоне включён код доступа, впишите его в поле «Код доступа».

Удаление: uninstall-obs-plugin.bat.

2в. Плагин OBS для Linux

Нужен OBS Studio 30 или новее из пакетов дистрибутива (sudo apt install obs-studio) или из PPA obsproject/obs-studio. OBS из Flatpak не подойдёт: он не видит плагины из домашней папки.

tar xzf MagerCam-OBS-plugin-linux.tar.gz
sh MagerCam-OBS-plugin-linux/install.sh

Скрипт сам выбирает сборку под ту версию FFmpeg, с которой собран ваш OBS, и кладёт плагин в ~/.config/obs-studio/plugins/magercam, права root не нужны. Проверено на Ubuntu 24.04 / Linux Mint 22, Debian 13 / Ubuntu 25.x и Ubuntu 26.04. Дальше всё как в Windows: перезапустите OBS и добавьте источник MagerCam (телефон). Для USB поставьте adb: sudo apt install adb. Аппаратное декодирование работает через VA-API, если драйвер видеокарты его даёт, иначе плагин сам декодирует программно.

Чтобы картинка появилась в Zoom, Discord или браузере, включите в OBS «Запустить виртуальную камеру» (нужен модуль v4l2loopback: sudo apt install v4l2loopback-dkms).

Удаление: sh MagerCam-OBS-plugin-linux/uninstall.sh. На другом дистрибутиве плагин можно собрать из исходников, см. «Сборка».

Телефон и ПК должны быть в одной сети (для Wi-Fi). Чтобы подключаться через интернет (с дачи, из другого офиса), поставьте Tailscale на телефон и ПК и впишите в MagerCam адрес телефона вида 100.x.y.z (он виден на экране приложения) или подключитесь по QR — телефон передаст все свои адреса. Код доступа при этом обязателен. Автопоиск опрашивает всю подсеть напрямую, поэтому находит телефон, даже если роутер не пропускает broadcast. Если он всё же ничего не нашёл, впишите IP с экрана телефона вручную.

Возможности

Приложение

  • Любая камера телефона (задняя / фронтальная / широкоугольная / телевик), разрешение до 4K, 15–60 к/с, битрейт 1–50 Мбит/с
  • Звук с микрофона (источник: видеокамера / микрофон / голос с шумоподавлением / без обработки), кнопка mute
  • Фонарик, зум (включая 0.5x на поддерживающих телефонах), экспозиция, фокус (непрерывный / по касанию / бесконечность / макро / ручной)
  • Баланс белого, блокировки AE/AWB, антимерцание 50/60 Гц, стабилизация (EIS + OIS)
  • Работа в фоне и при выключенном экране (foreground service, wake/wifi lock), кнопка затемнения 🌙
  • Камера включается только когда есть зритель: превью, OBS, программа Windows или браузер
  • Автоповорот: картинка ровная в любом положении телефона (или фиксированная ориентация)
  • При перегрузке сети кадры сбрасываются до ближайшего ключевого, чтобы задержка не накапливалась
  • Адаптивный битрейт: на слабом Wi-Fi картинка становится мягче, но не замирает
  • H.265 для клиентов, которые его умеют: вдвое меньше трафика
  • Код доступа из 6 цифр (включён по умолчанию) и сопряжение по QR. После 10 неверных попыток адрес блокируется на минуту, а после 30 неверных кодов со всех адресов телефон минуту не принимает никакие
  • Профили «Звонок», «Стрим», «Документ»: разрешение, к/с, битрейт, объектив, стабилизация и звук одним нажатием
  • Автокадрирование: кадр плавно следует за лицом, как Center Stage
  • Размытие и замена фона на телефоне (модель сегментации работает прямо на телефоне, без интернета)
  • Запись в MP4 на сам телефон (Movies/MagerCam) параллельно с трансляцией, в полном качестве
  • Защита от перегрева: при горячей батарее снижает к/с и битрейт, потом возвращает

Плагин OBS

  • Wi-Fi с автопоиском (UDP) или USB через ADB (выбирает устройство, где запущен MagerCam)
  • OBS 30 и новее (проверено на 30.0, 31.1, 32.1, 33.0), Windows x64 и ARM64, Linux
  • Видео H.264/H.265 (программное или аппаратное декодирование: D3D11 в Windows, VA-API в Linux) + звук, синхронизированные по общим меткам времени
  • Код доступа, профили, фон, автокадрирование, блокировка экспозиции и кнопка записи на телефон
  • Режим минимальной задержки, автопереподключение, отключение при скрытии источника
  • Поворот 0/90/180/270/авто, зеркало
  • Управление телефоном прямо из свойств источника: объектив, фонарик, фокус, зум, экспозиция, ББ, антимерцание, стабилизация

Браузер / другие программы

  • http://IP:4848/: веб-панель: просмотр, все настройки, профили, загрузка картинки для фона, запись, детектор движения (сравнивает кадры прямо в браузере, звук, уведомление и галерея снимков — телефон как камера наблюдения)
  • http://IP:4848/video: MJPEG (OBS «Медиаисточник», VLC, любые IP-cam программы)
  • http://IP:4848/shot.jpg: снимок

Как устроена программа для Windows

телефон ──H.264+звук──▶ MagerCam.exe ──NV12──▶ общая память ──▶ magercam-vcam.dll ──▶ Frame Server ──▶ Zoom/Discord
          (Wi-Fi/USB)   декодер MF,      Global\MagerCamVirtualCamera   (COM media source,
                        WASAPI-звук                                      служба Windows)
  • windows/client/: программа на C/Win32. Сеть и автопоиск, декодер H.264/H.265 из Media Foundation, цветокоррекция и LUT, QR-сопряжение, вывод звука через WASAPI, UI и трей. Регистрирует виртуальную камеру через MFCreateVirtualCamera на время работы. С ключом --slot 2..4 работает как вторая–четвёртая камера.
  • windows/vcam/: media source (C++/COM), который служба камер Windows (Frame Server) загружает в свой процесс. Читает кадры из общей памяти и отдаёт их приложениям с точным темпом 30/60 к/с.
  • windows/common/: общий формат разделяемой памяти (seqlock, NV12), масштабирование/поворот NV12, генератор QR-кодов.
  • windows/install.ps1: регистрация COM-классов всех четырёх камер в HKLM (служба не видит HKCU), правило брандмауэра для QR-сопряжения, ярлыки, скачивание adb, удаление.

Сборка

Всё собирается llvm-mingw (MSVC не нужен) из Git Bash. Зависимости кладутся в C:\mc-build (переопределяется MC_DEPS):

sh obs-plugin/setup-deps.sh    # llvm-mingw, заголовки libobs/FFmpeg, import-библиотеки из установленного OBS
sh obs-plugin/build.sh         # → obs-plugin/build/magercam.dll
sh windows/build.sh            # → windows/build/MagerCam.exe, magercam-vcam.dll и dist/windows/
cd android && ./gradlew assembleRelease   # APK (JDK 17 + Android SDK 34)

Плагин для Linux собирается на самом Linux (нужны build-essential pkg-config libobs-dev libavcodec-dev libavutil-dev libcairo2-dev):

sh obs-plugin/build-linux.sh          # → obs-plugin/build-linux/magercam.so
sh obs-plugin/linux/build-all.sh      # в Docker сразу три сборки для релиза: Ubuntu 24.04, Debian 13, Ubuntu 26.04

Для отладки: node tools/fake-phone.js [порт] [--key 123456] эмулирует телефон (тестовая картинка, тон 440 Гц, несколько объективов, H.264 и H.265 через ffmpeg, код доступа) по протоколу MagerCam. node tools/obs-test.js ws://127.0.0.1:4455 <пароль> автоматически тестирует источник через obs-websocket.

Структура

android/       приложение (Kotlin, Camera2, MediaCodec, встроенный HTTP-сервер)
obs-plugin/    плагин OBS для Windows и Linux (C, libobs + FFmpeg из OBS)
windows/       программа и виртуальная камера для Windows 11
docs/          протокол
tools/         эмулятор телефона и автотесты
*.bat          установка/удаление для пользователей

Лицензия

GPL-2.0. Плагин OBS собирается с libobs, которая распространяется под GPL-2.0, поэтому весь проект выпущен под той же лицензией.

Приложение использует модель MediaPipe selfie_segmenter (Apache 2.0) для отделения человека от фона. В файле android/app/src/main/assets/selfie_segmenter.tflite нестандартная операция MediaPipe Convolution2DTransposeBias заменена на встроенную TRANSPOSE_CONV, чтобы модель работала в обычном TensorFlow Lite; веса не менялись.

About

Android-телефон как веб-камера: OBS-плагин, виртуальная камера Windows 11, веб-панель (аналог DroidCam)

Topics

Resources

Stars

71 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages