termchat-client 0.1.0__py3-none-any.whl

termchat/__init__.py

@@ -0,0 +1,10 @@
+"""
+termchat - Lightweight, non-intrusive terminal chat client.
+Connects standard terminal input to your online Render/cloud server and receives text & images.
+"""
+
+__version__ = "0.1.0"
+__author__ = "TermChat Contributors"
+__license__ = "MIT"
+
+__all__ = ["__version__"]

termchat/__main__.py

@@ -0,0 +1,8 @@
+"""
+Allows running `python -m termchat` directly.
+"""
+
+from termchat.cli import main
+
+if __name__ == "__main__":
+    main()

termchat/cli.py

@@ -0,0 +1,97 @@
+"""
+CLI interface for termchat client.
+"""
+
+import argparse
+import os
+import sys
+
+from termchat import __version__
+from termchat.client import start
+from termchat.config import (
+    get_saved_server_url,
+    get_saved_username,
+    set_saved_server_url,
+    set_saved_username,
+)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="termchat",
+        description="Non-intrusive terminal chat client connecting to your online Render/cloud server.",
+    )
+    parser.add_argument("-v", "--version", action="version", version=f"termchat {__version__}")
+    parser.add_argument(
+        "-s",
+        "--server",
+        help="Online server URL (e.g. https://my-chat.onrender.com). Overrides saved config.",
+    )
+    parser.add_argument(
+        "-n",
+        "--name",
+        help="Chat username. Overrides saved config.",
+    )
+    parser.add_argument(
+        "--set-server",
+        help="Save a default online server URL to ~/.termchat.json and exit.",
+    )
+    parser.add_argument(
+        "--set-name",
+        help="Save a default username to ~/.termchat.json and exit.",
+    )
+    parser.add_argument(
+        "--open",
+        action="store_true",
+        help="Automatically open received images in your OS default image viewer.",
+    )
+    parser.add_argument(
+        "--no-thumb",
+        action="store_true",
+        help="Disable ANSI image thumbnail previews in the terminal.",
+    )
+
+    args = parser.parse_args()
+
+    # Handle configuration saving
+    if args.set_server:
+        set_saved_server_url(args.set_server)
+        print(f"[OK] Default server saved: {args.set_server}")
+        sys.exit(0)
+
+    if args.set_name:
+        set_saved_username(args.set_name)
+        print(f"[OK] Default username saved: {args.set_name}")
+        sys.exit(0)
+
+    # Determine server URL
+    server_url = args.server or get_saved_server_url()
+    if not server_url:
+        print("Welcome to termchat!")
+        try:
+            val = input("Enter your online chat server URL (e.g. https://my-app.onrender.com): ").strip()
+        except (KeyboardInterrupt, EOFError):
+            print("\nAborted.")
+            sys.exit(0)
+
+        if not val:
+            print("Error: A server URL is required.")
+            sys.exit(1)
+
+        set_saved_server_url(val)
+        server_url = val
+        print(f"Server saved to ~/.termchat.json. Next time you can just type 'termchat'!\n")
+
+    # Determine username
+    username = args.name or get_saved_username()
+
+    start(
+        server_url=server_url,
+        username=username,
+        auto_open=args.open,
+        no_thumb=args.no_thumb,
+    )
+
+
+if __name__ == "__main__":
+    main()

termchat/client.py

