ChaTerminal 0.1.0__py3-none-any.whl

ChaTerminal/__init__.py

@@ -0,0 +1 @@
+

ChaTerminal/__main__.py

@@ -0,0 +1,4 @@
+from ChaTerminal.cli import main
+
+if __name__ == "__main__":
+    main()

ChaTerminal/cli.py

@@ -0,0 +1,15 @@
+from cha_terminal import server, client
+import sys
+
+def main():
+    if len(sys.argv) < 3 or sys.argv[1] != "init":
+        print("Usage: ChaTerminal init [server|client]")
+        sys.exit(1)
+
+    mode = sys.argv[2]
+    if mode == "server":
+        server.main()
+    elif mode == "client":
+        client.main()
+    else:
+        print("Usage: ChaTerminal init [server|client]")

cha_terminal/__init__.py

@@ -0,0 +1 @@
+

cha_terminal/client.py

@@ -0,0 +1,101 @@
+import socket
+import threading
+import hashlib
+import readline
+import platform
+import time
+import sys
+from .crypto_utils import encrypt_msg, decrypt_msg
+from .splash import splash
+from colorama import init, Fore, Style
+
+COMMANDS = ["/dm", "/kick", "/list", "/me", "/rename", "/help"]
+client = None
+
+def completer(text, state):
+    options = [cmd for cmd in COMMANDS if cmd.startswith(text)]
+    return options[state] if state < len(options) else None
+
+def get_user_color(name):
+    hash_val = int(hashlib.sha256(name.encode()).hexdigest(), 16)
+    colors = [Fore.CYAN, Fore.GREEN, Fore.MAGENTA, Fore.YELLOW, Fore.BLUE, Fore.WHITE]
+    return colors[hash_val % len(colors)]
+
+def sound_alert():
+    try:
+        if platform.system() == "Windows":
+            import winsound
+            winsound.Beep(800, 150)
+        else:
+            import os
+            os.system('printf "\\a"')
+    except:
+        pass
+
+def receive():
+    while True:
+        try:
+            msg = client.recv(2048)
+            if not msg:
+                print("\n[!] Server disconnected.")
+                break
+            text = decrypt_msg(msg)
+            if "[DM from" in text or "kicked" in text:
+                sound_alert()
+
+            if "[DM" in text:
+                print(f"\r{Fore.MAGENTA}{text}{Style.RESET_ALL}\n> ", end="")
+            elif "[+]" in text:
+                print(f"\r{Fore.GREEN}{text}{Style.RESET_ALL}\n> ", end="")
+            elif "[-]" in text:
+                print(f"\r{Fore.YELLOW}{text}{Style.RESET_ALL}\n> ", end="")
+            elif "[!]" in text:
+                print(f"\r{Fore.RED}{text}{Style.RESET_ALL}\n> ", end="")
+            elif "* " in text:
+                print(f"\r{Fore.BLUE}{text}{Style.RESET_ALL}\n> ", end="")
+            elif ": " in text:
+                timestamp, rest = text.split("] ", 1)
+                timestamp += "]"
+                name, msg = rest.split(": ", 1)
+                color = get_user_color(name.strip())
+                print(f"\r{timestamp} {color}{name}{Style.RESET_ALL}: {msg}\n> ", end="")
+            else:
+                print(f"\r{text}\n> ", end="")
+        except Exception as e:
+            print(f"\n[!] Connection lost: {e}")
+            break
+
+    try:
+        client.close()
+    except:
+        pass
+
+def send():
+    while True:
+        try:
+            msg = input("> ")
+            client.sendall(encrypt_msg(msg))
+        except:
+            break
+
+def main():
+    global client
+    splash()
+    init(autoreset=True)
+    readline.set_completer(completer)
+    readline.parse_and_bind("tab: complete")
+
+    SERVER = input("Server IP: ")
+    PORT = int(input("Server Port: "))
+    username = input("Username: ")
+
+    client = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    try:
+        client.connect((SERVER, PORT))
+        client.sendall(encrypt_msg(username))
+    except Exception as e:
+        print(f"[!] Could not connect: {e}")
+        return
+
+    threading.Thread(target=receive, daemon=True).start()
+    send()

