IT-Deck · раздел 7 из 7

README с GitHub

v0.6.1 ·

IT-Deck

IT-Deck

Старый iPhone становится пультом для Windows-ПК. Один .exe на компьютере, QR-код — и телефон работает как панель кнопок, которая ещё и показывает, что делает ПК. Тот же телефон может стать веб-камерой для ПК.

English version

Ролик на 10 секунд с декой в горизонтальном положении: нажатие на Mic делает плитку красной, палец тянет ползунок Volume с 40 до 75 процентов, затем свайп переводит с деки Home на деку Gamer

А ещё этот телефон — веб-камера для ПК в Discord, Zoom и OBS:

Нужны Windows-ПК и телефон в той же сети Wi-Fi. Больше ничего ставить не надо.

Настройка за 5 минут

  1. Скачай ITDeck.exe. Открой страницу релизов и скачай ITDeck.exe.

  2. Запусти его. Дважды щёлкни по файлу. Windows SmartScreen может написать «Windows защитила ваш компьютер». Exe пока не подписан, так что это ожидаемо. Нажми «Подробнее», затем «Выполнить в любом случае».

  3. Откроется окно с QR-кодом. Это окно IT-Deck. В первый раз короткое обучение покажет, что где. Не закрывай окно.

    Окно IT-Deck на ПК: карточка «Подключить телефон» с QR-кодом, ссылкой и кнопкой «Скопировать ссылку», карточка «Сейчас» с открытыми деками, агентом Windows и IT-Deck Camera, внизу «Открыть Studio», «Свернуть» и «Выйти»
  4. Наведи камеру телефона на код. Подойдёт обычное приложение «Камера». Нажми на появившуюся плашку. Дека откроется в браузере.

    Дека Home на телефоне в горизонтальном положении: сверху широкая плитка Webcam и плитка Mic, ниже Sound, ползунок Volume, Audio Switch, Screenshot, Shut down, нагрузка ПК, Send text, часы и Lock PC, слева колонка быстрого запуска
  5. Добавь деку на экран «Домой». В Safari нажми «Поделиться», затем «На экран „Домой“». У деки появится своя иконка, как у приложения.

    Меню «Поделиться» в Safari на iPhone, пункт «На экран „Домой“» обведён

Это всё. Нажми плитку, и ПК выполнит команду. Плитка покажет, что вышло: плитка Mic краснеет, пока микрофон выключен.

Полезно знать.

  • «Выйти» в окне останавливает IT-Deck. «Свернуть» оставляет его работать.
  • В следующий раз запускай IT-Deck с ярлыка IT-Deck на рабочем столе — он его создал.
  • Плитке VPN нужен ещё один шаг: ей надо указать, какую программу запускать. См. «Настройка плитки VPN» в разделе «Ещё».

Телефон как веб-камера

Камера телефона становится веб-камерой на ПК. Только Windows 11. Настроить нужно один раз. Потом приложения вроде Discord, Zoom и OBS покажут её как IT-Deck Camera.

  1. Установи камеру. В окне IT-Deck найди карточку веб-камеры и нажми «Установить камеру». Windows спросит права администратора. Согласись. Это бывает один раз.

    Карточка веб-камеры в окне IT-Deck с тремя шагами: «Установить камеру», «Настроить телефон» и «Открыть Камеру Windows»; первый шаг ещё не выполнен
  2. Настрой телефон. Нажми «Настроить телефон». Появится QR-код. Отсканируй его камерой iPhone. В Safari откроется страница настройки.

    Зачем этот шаг? Телефон даёт камеру только странице, которой доверяет, так что сертификат IT-Deck (небольшой файл доверия) нужно один раз поставить на телефон. На странице четыре шага с картинками. Проходи их по очереди.

    Четыре шага страницы настройки на iPhone сеткой 2 на 2: 1 «Скачать профиль», 2 «Установить профиль» с нарисованными экранами «Настроек», 3 «Включить доверие» с переключателем IT-Deck local CA, 4 «На экран „Домой“» с кнопкой «Открыть деку»
  3. Открой деку. На последнем шаге есть кнопка «Открыть деку». Нажми её. На открывшейся странице нажми «Поделиться», затем «На экран „Домой“». Дальше пользуйся этой новой иконкой. Старую иконку IT-Deck можно удалить.

  4. Выбери камеру в приложении. В Discord, Zoom или OBS открой настройки камеры и выбери IT-Deck Camera. Пока там тёмная заставка. Так и должно быть.

    Настройки камеры в условном видеоприложении: список «Camera» с выбранной IT-Deck Camera и окно предпросмотра с заставкой IT-Deck
  5. Нажми Start на телефоне. Когда приложение открывает камеру, дека спрашивает «An app on the PC wants the camera». Нажми Start. В приложении появится твоя картинка.

    Дека на телефоне в горизонтальном положении с карточкой «An app on the PC wants the camera» и кнопками Not now и Start

