Metadata-Version: 2.4
Name: sonx
Version: 0.1.0
Summary: Superior Organised Network - Remote access tool
Author: son
License: MIT
Project-URL: Homepage, https://github.com/randompasswordis7/son
Project-URL: Source, https://github.com/randompasswordis7/son
Keywords: remote-access,ssh,tunnel,terminal,network
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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 :: System :: Networking
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.12.0
Requires-Dist: rich>=13.0.0
Requires-Dist: websockets>=12.0
Provides-Extra: web
Requires-Dist: fastapi>=0.110.0; extra == "web"
Requires-Dist: uvicorn>=0.27.0; extra == "web"
Requires-Dist: httpx>=0.27.0; extra == "web"

# son — Superior Organised Network

Remote access tool with a daemon-agent architecture. Run `sond` on target machines, connect via `son` CLI or web UI.

## Install

```bash
pip install son
# or with web UI support:
pip install "son[web]"
```

## Quick start

**On the target machine** (the one you want to access):

```bash
sond
```

**On your machine** (the one you connect from):

```bash
# Discover sond instances on LAN
son discover

# Connect to a remote shell
son connect 192.168.1.50

# Tunnel a local port through the target
son tunnel 192.168.1.50 -L 8080:localhost:80

# Web terminal UI
son web
```

## How it works

| Component | Runs on | Purpose |
|---|---|---|
| `sond` | Target machine | UDP broadcast (LAN discovery), WebSocket server for shell + tunnels |
| `son` | Your machine | CLI + web UI, connects to `sond` instances |

## Commands

| Command | Description |
|---|---|
| `sond` | Start daemon (`-p` port, `--password`, `--no-broadcast`) |
| `son discover` | Scan LAN for sond instances |
| `son connect <host>` | Open remote shell (`-s powershell/bash/cmd`) |
| `son tunnel <host> -L local:remote:port` | Local port forwarding |
| `son web` | Browser-based terminal at `http://127.0.0.1:8585` |

## License

MIT
