No description
  • Rust 98.9%
  • Shell 1.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
itc 345839d2f4
Some checks failed
CI / linux-e2e (push) Has been cancelled
CI / build (windows-latest, x86_64-pc-windows-msvc) (push) Has been cancelled
CI / build (ubuntu-22.04, x86_64-unknown-linux-gnu) (push) Has been cancelled
CI / build (macos-latest, x86_64-apple-darwin) (push) Has been cancelled
CI / build (macos-latest, aarch64-apple-darwin) (push) Has been cancelled
Производительность на Windows: точный таймер и многопоточное кодирование
На Windows системный таймер по умолчанию тикает раз в 15.6 мс, и sleep между
кадрами округляется вверх: сон на 33 мс превращается в 46 мс, вместо 30 к/с
выходит около 21, причём неравномерно — у зрителя это видно как рывки. Пока
работает конвейер трансляции, запрашиваем миллисекундную точность таймера.

OpenH264 распараллеливает кодирование только по слайсам: при одном слайсе на
кадр (так настраивала обёртка) число потоков принудительно опускается до 1.
Ограничение размера слайса 8 КБ включает многопоточность, не ухудшая сжатия:
на 1080p с полной сменой кадра кодирование ускорилось с 9.0 до 8.0 мс, битрейт
не изменился. При меньших слайсах битрейт заметно растёт.

Также: --monitor test:ШхВ задаёт размер тестовой таблицы для замеров, а на
уровне trace выводится разбивка времени на захват, конвертацию и кодирование.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 17:35:48 +04:00
.cargo Трансляция экрана по WebRTC: приложение, сигнальный сервер, захват экрана 2026-09-20 16:37:27 +04:00
.github/workflows Трансляция экрана по WebRTC: приложение, сигнальный сервер, захват экрана 2026-09-20 16:37:27 +04:00
crates Производительность на Windows: точный таймер и многопоточное кодирование 2026-09-20 17:35:48 +04:00
deploy Трансляция экрана по WebRTC: приложение, сигнальный сервер, захват экрана 2026-09-20 16:37:27 +04:00
.dockerignore Трансляция экрана по WebRTC: приложение, сигнальный сервер, захват экрана 2026-09-20 16:37:27 +04:00
.gitignore Трансляция экрана по WebRTC: приложение, сигнальный сервер, захват экрана 2026-09-20 16:37:27 +04:00
Cargo.lock Трансляция экрана по WebRTC: приложение, сигнальный сервер, захват экрана 2026-09-20 16:37:27 +04:00
Cargo.toml Трансляция экрана по WebRTC: приложение, сигнальный сервер, захват экрана 2026-09-20 16:37:27 +04:00
README.md Трансляция экрана по WebRTC: приложение, сигнальный сервер, захват экрана 2026-09-20 16:37:27 +04:00

Screencast — трансляция экрана по WebRTC на Rust

Кроссплатформенное приложение (Windows, macOS, Linux) для трансляции экрана и просмотра чужих трансляций. Интерфейс написан на egui (рендерер OpenGL/glow), медиа передаётся по WebRTC (webrtc-rs), NAT обходится через существующий сервер CoTURN.

  • Одна программа: и стример, и зритель.
  • Трансляция идёт по коду комнаты (например, K7M2QX), её можно защитить паролем.
  • До ~10 зрителей на трансляцию без медиасервера (mesh): кадр кодируется один раз, одни и те же RTP-пакеты рассылаются всем зрителям.
  • Режим «только через TURN» скрывает IP-адреса участников друг от друга.
  • Консольный режим для серверов, тестов и замеров.