Заметки.

  • По Wi-Fi лучше всего 720p при 30 кадрах в секунду. 1080p может рваться в слабой сети.
  • Камера останавливается сама через 15 секунд после того, как последнее приложение её закрыло.
  • Метка [IT-Deck] всегда в углу картинки.
  • Плитка Webcam запускает и останавливает поток нажатием. Долгое нажатие открывает экран веб-камеры: предпросмотр, смена камеры, зеркало и More — качество, частота кадров, поворот и статистика.
  • В Discord и Zoom твоё превью выглядит зеркальным. Собеседники видят кадр в правильную сторону.
  • Android, возможно, заработает через Chrome (шаги есть на странице настройки), но на настоящих телефонах это пока не проверяли.

Экран Webcam на телефоне в горизонтальном положении: область предпросмотра, кнопка Start, выбор камеры Front/Back, Mirror, строка состояния Not streaming и раздел More

Настрой деку под себя в Studio

Studio — место, где дека собирается. Нажми «Открыть Studio» в окне IT-Deck. Она откроется в браузере на ПК. Слева живой предпросмотр деки. Клик по плитке открывает её настройки, + добавляет новую, перетаскивание двигает. Что делает плитка, выбираешь карточками, команды набирать не надо. Кнопка «Гайд» в верхней панели — короткая инструкция с картинками.

Studio в стиле Graphite: живой предпросмотр деки Home в теме Keycap рядом с редактором плитки Webcam: значок, цвет, размер и положение; в верхней панели кнопки Decks, Access и What's new

Выбери вид из пяти тем плиток: Flat, Pastel, Glossy, Liquid Glass и Keycap. Каждая работает на тёмном и светлом фоне. Тема переключается «таблеткой» в шапке деки.

Одна и та же дека Home в пяти темах плиток рядом: Flat, Pastel, Glossy, Liquid Glass и Keycap

Если что-то не работает

Что видишь Что делать
QR-код или ссылка не открываются на телефоне Проверь, что телефон в той же сети Wi-Fi. Попробуй другие адреса, которые окно перечисляет под ссылкой — у ПК с VPN их несколько
Не работает ни один адрес Брандмауэр Windows: отменённый запрос оставляет правила «Блокировать» для itdeck.exe. Удали их во входящих правилах или сделай сеть частной
IT-Deck Camera нет в списке камер приложения Нажми «Установить камеру» в карточке веб-камеры и перезапусти приложение. Только Windows 11
Приложение показывает заставку вместо картинки Открой деку на телефоне и нажми Start. Пользуйся иконкой, которую добавил при «Настроить телефон»
Телефон не отдаёт камеру странице Сертификату ещё не доверяют. Запусти «Настроить телефон» снова и пройди все шаги
Картинка рвётся На экране Webcam открой More и поставь 720p при 30 кадрах в секунду. Проверь Wi-Fi
Плитка ничего не делает или дека превратилась в часы Остановилась часть на ПК. Нажми «Запустить агент» в окне IT-Deck (это нужно после плитки Close Agent). После сбоя она перезапускается сама
Плитка VPN ничего не делает У неё ещё нет пути. См. «Настройка плитки VPN» в разделе «Ещё»
Телефон просит токен Токен сменился. Введи новый или отсканируй QR-код заново
IT-Deck пишет, что порт уже занят Уже запущена другая копия. Закрой её кнопкой «Выйти» или заверши ITDeck.exe в диспетчере задач
Изменение не видно на телефоне Потяни страницу вниз, чтобы обновить, или закрой и снова открой иконку
Вообще ничего не стартует Загляни в %LOCALAPPDATA%\IT-Deck\logs\backend.log

