{"id":27700347,"url":"https://github.com/medovanx/chatter-wave","last_synced_at":"2026-04-29T09:06:31.640Z","repository":{"id":285656377,"uuid":"958903429","full_name":"medovanx/chatter-wave","owner":"medovanx","description":"A cross-platform chat application built with PyQt5 supporting both TCP and UDP protocols for network communication.","archived":false,"fork":false,"pushed_at":"2025-05-18T16:43:12.000Z","size":2302,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-18T18:08:07.609Z","etag":null,"topics":["socket-io","tcp","udp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/medovanx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-02T00:31:40.000Z","updated_at":"2025-05-18T16:43:15.000Z","dependencies_parsed_at":"2025-06-18T18:08:08.860Z","dependency_job_id":"1b144188-6c6c-4d88-a751-cffe0e6e1404","html_url":"https://github.com/medovanx/chatter-wave","commit_stats":null,"previous_names":["medovanx/chatter_wave","medovanx/chatter-wave"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/medovanx/chatter-wave","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/medovanx%2Fchatter-wave","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/medovanx%2Fchatter-wave/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/medovanx%2Fchatter-wave/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/medovanx%2Fchatter-wave/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/medovanx","download_url":"https://codeload.github.com/medovanx/chatter-wave/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/medovanx%2Fchatter-wave/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32418203,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T06:29:02.080Z","status":"ssl_error","status_checked_at":"2026-04-29T06:29:00.631Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["socket-io","tcp","udp"],"created_at":"2025-04-25T18:59:06.112Z","updated_at":"2026-04-29T09:06:31.632Z","avatar_url":"https://github.com/medovanx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chatter Wave\n\nA cross-platform chat application built with PyQt5 supporting both TCP and UDP protocols for network communication.\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"https://i.ibb.co/Z1J7SXwK/client-icon.png\" alt=\"Logo\" width=\"200\" height=\"200\"\u003e\n    \u003cimg src=\"https://i.ibb.co/Y7K28Cb8/server-icon.png\" alt=\"Logo\" width=\"200\" height=\"200\"\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Python 3.6+](https://img.shields.io/badge/python-3.6+-blue.svg)](https://www.python.org/downloads/)\n[![PyQt5](https://img.shields.io/badge/GUI-PyQt5-green.svg)](https://pypi.org/project/PyQt5/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n\u003c/div\u003e\n\n## Features\n\n### Communication Protocols\n\n- **TCP Protocol**: Reliable, connection-oriented communication\n- **UDP Protocol**: Lightweight, connectionless communication\n- **Protocol Comparison**: In-app explanation of TCP vs UDP differences\n\n### User Interface\n\n- **Tab-Based Chat**: Public chat and private conversation tabs\n- **Unread Message Indicators**: Visual notifications for new messages\n- **Online User List**: Real-time display of connected users\n- **Message Formatting**: Color-coded messages by sender type\n\n### Network Features\n\n- **Configurable Connection**: Customizable host and port settings\n- **Username Selection**: Personalized identity in chats\n- **Error Handling**: Robust management of network issues\n- **Server Notifications**: System messages for user activity\n\n### Client-Server Architecture\n\n- **Multi-Client Support**: Handles multiple simultaneous connections\n- **Protocol Mixing**: Manages both TCP and UDP clients\n- **Message Routing**: Intelligent message delivery\n- **Heartbeat Mechanism**: Connection maintenance for UDP clients\n\n## Screenshots\n\n![Application Main Window](https://i.imgur.com/9QNOrLJ.png)\n\n![Private Chat Tab](https://i.imgur.com/z8UdvLu.png)\n\n## Installation\n\n### Prerequisites\n\n- Python 3.6+\n- PyQt5\n\n### Setup\n\n```bash\ngit clone https://github.com/medovanx/chatter_wave.git\ncd chatter_wave\npip install -r requirements.txt\n```\n\nAlternatively, you can download pre-compiled executable files from the [Releases](https://github.com/medovanx/chatter_wave/releases) page.\n\n## Usage\n\n### Starting the Server\n\n```bash\npython server.py\n```\n\nDefault ports: TCP 9090, UDP 9091\n\n### Connecting\n\n1. Launch client application: `python chat_client.py`\n2. Enter server details and username\n3. Select protocol (TCP/UDP)\n4. Click \"Connect\"\n\n### Chatting\n\n- **Public Chat**: Type in main tab\n- **Private Chat**: Double-click username to open private tab\n\n## Technical Details\n\n### Code Structure\n\n- **ChatWindow**: Main UI logic\n- **ChatTab**: Individual chat tabs\n- **ChatClient**: Network communication\n- **SignalHandler**: Qt signal management\n- **ChatServer**: TCP/UDP server implementation\n\n### Message Format\n\nJSON-formatted messages:\n\n```json\n{\n  \"type\": \"public|private|server|error|user_list\",\n  \"from\": \"username\",\n  \"to\": \"recipient_username\",\n  \"message\": \"content\",\n  \"users\": [\"user1\", \"user2\", \"...\"]\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmedovanx%2Fchatter-wave","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmedovanx%2Fchatter-wave","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmedovanx%2Fchatter-wave/lists"}