TermFace

Secure terminal video call. Your webcam rendered as color ASCII art, with end-to-end encrypted peer-to-peer calls.

What's New in v2.0

• End-to-end encryption — X25519 key exchange + XSalsa20-Poly1305 (libsodium) with perfect forward secrecy
• Opus audio codec — 24kHz at 32kbps (10x compression over raw PCM), echo cancellation, noise gate
• zstd compression — 3-5x compression for ASCII frames over the wire
• TCP media transport — reliable delivery with flow control (no more UDP packet drops)
• Session strings — share happy-sunset-ocean instead of IP addresses
• Multi-client grid — group calls with grid layout (coming soon)
• Auto-reconnection — exponential backoff with up to 5 retries
• Call quality stats — real-time RTT, bandwidth, and duration display
• LAN discovery — automatic peer discovery on local network

Install

From PyPI

pip install TermFace

From Source

git clone https://github.com/Yash12b/TermFace.git
cd TermFace
pip install -e ".[dev]"

Quick Start

ASCII Webcam (local)

ascii-cam
# or
termface ascii

Video Call

# Person A (call receiver) — start first, wait for incoming
termface facetime

# Person B (caller) — connect to A's IP
termface facetime --target 192.168.1.100

With Session Strings

# Person A starts with a session string
termface facetime --session happy-sunset-ocean

# Person B joins using the same session string
termface facetime --session happy-sunset-ocean --target 192.168.1.100

All Options

termface facetime --help
termface ascii --help

Controls (during call)

Architecture

terminal_webcam/
├── protocol.py     # Binary protocol (10-byte header, length-prefixed)
├── crypto.py       # libsodium X25519 + XSalsa20-Poly1305
├── audio.py        # Opus codec + echo cancellation + noise gate
├── video.py        # ASCII renderer + zstd compression + background effects
├── network.py      # TCP multiplexed transport + auto-reconnect
├── discovery.py    # LAN discovery + session strings + STUN
├── quality.py      # Adaptive quality + call stats
├── terminal_facetime.py  # Main app
└── webcam_ascii.py       # Local webcam viewer

Security

• E2E encryption by default using libsodium
• X25519 key exchange with ephemeral keys
• XSalsa20-Poly1305 AEAD cipher
• Key rotation every 256 messages
• Perfect forward secrecy — compromised key doesn't reveal past sessions
• Optional — both sides can use a shared passphrase for additional security

Testing

pip install -e ".[dev]"
pytest tests/ -v

License

MIT