Ещё

Всё ниже необязательно.

Что нового в 0.6.0
  • Телефон как веб-камера на Windows 11: IT-Deck Camera появляется в Discord, Zoom и OBS, как обычная веб-камера.
  • Стиль Graphite. Спокойная деловая палитра на телефоне, в Studio и в окне на ПК, тёмная или светлая — как в Windows. Новый логотип [IT-Deck].
  • Новая тема плиток Keycap.
  • Новое окно на ПК. Оно открывается с того, что происходит сейчас: открытые деки, Windows-агент, камера. Редкие действия переехали в «Настройки».
Что делает первый запуск и что нужно

При первом запуске IT-Deck кладёт ярлык IT-Deck на рабочий стол (дальше запускай с него), создаёт %LOCALAPPDATA%\IT-Deck\config.env с двумя токенами (по умолчанию оба admin) и портом (49732 или следующий свободный) и поднимает бэкенд и Windows-агент отдельными процессами. Консоли нет — логи лежат в %LOCALAPPDATA%\IT-Deck\logs\. Конфиг и токены переживают перезапуски: если удалить config.env или сменить порт, ссылка, сохранённая на телефоне, перестанет работать — тогда открой на нём новую один раз.

Всё, что IT-Deck запустил по твоей команде (включая VPN-клиент), продолжает работать после «Выйти».

Что нужно: Windows-ПК для управления (агент использует COM-API звука Windows и работает в интерактивном сеансе пользователя) и телефон с браузером в той же локальной сети. Для веб-камеры нужна Windows 11. Ни сервера, ни Docker, ни Python.

Плитки

Нажатие отправляет команду по WebSocket Windows-агенту, тот её выполняет и отвечает. Любая команда завершается за 5 секунд — успех, ошибка или таймаут, — и плитка показывает, чем именно. Долгое нажатие открывает меню с Force Stop для зависшего процесса.

Свежая установка создаёт восемь плиток, и за каждой стоит реальная команда:

Плитка Что делает
Terminal Запускает приложение — по умолчанию Windows Terminal
Mic Включает/выключает микрофон; красная во время мьюта
Volume Перетаскиванием задаёт громкость вывода
Headphones Включает/выключает звук динамиков
Audio Switch Переключает два устройства вывода и называет текущее
Screenshot Снимает главный монитор в буфер обмена ПК
VPN Запускает VPN-клиент, подсвечена, пока он работает — сначала нужен путь
Close Agent Останавливает агент; вернуть — кнопкой «Запустить агент» в окне IT-Deck

В Studio есть и другие:

Плитка Что делает
Webcam Нажатие запускает или останавливает поток с камеры телефона; долгое нажатие открывает экран Webcam
Время и погода Собственные часы и дата телефона плюс погода для выбранного города (Open-Meteo, без API-ключа)
Нагрузка ПК Живые полоски загрузки процессора и памяти, скорость сети
Горячие клавиши Нажимает сочетание клавиш на ПК, например ctrl+shift+m — выключить микрофон в Discord
Медиаклавиша Пауза/воспроизведение, следующий и предыдущий трек, стоп, громкость
Питание Блокировка, сон, выключение или перезагрузка; сначала спрашивает
Отправить текст Набираешь на телефоне, вставляешь на ПК: текст попадает в его буфер обмена
Вкл/выкл программу Запускает программу или закрывает её, если та уже работает