@@ -0,0 +1,251 @@
+"""
+Terminal Chat Client for termchat.
+Non-intrusive standard terminal interface (no UI takeover, standard terminal stream).
+Sends entered text to online Render/cloud server and displays incoming text and images.
+"""
+
+import asyncio
+from datetime import datetime
+import json
+import os
+from pathlib import Path
+import platform
+import sys
+import urllib.parse
+from typing import Optional
+
+from prompt_toolkit import PromptSession
+from prompt_toolkit.patch_stdout import patch_stdout
+import websockets
+
+from termchat.config import normalize_urls
+from termchat.viewer import download_image, open_system_image, render_ansi_thumbnail
+
+
+class TerminalClient:
+    def __init__(
+        self,
+        server_url: str,
+        username: str,
+        auto_open_images: bool = False,
+        show_thumbnails: bool = True,
+    ):
+        self.raw_server_url = server_url
+        self.ws_url, self.http_base_url = normalize_urls(server_url)
+        self.username = username
+        self.auto_open_images = auto_open_images
+        self.show_thumbnails = show_thumbnails
+        self.running = True
+        self.websocket = None
+        self.last_downloaded_image: Optional[Path] = None
+
+    def print_welcome(self):
+        """Prints a simple standard-line connection notice."""
+        print(f"\n--- termchat connected ---")
+        print(f"User:   {self.username}")
+        print(f"Server: {self.http_base_url}")
+        print(f"Web UI: {self.http_base_url} (open in browser to chat or send images)")
+        print(f"Commands: /help, /open (view last image), /quit")
+        print(f"---------------------------\n")
+
+    def handle_incoming_chat(self, msg: dict):
+        sender = msg.get("sender", "Unknown")
+        client_type = msg.get("client_type", "web")
+        text = msg.get("text", "")
+
+        badge = "[🌐 Web]" if client_type == "web" else "[💻 Terminal]"
+        print(f"\n{badge} {sender}: {text}")
+
+    def handle_incoming_image(self, msg: dict):
+        sender = msg.get("sender", "Unknown")
+        rel_url = msg.get("image_url", "")
+        filename = msg.get("filename", "image.png")
+
+        # Construct full URL
+        full_url = f"{self.http_base_url}{rel_url}"
+
+        print(f"\n[🌐 Web] {sender} 📷 Sent an image: {filename}")
+        print(f"  URL: {full_url}")
+
+        # Download locally
+        saved_path = download_image(full_url, filename)
+        if saved_path:
+            self.last_downloaded_image = saved_path
+            print(f"  Saved locally: {saved_path}")
+
+            # Terminal ANSI thumbnail
+            if self.show_thumbnails:
+                thumb = render_ansi_thumbnail(saved_path, width=38)
+                if thumb:
+                    print("\n" + thumb + "\n")
+
+            # Auto open if requested
+            if self.auto_open_images:
+                open_system_image(saved_path)
+
+    def handle_incoming_system(self, msg: dict):
+        text = msg.get("text", "")
+        print(f"\n[System] {text}")
+
+    async def _receive_loop(self, ws):
+        """Listens for messages from the online server."""
+        try:
+            async for raw in ws:
+                try:
+                    data = json.loads(raw)
+                except Exception:
+                    continue
+
+                m_type = data.get("type")
+
+                if m_type == "chat":
+                    self.handle_incoming_chat(data)
+                elif m_type == "image":
+                    self.handle_incoming_image(data)
+                elif m_type == "system":
+                    self.handle_incoming_system(data)
+                elif m_type == "history":
+                    history = data.get("messages", [])
+                    if history:
+                        print(f"--- Loaded {len(history)} recent message(s) ---")
+                        for h in history:
+                            if h.get("type") == "chat":
+                                self.handle_incoming_chat(h)
+                            elif h.get("type") == "image":
+                                self.handle_incoming_image(h)
+                        print("------------------------------------------\n")
+                elif m_type == "ping":
+                    await ws.send(json.dumps({"type": "pong"}))
+
+        except websockets.exceptions.ConnectionClosed:
+            if self.running:
+                print("\n[Server connection closed. Reconnecting...]")
+        except Exception as e:
+            if self.running:
+                print(f"\n[Error receiving: {e}]")
+
+    async def _input_loop(self, session: PromptSession):
+        """Reads user input and sends it to the server."""
+        while self.running:
+            try:
+                user_text = await session.prompt_async("> ")
+                text = user_text.strip()
+                if not text:
+                    continue
+
+                if text.startswith("/"):
+                    cmd = text.lower().split()[0]
+                    if cmd in ("/quit", "/exit", "/q"):
+                        self.running = False
+                        break
+                    elif cmd == "/help":
+                        print("\nAvailable commands:")
+                        print("  /help           - Show help")
+                        print("  /open           - Open the last received image in your OS viewer")
+                        print("  /web            - Print Web UI URL")
+                        print("  /quit or /exit  - Exit chat\n")
+                        continue
+                    elif cmd == "/web":
+                        print(f"Web UI: {self.http_base_url}")
+                        continue
+                    elif cmd == "/open":
+                        if self.last_downloaded_image and self.last_downloaded_image.exists():
+                            print(f"Opening {self.last_downloaded_image}...")
+                            open_system_image(self.last_downloaded_image)
+                        else:
+                            print("No images received yet.")
+                        continue
+                    else:
+                        print(f"Unknown command '{cmd}'. Type /help for options.")
+                        continue
+
+                # Send message
+                if self.websocket:
+                    payload = {
+                        "type": "chat",
+                        "text": text,
+                        "timestamp": datetime.now().isoformat(),
+                    }
+                    await self.websocket.send(json.dumps(payload))
+                else:
+                    print("[Not connected to server]")
+
+            except (KeyboardInterrupt, EOFError):
+                self.running = False
+                break
+            except Exception as e:
+                print(f"[Input error: {e}]")
+
+    async def run(self):
+        """Main client loop with automatic reconnect."""
+        self.print_welcome()
+        session = PromptSession()
+
+        device = f"{platform.system()} ({platform.machine()})"
+        query_params = urllib.parse.urlencode({
+            "username": self.username,
+            "client_type": "terminal",
+            "device_info": device,
+        })
+        full_ws = f"{self.ws_url}?{query_params}"
+
+        with patch_stdout():
+            while self.running:
+                try:
+                    print(f"Connecting to {self.http_base_url}...")
+                    async with websockets.connect(
+                        full_ws,
+                        ping_interval=25,
+                        ping_timeout=15,
+                    ) as ws:
+                        self.websocket = ws
+                        print("Connected! Start typing text below (Press Enter to send):\n")
+
+                        recv_task = asyncio.create_task(self._receive_loop(ws))
+                        input_task = asyncio.create_task(self._input_loop(session))
+
+                        done, pending = await asyncio.wait(
+                            [recv_task, input_task],
+                            return_when=asyncio.FIRST_COMPLETED,
+                        )
+
+                        for t in pending:
+                            t.cancel()
+                            try:
+                                await t
+                            except asyncio.CancelledError:
+                                pass
+
+                        if not self.running:
+                            break
+
+                except (ConnectionRefusedError, OSError) as e:
+                    if not self.running:
+                        break
+                    print(f"Could not connect to {self.http_base_url}. Retrying in 3s... (Ctrl+C to exit)")
+                    await asyncio.sleep(3)
+                except Exception as e:
+                    if not self.running:
+                        break
+                    print(f"Connection error: {e}. Retrying in 3s...")
+                    await asyncio.sleep(3)
+
+        print("\nExiting termchat. Goodbye!")
+
+
+def start(
+    server_url: str,
+    username: str,
+    auto_open: bool = False,
+    no_thumb: bool = False,
+):
+    client = TerminalClient(
+        server_url=server_url,
+        username=username,
+        auto_open_images=auto_open,
+        show_thumbnails=not no_thumb,
+    )
+    try:
+        asyncio.run(client.run())
+    except KeyboardInterrupt:
+        print("\nExited.")

