Обзор

Teleportus даёт вам живой, управляемый вид вашего Mac прямо в Telegram — без VPN, без лишних приложений на телефоне. Эта страница объясняет трёхзвенную архитектуру и ссылается на все разделы документации.

Как это работает

Ваш Mac                    Edge-релей               Ваш телефон (Telegram)
──────────────────         ─────────────────        ──────────────────────
Демон Teleportus    ───►   Relay-сервер      ───►   Mini App (просмотр)
  захват экрана      WS     кадры + ввод      WS     тап → события ввода
  контроллер ввода  ◄───                     ◄───   клавиатура, скролл
  аудио / камера                                     аудио, переключение
  локальный AI

Демон — процесс на машине, которой вы хотите управлять. Захватывает экран через Swift-бинарник, применяет ввод мышью/клавиатурой через nut-js, стримит аудио в обе стороны и может запускать задачи Claude локально.

Релей — форвардер WebSocket, который ничего не хранит: кадры и ввод просто проходят через него в зашифрованном виде (WebSocket поверх TLS, wss://). Каждое подключение проверяется по подписанным данным входа от Telegram, поэтому подключиться может только ваш аккаунт Telegram.

Mini App — открывается прямо в Telegram по нажатию кнопки Open Desktop. Показывает живой стрим, отправляет тапы как события ввода, управляет переключением камеры/экрана и голосовым вводом.

Быстрый старт

1. Установите демон на Mac, которым хотите управлять. Когда он запущен, в menu bar macOS появляется иконка Teleportus:

   

2. Откройте Telegram и отправьте /remote боту — получите кнопку Open Desktop.

3. Нажмите кнопку и ваш экран появится на телефоне.

Что можно делать

Действие	Как
Смотреть экран в реальном времени	Mini App стримит JPEG-кадры
Двигать мышью и кликать	Тапнуть в нужное место на стриме
Печатать текст	Клавиатура телефона или экранная
Скроллить	Свайп двумя пальцами по стриму
Переключиться на камеру	Тоггл в Mini App (экран ↔ камера)
Голосовая команда	Зажать кнопку микрофона, говорить
Запустить AI-задачу	Написать задачу боту в свободной форме
Шеринг только просмотр	Поделиться ссылкой — аккаунт не нужен

Что дальше

• Установка — настройка демона
• Возможности — полный список функций
• Интерфейс Mini App — управление и жесты
• Команды бота — всё, что понимает бот
• Шеринг — дать кому-то посмотреть ваш экран
• Архитектура — протокол и внутреннее устройство
• Решение проблем — частые вопросы