Архитектура

 Стример                                    Зритель
 ┌────────────────────────────┐             ┌──────────────────────────────┐
 │ захват экрана (поток)       │             │ RTP → сборка кадров (tokio)   │
 │  DXGI / GDI / SCK / CGDS /  │             │  потери → PLI (ключевой кадр) │
 │  X11 SHM / PipeWire         │             │ декодер OpenH264 (поток)      │
 │ масштаб → I420 (SIMD)       │             │ I420 → OpenGL-текстуры        │
 │ OpenH264 (screen content)   │   WebRTC    │ YUV→RGB в шейдере (GPU)       │
 │ RTP-пакетизация — 1 раз     │═══SRTP/UDP══│                               │
 │ рассылка N PeerConnection   │  P2P или    │ egui: перерисовка по событиям │
 └──────────────┬─────────────┘  через TURN └───────────────┬──────────────┘
                │ WebSocket (SDP, ICE)                        │
                └──────────► сигнальный сервер ◄─────────────┘
                              (crates/signaling-server)
                    CoTURN: STUN + TURN (UDP) — уже существующий
Крейт Назначение
crates/protocol JSON-сообщения сигнального протокола
crates/signaling-server лёгкий WebSocket-сервер комнат (≈3 МБ памяти)
crates/capture захват экрана с выбором лучшего API для каждой ОС
crates/app приложение: GUI (egui), WebRTC, кодек, консольный режим

Поддерживаемые системы

ОС Захват Минимальная версия
Windows DXGI Desktop Duplication, откат на GDI Windows 10+ (штатный Rust), Windows 7/8 — см. ниже
macOS ScreenCaptureKit (12.3+), откат на CGDisplayStream 10.13 (Intel), 11.0 (Apple Silicon)
Linux, X11 MIT-SHM (GetImage для удалённых дисплеев), курсор — XFixes любой дистрибутив с X11
Linux, Wayland xdg-desktop-portal + PipeWire GNOME, KDE, sway/wlroots с порталом

Как достигается совместимость:

  • macOS. ScreenCaptureKit не линкуется, а загружается через dlopen во время работы, поэтому один бинарник работает и на 10.13, и на 26. Устаревший CGDisplayStream тоже вызывается через dlsym: в новых SDK он помечен как удалённый.
  • Windows. DXGI требует Windows 8+ и может не работать на ноутбуках с двумя видеокартами; в этих случаях автоматически используется GDI. Штатный тулчейн Rust с 1.78 собирает программы для Windows 10+. Для Windows 7/8 нужна сборка под tier-3 цель x86_64-win7-windows-msvc. Код захвата Windows 7 поддерживает, но зависимости там не проверялись:
    rustup toolchain install nightly --component rust-src
    cargo +nightly build --release -Z build-std --target x86_64-win7-windows-msvc -p screencast
    
  • Linux. Сборка по умолчанию динамически связана с libpipewire-0.3 (для Wayland). Для старых дистрибутивов без PipeWire соберите без этой зависимости: cargo build --release -p screencast --no-default-features (останется захват X11).
  • Графика. Интерфейс рисуется через OpenGL 2.1 / 3.2 core / ES 2.0 / ES 3.0, шейдер видео сам выбирает нужную версию GLSL. Если шейдер не собрался, включается конвертация на CPU.

Экономия ресурсов

  • Нет зрителей — нет работы. Пока никто не смотрит, захват и кодирование на паузе (0% CPU).
  • Статичный экран не кодируется. DXGI, ScreenCaptureKit и PipeWire сами сообщают, изменился ли экран; для GDI и X11 кадры сравниваются (memcmp).
  • OpenH264 в режиме SCREEN_CONTENT_REAL_TIME, один поток, низкая сложность. Ключевые кадры создаются только по запросу зрителя (PLI).
  • Один кодер на всех зрителей. С ростом числа зрителей растёт только исходящий трафик.
  • Масштабирование на GPU там, где оно бесплатно (macOS). В остальных случаях — SIMD (fast_image_resize), конвертация цвета тоже на SIMD (yuv).
  • У зрителя YUV→RGB считает шейдер. В видеопамять загружается в 2,7 раза меньше данных, конвертация на CPU не нужна.
  • egui перерисовывает окно только по событиям: новый кадр, ввод, статистика раз в секунду.
  • Небольшие пулы потоков: tokio с двумя рабочими потоками, буферы кадров переиспользуются, mDNS отключён.

Замер в release-сборке (Apple M-серии, 1280×720, 30 к/с, тестовая таблица меняется целиком в каждом кадре, то есть худший случай, 2 зрителя):

