https://github.com/mehran1383/chat_application
A simple desktop messenger developed with Qt & C++
https://github.com/mehran1383/chat_application
cplusplus qt5
Last synced: about 1 year ago
JSON representation
A simple desktop messenger developed with Qt & C++
- Host: GitHub
- URL: https://github.com/mehran1383/chat_application
- Owner: Mehran1383
- Created: 2024-03-19T23:01:00.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-12T09:25:09.000Z (over 1 year ago)
- Last Synced: 2025-03-12T10:30:34.501Z (over 1 year ago)
- Topics: cplusplus, qt5
- Language: C++
- Homepage:
- Size: 3.66 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Desktop chat application
> Prepared for Advanced programming course in Isfahan university of technology
## Details of client/server implementation
### Communication with Server
The application uses provided APIs to send requests to the server and receive appropriate responses to be used in the messenger.
### API Structure
```
http://hostname:port/command?parameters
```
- **hostname**: Address of the server where the server code is running.
- **port**: Port for communication with the server.
- **command**: Commands requested from the server.
- **parameters**: Optional key-value pairs sent to the server with the request.
### Example Request
Registering a user with the username `Mehran` and password `1383`:
```
http://api.barafardayebehtar.ml:8080/signup?username=Mehran&password=1383
```
Responses are in JSON format, with `code` and `message` fields indicating the status and response message from the server.
### Response Codes
- **200**: Request successful.
- **404**: Request unsuccessful, information not found.
- **204**: Request unsuccessful, duplicate information.
- **401**: Request unsuccessful, incorrect information.
### Server Details
- **hostname**: `api.barafardayebehtar.ml`
- **port**: `8080`
### Request Format
```
http://api.barafardayebehtar.ml:8080/command?parameters
```
### Main Messenger Scenario
1. **Sign Up**: Register as a user.
2. **Login**: Obtain a unique token representing user identity.
3. **All Requests**: Sent with the unique token for user identification.
4. **Logout**: Token is set to `null` and a new token is assigned upon next login.
### Available APIs
| Command | Parameters | Description |
|--------------------|---------------------------------------------|--------------------------------------------------------------------------|
| signup | username, password, firstname, lastname | Register a new user. |
| login | username, password | Log in a user and receive a unique token. |
| logout | username, password | Log out a user and nullify their token. |
| creategroup | token, group_name, group_title | Create a new group. |
| createchannel | token, channel_name, channel_title | Create a new channel. |
| getuserlist | token | Get the list of users the current user has chatted with. |
| getgrouplist | token | Get the list of groups the current user is a member of. |
| getchannellist | token | Get the list of channels the current user is a member of. |
| getuserchats | token, dst, date | Get the list of messages with a specific user. |
| getgroupchats | token, dst, date | Get the list of messages in a specific group. |
| getchannelchats | token, dst, date | Get the list of messages in a specific channel. |
| joingroup | token, group_name | Join a specific group. |
| joinchannel | token, channel_name | Join a specific channel. |
| sendmessageuser | token, dst, body | Send a message to a specific user. |
| sendmessagegroup | token, dst, body | Send a message in a specific group. |
| sendmessagechannel | token, dst, body | Send a message in a specific channel. |
### Offline Message Access
The application stores all requested messages in categorized files to access the messenger information offline.
1. Application creates folders: `Users`, `Groups`, `Channels`.
2. For each user, group, and channel, applicaton creates respective files and save messages for offline access.
## Some features of project
In addition to sending and receiving messages, this program has these features :
- A beautiful ui which makes this messenger more atractive
---
- Ability to capture or select a picture for profile
---
- Changing background theme
---
- Changing font style and size
---
## Prerequisites
- Qt 5.13 or later
- C++ 11 compatible compiler
- qmake (included with Qt)
## Building the Project
1. Clone the repository:
```sh
git clone
```
2. Open the project in Qt Creator:
- Open `nmassenger.pro` for the client application.
3. Build the project using Qt Creator.
---