Skip to content

Commit e27504b

Browse files
docs: README
1 parent 4fe0d43 commit e27504b

1 file changed

Lines changed: 49 additions & 0 deletions

File tree

README.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# CLI Chat
2+
3+
CLI Chat is a multithreaded chat server that allows multiple clients to connect simultaneously and exchange messages in real-time.
4+
<p align="center">
5+
6+
<img src="https://github.com/user-attachments/assets/7dec9a3f-6a74-49be-badd-079968168bd9" alt="cargo-banner" width="700">
7+
8+
</p>
9+
10+
## Features
11+
12+
- A group chat simulation of clients connected on the same network.
13+
- Supports multiple clients.
14+
- Private messaging
15+
16+
## Available commands
17+
18+
1. Whisper - Private message other connected clients.
19+
- Example usage: ```/whisper 29 Hello James``` 29 is the uid of the user you want to message privately.
20+
21+
22+
## Installation steps
23+
24+
1. - Fork the [repo](https://github.com/codedmachine111/cli-chat)
25+
- Clone the repo to your local machine `git clone https://github.com/codedmachine111/cli-chat.git`
26+
- Change current directory `cd cli-chat`
27+
28+
2. Compile the source code:
29+
```bash
30+
make all
31+
```
32+
33+
4. How to run
34+
- Run the server code on a machine.
35+
```bash
36+
./server
37+
```
38+
39+
- Run the client code on any other machine or the same machine (different terminal tab/window).
40+
```bash
41+
./client
42+
```
43+
44+
> ### **Note**
45+
> If you are running the server and client of different machines, modify the `SERVER_IP_ADDRESS` macro in both client and server files to the public IP-address of the machine running the server code. (ifconfig it)
46+
47+
## Contribution
48+
49+
Contributions are welcome! If you have any suggestions, improvements, or bug fixes, please submit a pull request or open an issue on the GitHub repository.

0 commit comments

Comments
 (0)