> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reconnect-tool.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reconnect Termux: Android Client Setup & Overview Guide

> Install and configure the Reconnect Termux client on Android — a Python TUI app for 24/7 Roblox auto-rejoin, account monitoring, and remote control.

The Reconnect Termux client is a Python terminal UI application that runs inside Termux on Android. It handles automatic rejoining, multi-account monitoring, and remote control for Roblox clones — keeping your accounts online around the clock without any manual intervention.

## Requirements

<CardGroup cols={2}>
  <Card title="Account & License" icon="key" href="https://app.reconnect-tool.com">
    A Reconnect account at [app.reconnect-tool.com](https://app.reconnect-tool.com) and a valid license key from [shop.reconnect-tool.com](https://shop.reconnect-tool.com).
  </Card>

  <Card title="Termux (F-Droid)" icon="terminal" href="https://f-droid.org/packages/com.termux/">
    Termux installed from **F-Droid only**. The Play Store version is outdated and will cause the installer to fail.
  </Card>

  <Card title="Discord Account" icon="discord" href="https://discord.gg/reconnect">
    Required to retrieve your personal install command and verification codes during login.
  </Card>

  <Card title="Device" icon="mobile" href="https://f-droid.org/packages/com.termux/">
    Android 8.0 or later, approximately 200 MB of free storage, and a stable internet connection.
  </Card>
</CardGroup>

<Note>
  Root access is required for Kill Mode, Android ID changes, and cache clearing. Basic auto-rejoin works without root.
</Note>

<Warning>
  **Do NOT install Termux from the Google Play Store.** The Play Store version is severely outdated and the Reconnect installer will fail. Always download Termux from [F-Droid](https://f-droid.org).
</Warning>

***

## Installation

<Steps>
  <Step title="Install Termux from F-Droid">
    Download and install Termux from [f-droid.org](https://f-droid.org). Do not use the Play Store version.
  </Step>

  <Step title="Grant storage access">
    Open Termux and run the following command, then tap **Allow** when prompted:

    ```bash theme={null}
    termux-setup-storage
    ```
  </Step>

  <Step title="Get your personal install command">
    1. Join the Discord server at **discord.gg/reconnect**.
    2. Navigate to the **#download** channel.
    3. Tap the **Get Install Command** button.
    4. The bot sends you a personal, one-time install command in your DMs.

    <Warning>
      Never share your install command with anyone. Sharing it results in a **permanent ban** on your account.
    </Warning>
  </Step>

  <Step title="Run the install command in Termux">
    Paste your personal command into Termux and run it:

    ```bash theme={null}
    curl -sL https://dl.reconnect-tool.com/install.sh | bash -s -- YOUR_TOKEN
    ```

    Replace `YOUR_TOKEN` with the token the bot provided.
  </Step>
</Steps>

***

## Running the Client

After installation completes, launch the client at any time with:

```bash theme={null}
python3 ~/.reconnect/reconnect.py
```

### Updating

To update the client, return to the **#download** channel in Discord, tap **Get Update Command**, and run the command in Termux:

```bash theme={null}
curl -sL https://dl.reconnect-tool.com/update.sh | bash
```

***

## Startup Checks

Every time the client launches, it runs four automatic checks before showing the main menu:

<CardGroup cols={2}>
  <Card title="Root Detection" icon="shield" href="/termux/overview">
    Detects whether root access is available and adjusts feature availability accordingly.
  </Card>

  <Card title="Version Check" icon="arrow-up-circle" href="/termux/overview">
    Compares your installed version against the latest. Prompts you to update if you're behind.
  </Card>

  <Card title="Integrity Check" icon="lock" href="/termux/overview">
    Verifies that the client files have not been tampered with. Exits immediately if a mismatch is detected.
  </Card>

  <Card title="Startup Check" icon="circle-check" href="/termux/overview">
    Validates that your Termux version and platform meet minimum requirements.
  </Card>
</CardGroup>

***

## Login Flow

<Steps>
  <Step title="Auto-login (returning users)">
    If you have logged in before, your credentials are saved securely and the client logs you in automatically. Skip to step 5.
  </Step>

  <Step title="Enter your email and password">
    On first launch, enter the email and password for your Reconnect account.
  </Step>

  <Step title="Get your verification code">
    In your Discord server, run the `/request-termux-code` command. The bot sends a one-time verification code — paste it into the client.
  </Step>

  <Step title="Select a subscription">
    Choose the subscription you want to activate on this device.
  </Step>

  <Step title="Device binding">
    The client registers your device's HWID to your subscription and syncs your settings from the server.
  </Step>
</Steps>

<Note>
  Your login is saved securely after the first sign-in. Future launches skip directly to the main menu.
</Note>

***

## Architecture

Understanding how the client connects to Reconnect helps you know what to expect based on your tier.

### Connectivity Model

| Connection Type | What it means for you                                                                                             | Available On              |
| --------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------- |
| **Heartbeat**   | The client checks in with the server every 10 minutes. Dashboard sees your device status; no live remote control. | All tiers (Free included) |
| **WebSocket**   | A live, persistent connection that enables real-time dashboard commands and instant remote control.               | Limited, Pro, Pro+        |

### Remote Control by Tier

| Tier    | Dashboard Control                 |
| ------- | --------------------------------- |
| Free    | No remote control                 |
| Limited | Remote control via WebSocket      |
| Pro     | Remote control via WebSocket      |
| Pro+    | Full remote control via WebSocket |

***

## Region Detection

The client automatically detects your region based on your device's UTC offset and routes you to the nearest infrastructure:

| Region   | UTC Offset Range            |
| -------- | --------------------------- |
| Asia     | +5 to +12                   |
| Europe   | 0 to +4                     |
| Americas | Default (all other offsets) |

No configuration is required — region selection happens silently at startup.