https://github.com/aniko33/charles-csec
CSEC is a client-based encrypted chat. allows you to avoid network sniffing or an attack done directly from the server. it is easy to use and modify and is available on Linux, Windows, Mac.
https://github.com/aniko33/charles-csec
aniko charles-csec chatroom cryptography csec cyber decks decks-team encrypted-chat hacking mr-robot python python-chat python-socket rich rsa rsa-python rsa-socket server-chat socket
Last synced: about 2 months ago
JSON representation
CSEC is a client-based encrypted chat. allows you to avoid network sniffing or an attack done directly from the server. it is easy to use and modify and is available on Linux, Windows, Mac.
- Host: GitHub
- URL: https://github.com/aniko33/charles-csec
- Owner: aniko33
- License: gpl-3.0
- Archived: true
- Created: 2022-12-16T20:16:02.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-01-26T18:48:19.000Z (over 2 years ago)
- Last Synced: 2025-03-01T20:47:23.690Z (3 months ago)
- Topics: aniko, charles-csec, chatroom, cryptography, csec, cyber, decks, decks-team, encrypted-chat, hacking, mr-robot, python, python-chat, python-socket, rich, rsa, rsa-python, rsa-socket, server-chat, socket
- Language: Python
- Homepage: https://csec-project-github.web.app/
- Size: 146 KB
- Stars: 13
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
Charles CSEC
[](https://github.com/aniko33/Charles-CSEC/releases)
[](#)
[](#)
# Index
- [Features](#features)
- [Installation](#installation)
- [Configuration (server-side)](#configuration)
- [Commands (client-side)](#commands)
- [Running](#running)
- [How does it work](#how-does-it-work)
- [Showcase](#showcase)
- [Bug report](#bug-report)
- [License](#license)
- [Contributors](#contributors)
# Features
- RSA encryption
- Easy to read code
- Protected by network sniffer
- File upload with Anonfile
- No trace of your IP
# Installation
### From source code
You need to have **[Python](https://www.python.org/downloads/)** and **[PIP](https://www.w3schools.com/python/python_pip.asp)** installed which you can download from your [**package manager**](https://www.geeksforgeeks.org/how-to-install-python-on-linux/) or site.
After installing Python and PIP you need to install ***program dependencies***.
You can with this command:
```bash
git clone https://github.com/aniko33/Charles-CSEC && cd Charles-CSEC
```
Then, you will need to install python dependencies:
```bash
pip install -r requirements.txt
```
After you ***installed the various dependencies***, now you **can customise your configurations your server or start your client**.
### From the compiled version
You have to **go to the [latest releases](https://github.com/aniko33/Charles-CSEC/releases)** and you have to ***download the client or the server depending*** on what you want to do.
#### Important note
If you have installed the **server version**, **create a file named *config.json*** and set the [default configurations](https://github.com/aniko33/Charles-CSEC/blob/main/server/config.json).
# Configuration
To configure your server, **open the *config.json* file in the following path: *server/config.json***.
Scroll to the top and edit this part:
```json
{
"ip": "127.0.0.1",
"port": 8889,
"buffer": 1024,
"welcome_message": "[red]welcome to [/red]",
"protected_by_password": false,
"password": "P4ssw0rd"
}
```
| Variable | Description |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| ip | The IP address where the server will start listening for connections |
| port | The **connection port**, it is recommended to ***keep it default*** (***8889***) |
| buffer | The maximum network buffer, changes in this value affects the ***RSA key lenght*** |
| welcome_message | Welcome message to new users, the colors can be found in the **[Rich documentation](https://rich.readthedocs.io/en/stable/appendix/colors.html)** |
| protected_by_password | You can enter true if you want to **protect your chat by password** or you can put false |
| password | Enter the password you want |
# Commands
- `/help` show command list
- `/nick` get your nickname
- `/upload ` upload file with **Anonfile**, usage: `/upload /home/user/file.txt`
# Running
To run the program just ***go to the main folder*** and execute this command:
#### Client
```bash
cd client && python main.py
```
#### Server
```bash
cd server && python main.py
```
# How does it work
The **keys are generated using the [RSA Encryption Algorithm](https://www.geeksforgeeks.org/rsa-algorithm-cryptography/)**.
when the client wants to send a message, **it gets encrypted with the _public key_**, through the ***server then will forward it to the connected clients***, that **will decrypt it using the _private key_**.
For more detailed explanation, please, refer to the [RSA Encryption Algorithm Documentation](https://www.geeksforgeeks.org/rsa-algorithm-cryptography/)
# Showcase
# Bug report
**To report an exploit or a bug write**, create a [new issue](https://github.com/aniko33/Charles-CSEC/issues)
# License
This application is distributed under the ***[GPL](https://it.wikipedia.org/wiki/GNU_General_Public_License) license*** you can ***consult the file***: ***[LICENSE.txt](LICENSE.txt)***
# Contributors