Любой плитке можно включить «Спрашивать перед запуском» — тогда телефон сначала покажет «Запустить / Отмена». Некоторые игры и античиты игнорируют программные нажатия клавиш, поэтому внутри них плитка горячих клавиш может не сработать.

Быстрый запуск. «Открыть сайт» открывает любой адрес в браузере ПК (готовые пресеты: Telegram Web, Discord, YouTube, ChatGPT и другие), а «Открыть программу» выбирает программу прямо из меню «Пуск» на ПК. Такие кнопки попадают в панель быстрого запуска: до семи квадратных кнопок внизу, когда телефон стоит вертикально, и слева, когда лежит горизонтально. Значок — символ, логотип, пара букв или иконка самого сайта. Среди логотипов — популярные сервисы, а также игры и лаунчеры: Steam, Epic Games, Battle.net, EA, Ubisoft, GOG, Valorant, League of Legends, Counter-Strike, Dota 2, PUBG, Fortnite, Roblox и другие. Установленная игра получает свой логотип сама.

Несколько дек. Если дек больше одной, листай их свайпом вбок на телефоне; точки под шапкой показывают, где ты, и переключают по нажатию. В Studio в окне «Деки» их можно переставить, переименовать, скачать и удалить, добавить новые и выключить переключение свайпом.

Когда ПК-сторона отваливается — закрыт агент или сам IT-Deck, — каждая плитка превращается в кнопку, которая ничего не может, поэтому виджет часов занимает весь экран в виде семисегментных часов и продолжает показывать время, пока ПК не вернётся. Дека восстанавливается сама, переключать ничего не нужно.

Внешний вид — это две настройки: тема (Flat, Pastel, Glossy, Liquid Glass, Keycap) переключается «таблеткой» в шапке деки, фон (авто, светлый, тёмный) задаётся в Studio. Обе синхронизируются на все подключённые телефоны. Окно на ПК и Studio следуют теме Windows, тёмной или светлой.

Studio подробнее

/studio.html на ПК — кнопка «Открыть Studio» в окне. Слева живой предпросмотр деки, справа редактор: устройства звука подставляются из списка, который сообщает агент; программы — через «Выбрать из установленных программ» (меню «Пуск» и приложения Microsoft Store); «Где» ставит кнопку в сетку или в панель быстрого запуска; компактная раскладка убирает дыры в сетке. Язык — английский или русский, по языку браузера. С телефона каталог не меняется. «Гайд» в первый раз открывается сам.

Остальное в верхней панели:

  • «Деки» — сохранить деку на экране в файл, добавить деку из файла или начать с шаблона («Стример», «Работа»). Файл всегда становится новой декой и не меняет существующую. Открывай только файлы, которым доверяешь: плитка может запускать программы на ПК.
  • «Доступ» — посмотреть и сменить оба токена (см. ниже).
  • «Что нового» — последние изменения; точка горит, пока не прочитаешь.
Токены и PIN

Их два: токен телефона (его присылает телефон) и токен агента (его присылает Windows-агент). Оба по умолчанию admin — для своего Wi-Fi этого достаточно. Если сеть общая, смени их:

  • «Настройки» → «Новый токен телефона» в окне IT-Deck создаёт случайный 6-значный токен телефона. QR-код обновляется, а телефоны со старым токеном один раз спросят новый. «Показать токен агента» лежит в той же карточке.
  • Studio → «Доступ» меняет любой из токенов вручную или создаёт случайный PIN. Изменение применяется сразу, без перезапуска.
Настройка плитки VPN

Пока путь не задан, наверху Studio висит карточка «Укажи путь до VPN-клиента». Вставь полный путь до .exe и нажми «Сохранить». Быстрее всего получить его так: выдели файл в проводнике и нажми Ctrl+Shift+C — кавычки, которые он добавляет, Studio уберёт сама.

После этого плитка подсвечивается всегда, когда программа запущена, — в том числе до первого нажатия. Нажатие запускает VPN; чтобы остановить, зажми плитку и выбери Force Stop.