cha_terminal/crypto_utils.py

@@ -0,0 +1,7 @@
+KEY = 17  # Basic XOR key
+
+def encrypt_msg(msg):
+    return bytes([b ^ KEY for b in msg.encode('utf-8')])
+
+def decrypt_msg(data):
+    return ''.join([chr(b ^ KEY) for b in data])

cha_terminal/server.py

@@ -0,0 +1,150 @@
+import socket
+import threading
+from datetime import datetime
+from .crypto_utils import encrypt_msg, decrypt_msg
+from .splash import splash
+
+HOST = '0.0.0.0'
+PORT = None
+ADMIN_USERNAME = None
+clients = {}
+usernames = {}
+
+def broadcast(message, exclude_socket=None):
+    for client in list(clients):
+        if client != exclude_socket:
+            try:
+                client.sendall(encrypt_msg(message))
+            except:
+                remove_client(client)
+
+def remove_client(sock):
+    try:
+        if sock in clients:
+            username = clients[sock]
+            del usernames[username]
+            del clients[sock]
+            sock.close()
+            broadcast(f"[-] {username} has left the chat.")
+    except Exception as e:
+        print(f"[ERROR: remove_client] {e}")
+
+def handle_client(client):
+    try:
+        username = decrypt_msg(client.recv(1024))
+        if username in usernames:
+            client.sendall(encrypt_msg("[!] Username already taken."))
+            client.close()
+            return
+
+        clients[client] = username
+        usernames[username] = client
+        broadcast(f"[+] {username} joined the chat.")
+
+        while True:
+            raw = client.recv(2048)
+            if not raw:
+                break
+            msg = decrypt_msg(raw)
+            timestamp = datetime.now().strftime("[%H:%M]")
+
+            if msg.startswith("/dm "):
+                _, to_user, *message = msg.split()
+                message = " ".join(message)
+                if to_user in usernames:
+                    target_socket = usernames[to_user]
+                    target_socket.sendall(encrypt_msg(f"{timestamp} [DM from {username}] {message}"))
+                    client.sendall(encrypt_msg(f"{timestamp} [DM to {to_user}] {message}"))
+                else:
+                    client.sendall(encrypt_msg("[!] User not found."))
+
+            elif msg.startswith("/kick ") and username == ADMIN_USERNAME:
+                _, to_kick = msg.split()
+                if to_kick in usernames:
+                    kick_socket = usernames[to_kick]
+                    kick_socket.sendall(encrypt_msg("[!] You have been kicked by admin."))
+                    remove_client(kick_socket)
+                    broadcast(f"[!] {to_kick} was kicked by admin.")
+                else:
+                    client.sendall(encrypt_msg("[!] User not found."))
+
+            elif msg.startswith("/list"):
+                active_users = ", ".join(usernames.keys())
+                client.sendall(encrypt_msg(f"[Users Online] {active_users}"))
+
+            elif msg.startswith("/rename "):
+                newname = msg.split()[1]
+                if newname in usernames:
+                    client.sendall(encrypt_msg("[!] Username already taken."))
+                else:
+                    broadcast(f"[!] {username} changed name to {newname}")
+                    del usernames[username]
+                    usernames[newname] = client
+                    clients[client] = newname
+                    username = newname
+
+            elif msg.startswith("/help"):
+                help_text = (
+                    "\033[1;36m[ChaTerminal Help Menu]\033[0m\n"
+                    "\033[1;33m/dm <user> <msg>\033[0m   - Send a private message\n"
+                    "\033[1;33m/kick <user>\033[0m       - Kick a user (admin only)\n"
+                    "\033[1;33m/list\033[0m              - List online users\n"
+                    "\033[1;33m/rename <newname>\033[0m  - Change your username\n"
+                    "\033[1;33m/me <action>\033[0m       - Perform an action\n"
+                    "\033[1;33m/help\033[0m              - Show this help menu\n"
+                )
+                client.sendall(encrypt_msg(help_text))
+
+            else:
+                broadcast(f"{timestamp} {username}: {msg}", exclude_socket=client)
+
+    except Exception as e:
+        print(f"[ERROR: handle_client] {e}")
+    finally:
+        remove_client(client)
+
+def get_local_ip():
+    try:
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.connect(("8.8.8.8", 80))
+        ip = s.getsockname()[0]
+        s.close()
+        return ip
+    except:
+        return "Unavailable"
+
+def print_colored_box(lines, border_color="\033[96m", text_color="\033[97m"):
+    reset = "\033[0m"
+    width = max(len(line) for line in lines) + 4
+    print(f"{border_color}┌{'─' * width}┐{reset}")
+    for line in lines:
+        print(f"{border_color}│{reset} {text_color}{line.ljust(width - 2)}{reset} {border_color}│{reset}")
+    print(f"{border_color}└{'─' * width}┘{reset}")
+
+def main():
+    global PORT, ADMIN_USERNAME
+    splash()
+    PORT = int(input("Port: "))
+    ADMIN_USERNAME = input("Admin Username: ")
+
+    server = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    server.bind((HOST, PORT))
+    server.listen()
+
+    local_ip = get_local_ip()
+    info_lines = [
+        f"ChaTerminal running on local IP: {local_ip}:{PORT}",
+        "Other users on the same Wi-Fi/LAN can connect using this IP.",
+        "",
+        "To allow others to connect over the internet:",
+        f" - Use Ngrok:      ngrok tcp {PORT}",
+        f" - Or LocalXpose:  ./lx tcp {PORT}",
+        f" - Or port forward your router to {local_ip}",
+        "",
+        "Then share the public IP/URL and port with clients."
+    ]
+    print_colored_box(info_lines)
+
+    while True:
+        client_socket, addr = server.accept()
+        threading.Thread(target=handle_client, args=(client_socket,), daemon=True).start()

