Metadata-Version: 2.4
Name: qrtunnel
Version: 2.1.2
Summary: Cross-platform file sharing via QR code with ngrok and SSH tunneling
Author-email: Aniruth Karthik <aniruthkarthik10@gmail.com>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
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: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: qrcode
Requires-Dist: pyngrok
Requires-Dist: streaming-form-data
Requires-Dist: werkzeug

# QRTunnel

Cross-platform file sharing via SSH reverse tunneling and QR codes. Allows sharing files with mobile devices anywhere in the world, even behind NAT/firewalls.

## Features

*   **Simple File Sharing:** Share one or more files directly from your command line.
*   **Receive Files:** Start in upload mode to receive files from any device with a web browser, like your phone.
*   **Secure Tunnels:** Utilizes ngrok for secure, public HTTPS tunnels, even behind NATs and firewalls.
*   **No-Auth Alternative:** For Mac/Linux users, an SSH-based tunnel (localhost.run) is available, requiring no ngrok account.
*   **QR Code Display:** Generates a scannable QR code in your terminal for easy access on mobile devices.
*   **Web Interface:** Provides a simple web page for recipients to download shared files, individually or as a ZIP archive.
*   **Ngrok Authtoken Management:** Interactive setup and status check for your ngrok authentication token.

## Installation

1.  **Clone the repository:**
    ```bash
    git clone https://github.com/AniruthKarthik/qrtunnel.git
    cd qrtunnel
    ```
2.  **Install the package:**
    ```bash
    pip install qrtunnel
    ```
    This will install `qrtunnel` and all its dependencies.

## Usage

### Sharing Files (PC to Phone)

To share one or more files:

```bash
qrtunnel <file_path1> [<file_path2> ...]
```

Example:
```bash
qrtunnel mydocument.pdf myimage.jpg
```

This will start a local HTTP server, create a public tunnel (using ngrok by default), and display a QR code. Scan the QR code with your phone to access the files.

### Receiving Files (Phone to PC)

To receive files on your computer, simply run `qrtunnel` without any file paths:

```bash
qrtunnel
```

This starts the server in upload mode. Scan the generated QR code on your phone, and you'll get a web page where you can select and upload a file to your computer.

### Ngrok Authentication Setup

`qrtunnel` uses ngrok for reliable public tunnels. The first time you use it, or if you need to update your token, you'll be prompted to set up your ngrok authtoken. You can also do this manually:

```bash
qrtunnel --setup
```

Follow the on-screen instructions to get and save your ngrok authtoken.

### Check Ngrok Status

To check if your ngrok authtoken is configured:

```bash
qrtunnel --status
```

### No-Auth Sharing (Mac/Linux Only)

If you're on Mac or Linux and prefer not to use an ngrok account, you can use the `--noauth` flag. This will attempt to create an SSH tunnel via `localhost.run`.

```bash
qrtunnel <file_path1> [<file_path2> ...] --noauth
```

**Note:** This option is not supported on Windows.
### Quitting the Server

The server will run until you press `q` in the terminal or use `Ctrl+C`.
