{"id":27245611,"url":"https://github.com/thatsinewave/whisper-chat","last_synced_at":"2026-02-14T08:01:24.867Z","repository":{"id":283911237,"uuid":"946936313","full_name":"ThatSINEWAVE/Whisper-Chat","owner":"ThatSINEWAVE","description":"Lightweight chat server with a web-based monitoring dashboard. This project is in very early development and is not yet ready for production use.","archived":false,"fork":false,"pushed_at":"2025-03-23T00:23:05.000Z","size":208,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-10T21:35:15.873Z","etag":null,"topics":["chat","chat-app","chat-application","chat-application-in-python","chatapp","chatroom","chatting","chatting-app","good-first-contribution","good-first-issue","good-first-issues","good-first-pr","good-first-pr-first-contribution","good-first-prs","open-source","opensource","python-chat","python-chat-application","python3","thatsinewave"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ThatSINEWAVE.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"ThatSINEWAVE","ko_fi":"thatsinewave"}},"created_at":"2025-03-11T22:56:42.000Z","updated_at":"2025-03-23T00:23:09.000Z","dependencies_parsed_at":"2025-03-23T01:21:44.727Z","dependency_job_id":"e5d4ed39-97d0-47c7-b0e2-23b8f619f466","html_url":"https://github.com/ThatSINEWAVE/Whisper-Chat","commit_stats":null,"previous_names":["thatsinewave/whisper-chat"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ThatSINEWAVE/Whisper-Chat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatSINEWAVE%2FWhisper-Chat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatSINEWAVE%2FWhisper-Chat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatSINEWAVE%2FWhisper-Chat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatSINEWAVE%2FWhisper-Chat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ThatSINEWAVE","download_url":"https://codeload.github.com/ThatSINEWAVE/Whisper-Chat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatSINEWAVE%2FWhisper-Chat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29439820,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T07:24:13.446Z","status":"ssl_error","status_checked_at":"2026-02-14T07:23:58.969Z","response_time":53,"last_error":"SSL_read: 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":["chat","chat-app","chat-application","chat-application-in-python","chatapp","chatroom","chatting","chatting-app","good-first-contribution","good-first-issue","good-first-issues","good-first-pr","good-first-pr-first-contribution","good-first-prs","open-source","opensource","python-chat","python-chat-application","python3","thatsinewave"],"created_at":"2025-04-10T21:28:35.352Z","updated_at":"2026-02-14T08:01:24.851Z","avatar_url":"https://github.com/ThatSINEWAVE.png","language":"Python","funding_links":["https://github.com/sponsors/ThatSINEWAVE","https://ko-fi.com/thatsinewave"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Whisper Chat\n\n![Banner](https://raw.githubusercontent.com/ThatSINEWAVE/Whisper-Chat/refs/heads/main/.github/SCREENSHOTS/Whisper-Chat.png)\n\nWhisper Chat is a lightweight chat server with a web-based monitoring dashboard. This project is in **very early development** and is not yet ready for production use.\n\n\u003c/div\u003e\n\n## Current Features\n\n- Basic real-time chat functionality\n- Web dashboard for monitoring connections and activity\n- Simple client/server architecture using TCP sockets\n- JSON-based message protocol\n- Auto-logging of all chat activity\n- Command-line client interface\n\n\u003cdiv align=\"center\"\u003e\n\n## ☕ [Support my work on Ko-Fi](https://ko-fi.com/thatsinewave)\n\n\u003c/div\u003e\n\n## Project Structure\n\n```\nwhisper-chat/\n├── whisper_chat.py                 # Main server application (chat server + dashboard)\n├── client.py                       # Command-line client implementation\n├── templates/                      # Contains HTML templates for the dashboard\n│   └── dashboard.html              # Dashboard template\n├── static/                         # Stores static assets like CSS and JavaScript\n│   ├── styles.css                  # Dashboard styling\n│   └── dashboard.js                # Dashboard interactivity\n├── site-data/                      # Metadata and icons for web browsers\n│   ├── android-chrome-192x192.png  # Android Chrome icon (192x192)\n│   ├── android-chrome-512x512.png  # Android Chrome icon (512x512)\n│   ├── apple-touch-icon.png        # Apple touch icon for iOS devices\n│   ├── favicon.ico                 # Standard favicon\n│   ├── favicon-16x16.png           # Small favicon (16x16)\n│   ├── favicon-32x32.png           # Standard favicon (32x32)\n│   ├── icon-144x144.png            # Windows tile icon (144x144)\n│   └── site.webmanifest            # Web app manifest file\n└── logs/                           # Automatically generated chat logs\n```\n\n## Getting Started\n\n### Requirements\n\n- Python 3.6+\n- Flask (server only)\n\n### Installation\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/yourusername/whisper-chat.git\n   cd whisper-chat\n   ```\n\n2. Install dependencies for the server:\n   ```\n   pip install flask\n   ```\n\n### Running the Server\n\n```\npython whisper_chat.py\n```\n\nThis will:\n- Start the chat server on port 9999\n- Launch the admin dashboard on port 8080\n- Open your web browser to the dashboard\n\n### Connecting as a Client\n\nThe client is a simple command-line application that connects to the Whisper Chat server:\n\n```\npython client.py\n```\n\nWhen you run the client:\n1. Enter your username when prompted\n2. Chat messages will appear in the terminal\n3. Type your messages and press Enter to send\n4. Type 'exit' to disconnect from the server\n\nExample usage:\n```\n$ python client.py\nEnter your username: Alice\nConnecting to chat server...\nConnected as Alice. Type 'exit' to quit.\n[SYSTEM] Alice has joined the chat\nBob: Hello Alice!\nHello Bob!\n[SYSTEM] Charlie has joined the chat\nexit\nDisconnecting...\n```\n\n## Client Protocol\n\nThe client and server communicate using a simple JSON-based protocol:\n\n### Connect message\n\n```json\n{\n    \"type\": \"connect\",\n    \"username\": \"username\"\n}\n```\n\n### Chat message\n\n```json\n{\n    \"type\": \"message\",\n    \"username\": \"username\",\n    \"content\": \"message text\"\n}\n```\n\n### Disconnect message\n\n```json\n{\n    \"type\": \"disconnect\",\n    \"username\": \"username\"\n}\n```\n\n### System message (server to client)\n\n```json\n{\n    \"type\": \"system\",\n    \"content\": \"system message text\"\n}\n```\n\n\u003cdiv align=\"center\"\u003e\n\n## [Join my discord server](https://discord.gg/2nHHHBWNDw)\n\n\u003c/div\u003e\n\n## Roadmap\n\nFuture development plans include:\n- End-to-end encryption\n- User authentication\n- Private messaging\n- Chat rooms/channels\n- File sharing\n- Mobile client applications\n- GUI client application\n\n## Contributing\n\nAs this project is in early development, please reach out before submitting pull requests. All contributions are welcome!\n\n## License\n\nThis project is open-source and available under the [GPL-3.0 License](LICENSE)\n\n## Disclaimer\n\nThis software is provided \"as is\" without warranty of any kind. Use at your own risk.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthatsinewave%2Fwhisper-chat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthatsinewave%2Fwhisper-chat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthatsinewave%2Fwhisper-chat/lists"}