cha_terminal/splash.py

@@ -0,0 +1,23 @@
+import pyfiglet
+import time
+import sys
+
+def typewriter(text, delay=0.005, beep=False):
+    for char in text:
+        sys.stdout.write(char)
+        sys.stdout.flush()
+        if beep and char not in [' ', '\n']:
+            sys.stdout.write('\a')  # ASCII bell
+            sys.stdout.flush()
+        time.sleep(delay)
+    print()
+
+def splash():
+    banner = pyfiglet.figlet_format("ChaTerminal", font="slant")
+    print("\033[1;32m", end="")  # Green
+    typewriter(banner, delay=0.002, beep=True)
+
+    print("\033[1;34m", end="")  # Blue
+    typewriter("[ secure terminal chat • \033[1;35mChaTerminal\033[1;34m ]", delay=0.01, beep=True)
+
+    print("\033[0m")  # Reset color

chaterminal-0.1.0.dist-info/METADATA

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: ChaTerminal
+Version: 0.1.0
+Summary: A terminal-based encrypted chat system for LAN and remote connections
+Home-page: https://github.com/Gofaone315/ChaTerminal
+Author: Gofaone Tlalang
+Author-email: gofaonetlalang@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# ChaTerminal
+
+**ChaTerminal** is a cross-platform terminal-based encrypted chat system built with Python. It supports multiple users on a local network or via tunneling tools like Ngrok or LocalXpose, providing a lightweight and interactive chat experience — right from the terminal.
+
+![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)
+![License](https://img.shields.io/github/license/Gofaone315/ChaTerminal)
+![Platform](https://img.shields.io/badge/Platform-Terminal-informational)
+
+## Features
+
+- **Encrypted communication** using custom crypto utilities
+- **Multi-user chat** over LAN or tunneled internet
+- **Color-coded messages** with timestamp formatting
+- **Auto-complete** for commands via `readline` and TAB
+- **Direct messaging** using `/dm <user> <message>`
+- **Username renaming** with `/rename <new_name>`
+- **List online users** using `/list`
+- **Admin controls**: `/kick <user>` (admin-only)
+- **Emote support**: `/me <action>`
+- **Help menu**: `/help` displays command reference
+- **User join/leave notifications**
+- **Sound alert** for DMs and admin actions
+- **Graceful client disconnect and server feedback**
+- **Color personalization** based on username hash
+
+## Getting Started
+
+### Requirements
+
+- Python 3.9+
+- pip packages: `colorama`, `pyfiglet`, `readline` (Linux/macOS), `pyreadline3` (Windows)
+
+### Installation
+
+```bash
+pip install ChaTerminal
+```
+
+### Running the Server
+
+```bash
+ChaTerminal init server
+```
+
+- Enter a port (e.g., `5555`) and the admin username
+- Displays local IP with instructions for LAN or tunneled access
+
+### Running the Client
+
+In a **new terminal window**:
+
+```bash
+ChaTerminal init client
+```
+
+- Enter the server IP, port, and a unique username
+
+## Commands
+
+| Command             | Description                              |
+|---------------------|------------------------------------------|
+| `/dm <user> <msg>`  | Send a private message                   |
+| `/kick <user>`      | Kick a user (admin only)                 |
+| `/list`             | View online users                        |
+| `/rename <name>`    | Change your username                     |
+| `/me <action>`      | Send an action/emote (e.g., waves)       |
+| `/help`             | Show all available commands              |
+
+## Networking Tips
+
+To let others join:
+
+- **Local network**: Share the IP and port printed on server start
+- **Ngrok**: `ngrok tcp <port>`
+- **LocalXpose**: `./lx tcp <port>`
+- **Port Forwarding**: Map the server's port on your router
+
+## Example
+
+```bash
+# Start server
+$ ChaTerminal init server
+Port: 5555
+Admin Username: admin
+
+# Start client
+$ ChaTerminal init client
+Server IP: 192.168.1.100
+Server Port: 5555
+Username: myname
+```
+
+## Security Note
+
+All messages are encrypted using the `crypto_utils` module before transmission. Ensure that this module uses secure encryption practices for production deployments.
+
+## License
+
+This project is licensed under the MIT License. See `LICENSE` for more info.
+
+## Author
+
+**Gofaone Tlalang**  
+GitHub: [@Gofaone315](https://github.com/Gofaone315)
+
+---
+
+**ChaTerminal** – Real-time encrypted chat, right from your terminal.

chaterminal-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+ChaTerminal/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+ChaTerminal/__main__.py,sha256=XZQEiEg1VXxCIEX_EL-FGLLl-k4qXjYxhD06UoRRsP0,72
+ChaTerminal/cli.py,sha256=-VloPrDGkSjNYfV6aEB9FI3hTkmtQScUUwyjTbSJnL0,379
+cha_terminal/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+cha_terminal/client.py,sha256=ZMvT2GMRqIC23pHGFpVzwOCG3ZWeY8EYdU_iRwL1Ioc,3002
+cha_terminal/crypto_utils.py,sha256=bO4g6aJx-yY3RiwIJgEY59x2_GjadwRPvMk62gzkkho,179
+cha_terminal/server.py,sha256=pEKDQs9-nAx_Q2o_qau9ojX_nobWXwGerpr_WavUIG8,5521
+cha_terminal/splash.py,sha256=mU1_EiOnX68blw9CF4U9RXThQZzNgOs6JFRx_8_Z324,678
+chaterminal-0.1.0.dist-info/licenses/LICENSE,sha256=GvmOpkMWXCP9-bywb4DwoRxMT_zOWu5cuYilKfdf2vU,1072
+chaterminal-0.1.0.dist-info/METADATA,sha256=tOIohPt-oG1ITlGXQgBhqsn6Yb_VPLiDE2kCNLJi3go,3992
+chaterminal-0.1.0.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+chaterminal-0.1.0.dist-info/entry_points.txt,sha256=IpdZdr_Me6Gp4uKTnAwdQgvLrfSiK4Fbmlz2UYSU9as,46
+chaterminal-0.1.0.dist-info/top_level.txt,sha256=NHGCl4mRpbXM55jGfq8zvR6xKi1EDjB57lgmitVOrqw,25
+chaterminal-0.1.0.dist-info/RECORD,,

chaterminal-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.8.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

chaterminal-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+chat = ChaTerminal.cli:main

chaterminal-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Gofaone Tlalang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

chaterminal-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+ChaTerminal
+cha_terminal