termchat/config.py

@@ -0,0 +1,113 @@
+"""
+Configuration management for termchat client.
+Handles persistent user preferences in ~/.termchat.json, environment variables,
+and URL normalization for WebSocket and HTTP endpoints.
+"""
+
+import json
+import os
+from pathlib import Path
+from typing import Dict, Optional
+
+CONFIG_FILE = Path.home() / ".termchat.json"
+DEFAULT_FALLBACK_SERVER = "http://localhost:8000"
+
+
+def load_config() -> Dict[str, str]:
+    """Loads configuration from ~/.termchat.json if present."""
+    if CONFIG_FILE.exists():
+        try:
+            with open(CONFIG_FILE, "r", encoding="utf-8") as f:
+                return json.load(f)
+        except Exception:
+            pass
+    return {}
+
+
+def save_config(config: Dict[str, str]):
+    """Persists configuration to ~/.termchat.json."""
+    try:
+        with open(CONFIG_FILE, "w", encoding="utf-8") as f:
+            json.dump(config, f, indent=2)
+    except Exception as e:
+        print(f"[Warning] Could not save config file: {e}")
+
+
+def get_saved_server_url() -> Optional[str]:
+    """Retrieves server URL from ENV, config file, or None."""
+    # 1. Environment variable takes highest priority
+    env_url = os.environ.get("TERMCHAT_SERVER")
+    if env_url:
+        return env_url.strip()
+
+    # 2. Config file
+    cfg = load_config()
+    if "server" in cfg and cfg["server"]:
+        return cfg["server"].strip()
+
+    return None
+
+
+def set_saved_server_url(url: str):
+    """Saves default server URL to config file."""
+    cfg = load_config()
+    cfg["server"] = url.strip()
+    save_config(cfg)
+
+
+def get_saved_username() -> str:
+    """Retrieves saved username or falls back to system username."""
+    cfg = load_config()
+    if "username" in cfg and cfg["username"]:
+        return cfg["username"].strip()
+    return os.environ.get("USER") or os.environ.get("USERNAME") or "TermUser"
+
+
+def set_saved_username(username: str):
+    """Saves default username to config file."""
+    cfg = load_config()
+    cfg["username"] = username.strip()
+    save_config(cfg)
+
+
+def normalize_urls(raw_url: str):
+    """
+    Given a user-provided URL (e.g. 'https://my-app.onrender.com' or 'localhost:8000'),
+    returns (ws_url, http_base_url).
+    """
+    cleaned = raw_url.strip()
+    if not cleaned:
+        cleaned = DEFAULT_FALLBACK_SERVER
+
+    # Ensure protocol
+    if not cleaned.startswith("http://") and not cleaned.startswith("https://") and not cleaned.startswith("ws://") and not cleaned.startswith("wss://"):
+        if "localhost" in cleaned or "127.0.0.1" in cleaned:
+            cleaned = f"http://{cleaned}"
+        else:
+            cleaned = f"https://{cleaned}"
+
+    # Determine HTTP and WS protocols
+    if cleaned.startswith("https://"):
+        http_base = cleaned.rstrip("/")
+        ws_base = "wss://" + cleaned[8:].rstrip("/")
+    elif cleaned.startswith("http://"):
+        http_base = cleaned.rstrip("/")
+        ws_base = "ws://" + cleaned[7:].rstrip("/")
+    elif cleaned.startswith("wss://"):
+        http_base = "https://" + cleaned[6:].rstrip("/")
+        ws_base = cleaned.rstrip("/")
+    elif cleaned.startswith("ws://"):
+        http_base = "http://" + cleaned[5:].rstrip("/")
+        ws_base = cleaned.rstrip("/")
+    else:
+        http_base = f"https://{cleaned.rstrip('/')}"
+        ws_base = f"wss://{cleaned.rstrip('/')}"
+
+    # Strip /ws or trailing slashes from base
+    if http_base.endswith("/ws"):
+        http_base = http_base[:-3]
+    if ws_base.endswith("/ws"):
+        ws_base = ws_base[:-3]
+
+    ws_url = f"{ws_base}/ws"
+    return ws_url, http_base