Если плитка сообщает, что программа запускается от администратора — это самая частая причина «мёртвой» плитки VPN: Windows показывает запрос UAC на ПК, а у тебя в руках телефон. Либо сними галку «Запускать эту программу от имени администратора» в свойствах exe → «Совместимость», либо запускай сам ITDeck.exe от администратора.

Одна плитка-переключатель. В редакторе плитки VPN нажми «Сменить тип», выбери «Программа вкл/выкл» и укажи имя процесса (например, v2RayTun.exe) и путь до exe. Тогда одно нажатие запускает, следующее — останавливает. Подтверждения нет, поэтому по умолчанию не так.

Бережно к играм

IT-Deck задуман так, чтобы работать рядом с игрой и не отнимать FPS. Пока ни один телефон не открыл деку, агент вообще не опрашивает звук и процессы. Бэкенд и собственная работа агента идут с пониженным приоритетом, так что занятый процессор в первую очередь достаётся игре; программы, которые запускает IT-Deck, получают обычный приоритет. Проверка VPN запоминает процесс, а не перебирает список процессов каждую секунду. Замеренная стоимость, пока телефон открыт: около 0,1 мс работы в секунду.

С веб-камерой то же правило. Пока камера выключена, ничего не работает, а когда она включена, это не мешает игре.

«Запускать IT-Deck вместе с Windows» (в «Настройках», по умолчанию выключено) запускает его при входе в систему.

Обновления

Окно один раз при запуске проверяет страницу релизов и показывает кнопку «Скачать», если вышла новая версия. Это один запрос, ничего о тебе не отправляется, любая ошибка молча игнорируется. Выключается через UPDATE_CHECK=0 в config.env. Устареть может только exe — телефон каждый раз загружает деку из той версии, которая запущена. Если драйвер камеры старее того, что в новом exe, в карточке веб-камеры появится «Обновить камеру»; Windows ещё раз спросит права администратора.

Настройки переживают обновления. Плитки, деки, токены и порт хранятся в %LOCALAPPDATA%\IT-Deck, а не в exe: заменил exe — всё на месте. После обновления окно один раз показывает короткую карточку «Что нового».

Как удалить IT-Deck

В «Настройках» окна есть неприметная кнопка «Удалить IT-Deck с этого ПК». Она удаляет сам exe, ярлык с рабочего стола, настройки, токены и раскладку плиток, правила брандмауэра Windows и временный каталог, в который exe распаковывается, — это всё, что IT-Deck вообще пишет на диск. Если удалить только exe, остальные четыре следа останутся.

Сначала он спросит — в окне со списком того, что исчезнет; фокус стоит на «Отмена», так что Enter и Escape просто закрывают его. Windows один раз спросит разрешение — оно нужно только для правил брандмауэра, и если отказаться, всё остальное всё равно удалится. Иконка на домашнем экране телефона останется — её удали на телефоне.

Удаление сначала убирает и IT-Deck Camera (для этого Windows спросит права администратора). Если просто удалить exe, камера останется в Windows: перед этим нажми «Удалить камеру» в «Настройках».

Статус

Личный проект, активная разработка. Последняя версия на странице релизов, что изменилось — в CHANGELOG.md.

Лицензия

Бесплатно для личного и другого некоммерческого использования по PolyForm Noncommercial License 1.0.0: пользуйтесь и делитесь. Сейчас IT-Deck бесплатен. Коммерческое использование — только по договорённости с автором: напишите мне.

Исходный код закрыт: IT-Deck распространяется готовым exe. Название IT-Deck и логотип обозначают этот проект и его автора, а официальные сборки выходят только в релизах этого репозитория — см. NOTICE. Нашли ошибку или есть идея? Создайте issue.

Что IT-Deck включает в себя или с чем работает (пакеты Python, NirSoft SoundVolumeView, Open-Meteo, логотипы Simple Icons), перечислено вместе с условиями в THIRD-PARTY-NOTICES.md. Логотипы — товарные знаки их владельцев и нужны только чтобы показать, какое приложение открывает плитка.

Репозиторий на GitHub

Раздел прочитан?

Это последний раздел.