every communication program sucks
code is made for easily flexible communication program
structural design of prot.h made by github.com/6413 client uses github.com/6413/fan for window related things
Supports changing video encoder and decoder in runtime. Built in encoders and decoders:
- OpenH264
- X264
- NVENC, NVCUVID
With Nix (any distro, NixOS included):
nix run github:6413/ecps_guiOn Arch and the distros built on it (Manjaro, EndeavourOS, CachyOS), as a pacman package:
git clone --depth 1 https://github.com/6413/ecps_gui
cd ecps_gui/arch
makepkg -siRun makepkg -si there again to update, it builds the newest ecps_gui and fan.
The host can share what the computer is playing ("Share audio" next to the stream button or in Stream Settings), viewers turn it on and off with "Play audio". Audio is Opus, 48 kHz stereo in 20 ms packets, sent over UDP next to the video.
- Windows: WASAPI loopback of the default output device.
- Linux: the monitor of the default PulseAudio/PipeWire sink.
The host picks "Mouse + Keyboard" under Input Control, viewers then click the stream to control it. Control turns off when the stream stops.
- Windows: SendInput. Windows doesn't let it reach programs running as administrator.
- Linux X11: XTest (libXtst).
- Linux Wayland: a virtual mouse and keyboard through
/dev/uinput, which needs write access, e.g.sudo setfacl -m u:$USER:rw /dev/uinputor a udev rule. On several monitors the compositor decides how the virtual mouse maps to them.
Browsers connect through a small gateway that runs next to the ecps server. It needs Node.js.
On Windows, with the ecps server running, double-click web/start_web.bat. It builds
the page if needed, starts the gateway and opens the page. web/start_web_tunnel.bat
also opens an HTTPS tunnel for phones, and prints the link in its window. The password
and ports are at the top of both files.
The steps by hand:
- Start the ecps server.
- Build the page once, and again after changing the web code:
cd web
npm install
npm run build- Start the gateway from the
webfolder:
ECPS_HOST=127.0.0.1 ECPS_PORT=43254 WEB_PASSWORD=choose-one npm run gatewayIn PowerShell:
$env:ECPS_HOST = '127.0.0.1'
$env:ECPS_PORT = '43254'
$env:WEB_PASSWORD = 'choose-one'
npm run gateway- Open http://localhost:8080 on the same machine.
ECPS_HOST and ECPS_PORT are the ecps server's address. An empty WEB_PASSWORD
means no password. Phones and other devices need an HTTPS link, see
web/README.md for that and for all the settings.