termchat/viewer.py

@@ -0,0 +1,93 @@
+"""
+Image viewer and thumbnail renderer for terminal clients.
+Handles automatic downloading, terminal ANSI color block preview,
+and launching the OS default image viewer.
+"""
+
+import io
+import os
+from pathlib import Path
+import platform
+import subprocess
+import urllib.request
+from typing import Optional
+
+
+def get_downloads_dir() -> Path:
+    """Returns local downloads directory."""
+    d = Path.cwd() / "downloads"
+    d.mkdir(parents=True, exist_ok=True)
+    return d
+
+
+def download_image(full_image_url: str, filename: str) -> Optional[Path]:
+    """Downloads image to local downloads folder."""
+    try:
+        dest_dir = get_downloads_dir()
+        safe_name = Path(filename).name
+        dest_path = dest_dir / safe_name
+
+        req = urllib.request.Request(
+            full_image_url,
+            headers={"User-Agent": "termchat-terminal-client/1.0"},
+        )
+        with urllib.request.urlopen(req, timeout=10) as response, open(dest_path, "wb") as out_file:
+            out_file.write(response.read())
+
+        return dest_path
+    except Exception as e:
+        return None
+
+
+def open_system_image(filepath: Path):
+    """Opens image in OS default viewer (Photos, Preview, or xdg-open)."""
+    try:
+        sys_name = platform.system()
+        if sys_name == "Windows":
+            os.startfile(str(filepath))
+        elif sys_name == "Darwin":
+            subprocess.run(["open", str(filepath)], check=False)
+        else:
+            subprocess.run(["xdg-open", str(filepath)], check=False)
+    except Exception:
+        pass
+
+
+def render_ansi_thumbnail(filepath: Path, width: int = 36) -> Optional[str]:
+    """
+    Renders an image as an ANSI 24-bit color half-block thumbnail.
+    Each terminal character '▀' has both foreground (top pixel) and background (bottom pixel).
+    Works in Windows Terminal, Linux, macOS, and Raspberry Pi consoles with 24-bit color support.
+    """
+    try:
+        from PIL import Image
+
+        img = Image.open(filepath).convert("RGB")
+        orig_w, orig_h = img.size
+        # Half blocks have 1:2 aspect ratio in terminal fonts
+        aspect = orig_h / orig_w
+        height = int(width * aspect * 0.5)
+        # Ensure even height for half-block pairing
+        if height % 2 != 0:
+            height += 1
+        height = max(height, 2)
+
+        resized = img.resize((width, height), Image.Resampling.BILINEAR)
+        pixels = resized.load()
+
+        lines = []
+        for y in range(0, height, 2):
+            line = []
+            for x in range(width):
+                r1, g1, b1 = pixels[x, y]
+                if y + 1 < height:
+                    r2, g2, b2 = pixels[x, y + 1]
+                else:
+                    r2, g2, b2 = (0, 0, 0)
+                # ▀ is upper half block: fg is top pixel, bg is bottom pixel
+                line.append(f"\033[38;2;{r1};{g1};{b1}m\033[48;2;{r2};{g2};{b2}m▀\033[0m")
+            lines.append("".join(line))
+
+        return "\n".join(lines)
+    except Exception:
+        return None

