A lightweight, console-based messenger built with Python using the UDP protocol. It allows real-time communication between a client and a server directly through the terminal.
- Bidirectional Communication: Full-duplex messaging (both sending and receiving).
- UDP Protocol: Data transfer using port
5005. - Customizable Identity: Change your display name on the fly within the app.
- Port Management: Dedicated option to open/bind a port for incoming connections.
- Zero Dependencies: Runs on vanilla Python using standard libraries (
socket,threading).
If you have a "Gray" (Private/CGNAT) IP address, direct connection over the internet will not work. In this case, you must use Radmin VPN, Hamachi, or a similar tool to create a virtual local network with your friend before connecting.
- Language: Python 3.11
- Networking:
socketlibrary - Concurrency:
threading(for simultaneous listen/send)
-
Clone the repository:
git clone https://github.com/qualzed/qChat cd qChat -
Run the application:
python main.py
- Connect: Enter the target IP address to start chatting.
- Change Name: Set a custom nickname for the session.
- Send Message: Type your text and hit Enter.
- Open Port: Activate the listener on port
5005to wait for incoming messages.
