TermFace

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

Features

• Color ASCII webcam — real-time webcam rendered as colored ASCII art in your terminal
• Peer-to-peer calls — call friends directly, no server needed
• AES-256 encryption — all video/audio traffic is encrypted
• Background effects — blur or remove your background
• Edge detection — wireframe ASCII mode
• Text chat — send messages during calls
• File transfer — send files to your peer
• Screen sharing — share your screen instead of webcam
• Call recording — record calls to video files
• Adaptive quality — auto-adjusts to network conditions
• LAN discovery — finds peers on your local network

Quick Install

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/Yash12b/termface/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/Yash12b/termface/main/install.ps1 | iex

With pip (if Python is installed)

pip install TermFace

Usage

ASCII Webcam (local only)

ascii-cam
# or
termface ascii

Video Call

# You (caller)
termface facetime --target FRIEND_IP --encrypt-key mysecret

# Friend (receiver) — wait for incoming call
termface facetime --encrypt-key mysecret

All Options

termface facetime --help
termface ascii --help

Controls (during call)

Building from Source

# Install build tools
pip install Cython build twine

# Compile source to binaries
python build_cython.py

# Build wheel
python -m build --wheel

# Upload to PyPI
twine upload dist/*

License

MIT