Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/timothy-liuxf/tmchat

A chat tool with a communication component using TCP/IPv4.
https://github.com/timothy-liuxf/tmchat

cpp linux network networking socket tcp tcp-ip tmsocket windows

Last synced: 7 days ago
JSON representation

A chat tool with a communication component using TCP/IPv4.

Host: GitHub
URL: https://github.com/timothy-liuxf/tmchat
Owner: Timothy-Liuxf
License: mit
Created: 2021-12-04T01:47:39.000Z (about 3 years ago)
Default Branch: master
Last Pushed: 2023-12-12T00:23:14.000Z (about 1 year ago)
Last Synced: 2023-12-12T01:29:46.456Z (about 1 year ago)
Topics: cpp, linux, network, networking, socket, tcp, tcp-ip, tmsocket, windows
Language: C++
Homepage: https://timothy-liuxf.github.io/TMChat/
Size: 140 KB
Stars: 6
Watchers: 1
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md

Awesome Lists containing this project

README

# TMChat

**Start chatting with TMChat now!**

TMChat, a small chat tool with a self-written TCP/IPv4 communication library, TMSocket.

## Supported Compiler

## Structure

+ tmsocket: A communication library using TCP/IPv4 which provides message pack oriented communication.
+ server: The server of TMChat.
+ client: The client of TMChat.

## How to build

### Linux

```sh
# Requires GNU Autotools and GNU Make

$ autoreconf -i
$ ./configure
$ make -j$(nproc)
```

And the target `build/lib/libtmsocket.a`, `build/bin/tmchat_server` and `build/bin/tmchat_client` will be built.

Then install it:

```shell
sudo make install
```

After installation, you can use the third party library `libtmsocket.a`:

```c++
#include
#include
```

with link option `-ltmsocket` and use the chat tool:

```shell
$ tmchat_server
$ tmchat_client
```

### Windows

#### Use Visual Studio

Open `TMChat.sln` with Visual Studio 2022 or later versions, choose a target platfrom (Release | x64 recommended) and then build the solution.

Then the target `server.exe` and `client.exe` will be built.

#### Use MSBuild

You can also use MSBuild to build the targets. If so, you should have MSBuild in your path. You can add it to your path manually or use "Developer command Prompt for Visual Studio".

You can run `Build.cmd` to build and run `Clean.cmd` to clean, or run the following command in cmd:

```cmd
> MSBuild ".\TMChat.sln" [options]
```

The options can be:

+ `-t:`: Specify the task. The `value` can be:
+ `Build`: Incremental compile. This is the recommended value.
+ `Recompile`: Recompile. This will delete all files built in the last compilation and rebuild the targets.
+ `Clean`: Delete all files in the last compilation.
+ `-p:=;=;...`. The `property` can be:
+ `Configuration`: The value can be `Debug` or `Release`
+ `Target`: The value can be `x86` or `x64`
+ `-m:`: The `value` specifies the maximum number of concurrent processes to use when building. The default value is `1`

Example:

```cmd
> MSBuild ".\TMChat.sln" "-t:Build" "-p:Configuration=Release;Platform=x64" "-m:8"
```

Then the target `server.exe` and `client.exe` will be built in the directory below:

| | Debug | Release |
| :--: | :-------------: | :---------------: |
| x86 | `src\Debug` | `src\Release` |
| x64 | `src\x64\Debug` | `src\x64\Release` |

### macOS