- Rust 98.9%
- Shell 1.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
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 системный таймер по умолчанию тикает раз в 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> |
||
| .cargo | ||
| .github/workflows | ||
| crates | ||
| deploy | ||
| .dockerignore | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| README.md | ||
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 ….
Использование
- Настройки: адрес сигнального сервера (
ws://илиwss://), хост, порт, логин и пароль CoTURN. - Трансляция: выберите монитор и нажмите «Начать трансляцию». Код трансляции передайте зрителям (кнопка «Копировать»).
- Просмотр: введите код (и пароль, если он задан) и нажмите «Смотреть». Во весь экран — 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).