Example server running at qinusty.co.uk port 5000
/register <username> <password> is used to register an account with the server
/login <username> <password> is used to attempt to authenticate with the server
/msg <username> <message> is used to communicate with a user via username (end to end encryption is used)
/gmsg <groupname> <message> is used to communicate with a group via the server, all messages are end to end encrypted however user lists are stored.
/exit closes the client and logs out of the server
- Postgresql with database
- Python 3.4.3 or above
- Virtualenv
Setup tested on Fedora 23 in Gnome terminal, Python 3.4.3 and virtualenv 15.0.1
git clone [email protected]:Qinusty/Crypt-Chat.git
cd Crypt-Chat/
virtualenv -p python3.4 env
activate the virtual environment
- bash uses
. env/bin/activate - fish uses
. env/bin/activate.fish
Double check python version with python -V
If you are still on python 2.7.x, run future python commands with python3.4 instead of python
Modify config.json and add server details.
pip install -r client-requirements.txt
python Client.py
Install requirements with
pip install -r server-requirements.txt
Run commands and authenticate when required. You may need to configure postgres to use md5 authentication. Take a look here pg_hba
psql -U <user> -c 'CREATE DATABASE <dbname>'
psql -U <user> <dbname> < DDL/schema.sql
Configure server and database connection settings via server_config.json
python Server.py
I cannot guarantee completely secure communications due the self taught nature of my education on encryption. However the end to end encryption uses 4096 bit RSA keys and uses the PKCS1_OAEP standard for RSA encryption and passwords are locally hashed using SHA512 and transmitted with end to end encryption before being stored on the server's database as the unencrypted hash.