Возможности

Живой стрим экрана

Демон захватывает дисплей Mac в виде JPEG-кадров и отправляет их через WebSocket на релей, который рассылает их всем подключённым зрителям. Частота кадров по умолчанию 6 fps, её можно поднять через переменную окружения FPS.

Если экран статичен (ничего не меняется), демон не отправляет лишние кадры — это снижает трафик на незагруженной машине. Новый зритель сразу получает последний закешированный кадр, не ждёт следующего тика.

Управление мышью и клавиатурой

Каждый жест по стриму в Mini App превращается в реальное событие на Mac:

• Клик — тап = левый клик в точке касания, долгое нажатие = правый клик
• Зум и панорама — щипок увеличивает до 6×, перетаскивание сдвигает картинку
• Скролл — свайп по стриму (на масштабе 1×) прокручивает; чем быстрее свайп, тем больше шагов прокрутки
• Печать — текст с клавиатуры телефона вставляется через буфер обмена, поэтому работает любой язык и любой Unicode: кириллица, эмодзи, CJK-символы
• Спецклавиши — Enter, Backspace, Tab, Escape, стрелки; модификаторы Shift/Ctrl/Alt/⌘ — переключаемые кнопки над клавиатурой

Аудио

Аудио стримится в обе стороны через нативные Swift-бинарники:

• Mac → телефон — системный звук (всё, что играет Mac) захватывается и стримится в Mini App
• Телефон → Mac — зажмите кнопку микрофона в Mini App, говорите; ваш голос воспроизводится через динамики Mac

Камера

Демон умеет стримить камеру Mac вместо экрана. Переключите источник тогглом в Mini App или отправьте /camera боту. Кадры с камеры никогда не пересылаются гостям с доступом «только просмотр» — камера видна только владельцу сессии.

AI-задачи

Демон запускает локальный Claude. Напишите боту инструкцию на естественном языке — например:

запусти тесты и покажи упавшие
открой браузер и перейди к ревью PR
напечатай "git status" и нажми Enter

AI выполняется как подпроцесс на вашей машине, видит экран и может делать многошаговые действия. Через релей передаётся только само сообщение с задачей.

Голосовые команды

Зажмите кнопку микрофона в Mini App для записи. Аудио отправляется в демон, который расшифровывает его локально через Whisper — небольшую голосовую модель, встроенную в демон и работающую прямо на вашем компьютере. Звук никуда не уходит для обработки. Результат обрабатывается как текстовая команда.

Шеринг только просмотр

Сгенерируйте ссылку через бота и отправьте кому угодно. Получатель открывает её в Telegram и видит ваш экран в реальном времени. Управлять машиной он не может, камеру не видит.

Подробнее — в разделе Шеринг.

Управление приложением в menu bar

После запуска Teleportus живёт в menu bar macOS. Иконка в строке меню — это пульт управления демоном: нажмите на неё, чтобы посмотреть состояние и переключить трансляцию.

• Статус подключения — подключён ли демон к релею и к какому именно
• Аптайм — сколько времени работает демон
• Зрители — сколько человек смотрят прямо сейчас
• Статус видео и микрофона — транслируется ли каждый из них
• Транслировать экран / Транслировать камеру — переключение источника
• Трансляция микрофона (⌘M) — включить передачу звука с телефона на Mac
• Выход (⌘Q) — остановить демон

Устойчивость к обрывам

Демон автоматически переподключается при разрыве WebSocket — с экспоненциальной задержкой от 3 секунд. Кадры возобновляются сразу после восстановления.

Новые зрители получают последний кешированный кадр мгновенно, без ожидания.