Metadata-Version: 2.4
Name: LynqX
Version: 1.0.1
Summary: A Textual-based terminal chat client offering real-time messaging, file sharing, typing indicators, and emoji support.
Author-email: "MD. Shahariar Ahmmed Shovon" <shovonali885@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/SwagCoder18/LynqX
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual
Requires-Dist: httpx
Requires-Dist: requests
Requires-Dist: sseclient
Requires-Dist: emoji
Dynamic: license-file

# LynqX

**LynqX** is a terminal-based peer-to-peer chat client built using [Textual](https://textual.textualize.io/). It supports:

* Real-time messaging
* File sharing (with resume and cancel support)
* Typing indicators
* Emoji rendering
* Reconnection logic
* Custom commands

LynqX connects to a backend server (e.g., [LynqX server](https://github.com/SwagCoder18/ChatX)) for managing chat rooms and delivering messages over Server-Sent Events (SSE).

---

## 🚀 Features

* 📦 File transfers with resume capability
* 🔒 Cancel transfers anytime
* 🧠 Reconnect logic with exponential backoff
* 😃 Emoji support via `emoji` Python package
* 🧑‍💻 Typing indicators for active participants
* 📿 Textual UI for a clean terminal interface

---

## 📆 Installation

```
pip install lynqx
```

This will automatically install all required dependencies:

* `textual`
* `httpx`
* `requests`
* `sseclient`
* `emoji`

---

## 🧑‍💻 Usage

### Create a new chat room:

```
lynqx -c
```

### Join an existing room:

```
lynqx -j <room_id>
```

---

## ⚙️ Requirements

* Python 3.8+

---

## 🧠 Customization

* You can change the base server URL in `app.py` via the `BASE_URL` constant.
* For advanced use, fork or modify the [LynqX server backend](https://github.com/SwagCoder18/ChatX).

---

## 📄 License

MIT — see the [LICENSE](./LICENSE) file for details.