termchat_client-0.1.0.dist-info/METADATA

@@ -0,0 +1,211 @@
+Metadata-Version: 2.4
+Name: termchat-client
+Version: 0.1.0
+Summary: Lightweight, non-intrusive terminal chat client connecting to an online chat server with real-time text and image support.
+Author-email: TermChat Team <info@termchat.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/your-username/termchat
+Project-URL: Repository, https://github.com/your-username/termchat
+Project-URL: Issues, https://github.com/your-username/termchat/issues
+Keywords: chat,terminal,cli,websocket,raspberry-pi,linux,windows,render,image-chat
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Terminals
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: websockets>=12.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Requires-Dist: pillow>=9.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: httpx>=0.24.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: fastapi>=0.100.0; extra == "dev"
+Requires-Dist: python-multipart>=0.0.6; extra == "dev"
+Dynamic: license-file
+
+# termchat-client 💬🖼️
+
+[![PyPI version](https://img.shields.io/pypi/v/termchat-client.svg)](https://pypi.org/project/termchat-client/)
+[![Python versions](https://img.shields.io/pypi/pyversions/termchat-client.svg)](https://pypi.org/project/termchat-client/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![OS Support](https://img.shields.io/badge/OS-Windows%20%7C%20Linux%20%7C%20Raspberry%20Pi%20%7C%20macOS-success)](https://pypi.org/project/termchat-client/)
+
+**termchat-client** is a lightweight, non-intrusive terminal chat client packaged for Python. It connects directly to an online chat server (running on **Render** or any cloud host), allowing you to chat seamlessly between your **terminal** and an **online HTML web page** viewed by others.
+
+---
+
+## 💡 How It Works
+
+- **Standard Terminal Interaction**: It does **not** change or take over your terminal UI. No fullscreen ncurses/curses screens. Just a normal, standard prompt line where you type text and press Enter.
+- **Bi-Directional Messaging**:
+  - You type text in your terminal ➔ It appears instantly on the web page.
+  - Web users type replies ➔ They print right into your terminal: `[🌐 WebUser]: Hello from Chrome!`
+- **Image Support to Terminal**:
+  - Web users can click the image picker, drag & drop images, or **press `Ctrl+V` to paste screenshots directly from their clipboard**!
+  - When an image is sent from the web, your terminal automatically:
+    1. Downloads the image locally into `./downloads/`
+    2. Prints the image URL and filename
+    3. Renders a compact **ANSI 24-bit color block thumbnail preview** directly inside your terminal!
+    4. Can auto-open the image in your OS default image viewer with `--open` or `/open`.
+- **Works on Any OS**: Windows (PowerShell / CMD / Windows Terminal), Linux (Debian, Ubuntu, Arch), **Raspberry Pi** (ARMv7 / aarch64), and macOS.
+
+---
+
+## 🏛️ System Architecture
+
+```text
+ ┌─────────────────────────────────────────────────────────────┐
+ │                 Online Server on Render                     │
+ │          (FastAPI + WebSockets + Image Upload API)          │
+ │              https://my-chat.onrender.com                   │
+ └──────────────▲───────────────────────────────▲──────────────┘
+                │                               │
+     WebSocket  │                    WebSocket  │  + HTTP Web UI
+     Connection │                    Connection │  (HTML5 / CSS / JS)
+                │                               │
+  ┌─────────────┴──────────┐      ┌─────────────┴─────────────┐
+  │  termchat-client (CLI) │      │      Web Client (HTML)    │
+  │  • Linux / Raspberry Pi│      │  • Desktop Browsers       │
+  │  • Windows CMD / PS    │      │  • Mobile Browsers (iOS)  │
+  │  • macOS Terminal      │      │  • Paste Images (Ctrl+V)  │
+  │  (Just text in & out)  │      │  • Drag & Drop Images     │
+  └────────────────────────┘      └───────────────────────────┘
+```
+
+---
+
+## 📦 Installation
+
+Install the client package on any machine:
+
+```bash
+pip install termchat-client
+```
+
+---
+
+## 🚀 Terminal Client Usage
+
+### 1. Run via CLI
+```bash
+termchat --server https://my-chat.onrender.com --name Alice
+```
+Or via Python module:
+```bash
+python -m termchat --server https://my-chat.onrender.com --name Alice
+```
+
+### 2. Save Your Server Once
+Save your online server URL so you never need to type it again:
+```bash
+termchat --set-server https://my-chat.onrender.com
+termchat --set-name Alice
+```
+Once saved, simply run:
+```bash
+termchat
+```
+or:
+```bash
+python -m termchat
+```
+
+### 3. What It Looks Like in Your Terminal:
+```text
+--- termchat connected ---
+User:   Alice
+Server: https://my-chat.onrender.com
+Web UI: https://my-chat.onrender.com
+Commands: /help, /open (view last image), /quit
+---------------------------
+
+Connected! Start typing text below (Press Enter to send):
+
+> Hello from my Raspberry Pi terminal!
+
+[🌐 Web] Bob: Hey Alice! Check out this screenshot:
+[🌐 Web] Bob 📷 Sent an image: dashboard.png
+  URL: https://my-chat.onrender.com/uploads/dashboard.png
+  Saved locally: C:\projects\terminal-chat\downloads\dashboard.png
+
+  [ANSI Image Thumbnail rendered here]
+
+> 
+```
+
+### In-Terminal Commands:
+- `/open` — Opens the last received image in your OS default image viewer (Photos, Preview, or `xdg-open`).
+- `/web` — Prints the Web UI link.
+- `/help` — Lists available commands.
+- `/quit` (or `Ctrl+C`) — Safely exits.
+
+### Optional Flags:
+- `--open`: Automatically opens any received image in your OS default image viewer.
+- `--no-thumb`: Disables terminal ANSI thumbnail previews (prints URL and saved path only).
+
+---
+
+## 🌐 Deploying the Server to Render (Free)
+
+The server code lives in the `server/` directory and can be deployed to [Render](https://render.com) in 2 minutes for free.
+
+See [DEPLOY_RENDER.md](DEPLOY_RENDER.md) for full instructions:
+1. Push this repository to GitHub.
+2. In Render, click **New + > Web Service** and connect your GitHub repo.
+3. Set **Root Directory** to `server`.
+4. Set **Start Command** to `uvicorn main:app --host 0.0.0.0 --port $PORT`.
+5. Deploy! Render gives you a live HTTPS and WebSocket URL like `https://my-chat.onrender.com`.
+
+---
+
+## 📤 Publishing to PyPI
+
+The package is packaged using modern PEP 517 / PEP 621 (`pyproject.toml`).
+
+1. Build distributions:
+   ```bash
+   python -m build
+   ```
+2. Verify with Twine:
+   ```bash
+   twine check dist/*
+   ```
+3. Upload to PyPI:
+   ```bash
+   twine upload dist/*
+   ```
+   *(Or run the included interactive helper: `python publish.py`)*
+
+See [PUBLISHING.md](PUBLISHING.md) for step-by-step instructions.
+
+---
+
+## 🧪 Testing
+
+Run the automated test suite:
+```bash
+python -m pytest -v
+```
+
+---
+
+## 📄 License
+
+MIT License. See [LICENSE](LICENSE) for details.

termchat_client-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+termchat/__init__.py,sha256=m88TR9LiPzae8YdlWD04SlMfFVBDpVcAGRi_GPpADnM,271
+termchat/__main__.py,sha256=oaDg29DTNudL4s_8Ivx88QtQ0nzHYuWEzuaSSn_d8mY,124
+termchat/cli.py,sha256=F8S_0GDVpNK-Z4ov6BJNLbWai1EBm1bXVPyab3POG8Q,2653
+termchat/client.py,sha256=86Twi978ZeZJP_piYegvCbsafJ4Q_NJIXntNXrq_8qA,9302
+termchat/config.py,sha256=QE1da7cyCjvqqg5Nq_NbgCSV6QA9g4PYP0qBFfPzYWQ,3522
+termchat/viewer.py,sha256=A07tiCx4aBZ3csA0lGy31Ivw91tPTxKs8SxHZ-aQDxQ,3002
+termchat_client-0.1.0.dist-info/licenses/LICENSE,sha256=GfpbbMwTUxH_hvaVgaKPUjpWlWRmy1eVkfnmwHUymKc,1078
+termchat_client-0.1.0.dist-info/METADATA,sha256=RfZFTpGpbHTES7YsZEgkStRTHQvLZa1541MnkPIsoo8,8429
+termchat_client-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+termchat_client-0.1.0.dist-info/entry_points.txt,sha256=_eAa9jAnHvYF5uvfm4tlsB1YDo3sTiWUB6lZx0RPEzw,47
+termchat_client-0.1.0.dist-info/top_level.txt,sha256=EiC1FPPpq71dNhAYr5hEIcqzqugtIP0HRdRD5-_oZVY,9
+termchat_client-0.1.0.dist-info/RECORD,,

termchat_client-0.1.0.dist-info/WHEEL

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

termchat_client-0.1.0.dist-info/entry_points.txt

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

termchat_client-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TermChat Contributors
+
+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.

termchat_client-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+termchat