Metadata-Version: 2.4
Name: localstream
Version: 1.0.1
Summary: Python CLI client for slipstream-rust DNS tunnel
Author: LocalStream Team
License: Apache-2.0
Keywords: dns,tunnel,vpn,slipstream,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: Proxy Servers
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Requires-Dist: colorama>=0.4.6
Dynamic: license-file

# LocalStream

A Python command-line client for [slipstream-rust](https://github.com/Mygod/slipstream-rust) DNS tunnel.

## Features

- **VPN Mode**: System-wide traffic tunneling (requires Admin)
- **PROXY Mode**: SOCKS5 proxy on local port
- Auto-reconnect on connection drops
- Easy pip installation
- Colorful CLI interface

## Requirements

- Python 3.13+
- Windows OS
- Administrator privileges (for VPN Mode)

## Installation

```bash
pip install localstream
```

## Usage

```bash
LocalStream          # Normal user (PROXY mode only)
# Run as Administrator for VPN mode
```

### Menu Options

```
[1] Connect to server
    ├── [1] VPN Mode   (system-wide, requires Admin)
    ├── [2] PROXY Mode (SOCKS5 only)
    └── [3] Back
[2] Edit configuration
[3] Exit
```

### Keyboard Shortcuts

- **Ctrl+C**: Disconnect and exit
- **Ctrl+D**: Restart connection

## Configuration

Config stored in `~/.localstream/config.json`:

```json
{
  "server_ip": "203.0.113.2",
  "server_port": 53,
  "local_port": 5201,
  "domain": "s.example.com"
}
```

## Downloaded Binaries

Stored in `~/.localstream/bin/`:
- `slipstream-client.exe` - DNS tunnel client
- `tun2proxy.exe` - TUN adapter for VPN mode
- `wintun.dll` - Windows TUN driver

## License

MIT