Процесс CPU (одно ядро) Память
стример (захват + кодирование) ≈23% 42 МБ
каждый зритель (приём + декодирование) ≈2% 45 МБ
стример без зрителей 0% 11 МБ
сигнальный сервер ≈0% 3 МБ

Сборка

Нужен Rust 1.85+ (edition 2024).

# Linux (Debian/Ubuntu): зависимости для Wayland/PipeWire
sudo apt install pkg-config clang libclang-dev libpipewire-0.3-dev

cargo build --release -p screencast -p signaling-server
# бинарники: target/release/screencast, target/release/screencast-signaling

На Windows и macOS дополнительные системные пакеты не нужны: OpenH264 собирается из исходников через cc.

Развёртывание сервера

CoTURN у вас уже есть. Рядом с ним нужен только сигнальный сервер:

screencast-signaling --listen 0.0.0.0:8443 --max-viewers 10
# или с TLS без обратного прокси:
screencast-signaling --listen 0.0.0.0:8443 --tls-cert fullchain.pem --tls-key privkey.pem

Готовые файлы лежат в deploy/: docker/docker-compose.yml, systemd/*.service и nginx/screencast.conf (для wss:// через nginx).

Что проверить в turnserver.conf:

listening-port=3478        # UDP — webrtc-rs поддерживает TURN только поверх UDP
lt-cred-mech
user=логин:пароль          # статический логин, который вводится в настройках приложения
realm=example.org
external-ip=ВНЕШНИЙ_IP     # если сервер за NAT
min-port=49152             # диапазон relay-портов должен быть открыт в файрволе (UDP)
max-port=65535

Проверить связь можно кнопкой «Проверить TURN» в настройках или командой screencast turn-test --turn host:3478 --turn-user … --turn-pass ….

Использование

  1. Настройки: адрес сигнального сервера (ws:// или wss://), хост, порт, логин и пароль CoTURN.
  2. Трансляция: выберите монитор и нажмите «Начать трансляцию». Код трансляции передайте зрителям (кнопка «Копировать»).
  3. Просмотр: введите код (и пароль, если он задан) и нажмите «Смотреть». Во весь экран — F11 или двойной щелчок, выход — Esc.

На macOS при первом запуске нужно разрешить запись экрана: «Системные настройки → Конфиденциальность и безопасность → Запись экрана». В Wayland экран выбирается в системном диалоге.

Консольный режим

screencast monitors
screencast broadcast --signal wss://signal.example.org --turn turn.example.org:3478 \
    --turn-user u --turn-pass p --monitor 0 --fps 30 --bitrate 2500 --password secret
screencast view K7M2QX --signal wss://signal.example.org --turn turn.example.org:3478 \
    --turn-user u --turn-pass p --relay-only --password secret
screencast broadcast --monitor test …   # тестовая таблица вместо экрана

screencast --help выводит полный список параметров.

Тестирование

cargo test --workspace                 # модульные тесты: протокол, сервер, кодек, настройки
deploy/docker/e2e-linux.sh             # интеграционный тест в Docker (см. ниже)

e2e-linux.sh поднимает изолированную docker-сеть с CoTURN и сигнальным сервером. Стример по-настоящему захватывает экран Xvfb через X11, а зритель подключается в режиме --relay-only, так что видео гарантированно проходит через TURN. Тот же тест запускается в CI (.github/workflows/ci.yml), где проект также собирается и проверяется clippy на Windows, macOS (arm64 и x86_64) и Linux.

Ограничения

  • Передаётся только видео, без звука.
  • Битрейт фиксированный (задаётся в настройках); адаптации к пропускной способности по REMB/TWCC нет.
  • TURN только поверх UDP (turn:…?transport=udp), без TCP и TLS — это ограничение webrtc-rs 0.21.
  • Mesh рассчитан примерно на 10 зрителей: исходящий трафик стримера растёт линейно. Для сотен зрителей нужен SFU.
  • Настройки, включая пароль TURN, хранятся в открытом виде в каталоге данных приложения (eframe persistence).