Skip to main content

A Textual-based terminal chat client offering real-time messaging, file sharing, typing indicators, and emoji support.

Project description

LynqX

LynqX is a terminal-based peer-to-peer chat client built using Textual. 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) 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.

📄 License

MIT — see the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lynqx-1.0.1.tar.gz (8.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lynqx-1.0.1-py3-none-any.whl (8.9 kB view details)

Uploaded Python 3

File details

Details for the file lynqx-1.0.1.tar.gz.

File metadata

  • Download URL: lynqx-1.0.1.tar.gz
  • Upload date:
  • Size: 8.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for lynqx-1.0.1.tar.gz
Algorithm Hash digest
SHA256 7763b432f9678f4758584d67185bbfb710da20f11ab1d22894a997984cf7a720
MD5 1f3743d17dcfb8d106515adca664dd78
BLAKE2b-256 8d041ea25552a36e026a20ff125d964841be30884cfe5ff2d0841e79e49dc73e

See more details on using hashes here.

File details

Details for the file lynqx-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: lynqx-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 8.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for lynqx-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ef7b16f7173ba527e2a69894a285302de9dea1682887e3436d02f88eec73a99f
MD5 e4f63681ad84498b3d6b2c9f7ecf1f83
BLAKE2b-256 cbc5a57daff4731c954541626ec7ceb9f2029df7010976fd89fcf3b0f070558d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page