Skip to main content

S2C

demo

A secret video chat "in terminal" using PGP encryptions and AES encryptions. No Browser needed !

Features

  • Video + Audio Chat in terminal

Requirements

  • Python (>3.10 is recommended)
  • poraudio.h (for the audio forwarding, more details later)

How to use

Installation

Install bindings librairies for pyaudio !

  • On linux/Mac : sudo apt install -y portaudio19-dev and sudo apt install -y pyaudio

Because it's a pip package, you need to install it using pypi !

pip install s2c

Manual

Client

The manual of s2c :

usage: s2c [-h] [-s SESSION_ID] [-c CLIENT_ID] [-k KEY] [-i IP] [-p PORT]

optional arguments:
  -h, --help            show this help message and exit
  -s SESSION_ID, --session_id SESSION_ID
                        The sesion_id, if noting is provide,it will generate
                        for you
  -c CLIENT_ID, --client_id CLIENT_ID
                        Your id or name in the session, if noting is
                        provide,it will generate for you
  -k KEY, --key KEY     To provide the custom key for the AES encryption
  -i IP, --ip IP        The host of the server where websockets will transits
  -p PORT, --port PORT  The port of the host

For example : $s2c -s 1 -c 1 -i 127.0.0.1 -p 1122 Will connect you to the server '127.0.0.1:1122' in the session '1', your id is '1' !

Server

NB : At this step, the server should be running on ip : 127.0.0.1 and on port 1122, don't forget to allow the port using ufw (on linux)

To run the server :

s2c_server -p 1122

FROM SOURCES

HOW TO INSTALL

Install bindings librairies for pyaudio !

  • On linux/Mac : sudo apt install -y portaudio19-dev and sudo apt install -y pyaudio

Clone and set the virtualenvironment :

# We clone the repository
git clone https://github.com/sanix-darker/s2c

# Install uv if you haven't
pip install uv

# Build the package (will use pyproject.toml)
uv pip install .

# Or for development install
uv pip install -e .

HOW TO LAUNCH

SERVER

The server take only one parameter, the port, where it's going to run !

python3 -m server.main -h

usage: main.py [-h] [-p PORT]

optional arguments:
  -h, --help            show this help message and exit
  -p PORT, --port PORT  The port where the server will be running

CLIENT

Just as the section Manual under How to use, you just have to replace s2c by python3 -m client.main

About

Metadata

Release files for s2c 0.0.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for s2c 0.0.7
File Size Uploaded
s2c-0.0.7.tar.gz 10.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for s2c 0.0.7
File Interpreter ABI Platform
s2c-0.0.7-py3-none-any.whl Python 3 none any Details

Total release size: 21.2 kB

Release files / s2c-0.0.7.tar.gz

Download URL s2c-0.0.7.tar.gz
Size 10.2 kB
Tags Source
SHA-256 checksum
How to use checksums
06130d37550e18240b362b85695401a5c426dcb68bc725dd4f08ce7fe1366d58
BLAKE2b-256 checksum
How to use checksums
ca841547e55bcdfe0b506a9abb6032d4077b5c889ec2be713924c988b8cc9fed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Release files / s2c-0.0.7-py3-none-any.whl

Download URL s2c-0.0.7-py3-none-any.whl
Size 10.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bf28ecd1771edd8090f3e984c2b53dc2276dd0cb9e2eee5d82474379edeb8672
BLAKE2b-256 checksum
How to use checksums
c0a8817bd44c3f5948a460d59c0717fa247d14ff17082efb614c9b57b29ac96c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Release history Release notifications | RSS feed

This release

0.0.7 This release

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page