Termux Client Overview

The Reconnect Termux client is a terminal UI application written in Python that runs inside Termux on Android. It handles auto-rejoin, account monitoring, and remote control for Roblox clones running on the device.

Requirements

Before installing, make sure you have everything below ready:

Reconnect Account

Create a free account at app.reconnect-tool.com

License Key

Purchase a key from the shop or redeem a free trial

Termux (F-Droid)

Install Termux from F-Droid — not the Play Store version

Discord Account

Join the Reconnect Discord to get your personal install command

Requirement	Details
Android version	8.0 or higher
Storage	~200 MB free
Root access	Required for Kill Mode, Android ID rotation, and cache clearing. Non-root works for basic rejoin.
Internet	Stable connection required

Do not install Termux from the Google Play Store — that version is outdated and the installer will fail. Use F-Droid.

Installation

Install Termux from F-Droid

Download and install Termux from F-Droid.

Do not install Termux from the Google Play Store — the Play version is outdated and the installer will fail.

Grant storage access

Open Termux and run:

termux-setup-storage

Tap Allow when Android prompts for storage permission.

Get your install command from Discord

Join the Reconnect Discord server
Go to the #download channel or the panel channel in the server
Click the Get Install Command button
The bot sends you a personal, one-time install command — only visible to you

Your install command is tied to your account. Never share it — sharing results in a permanent ban.

Paste the command into Termux

Copy the command the bot gave you and paste it into Termux:

curl -sL https://dl.reconnect-tool.com/install.sh | bash -s -- YOUR_TOKEN

The installer automatically updates packages, installs dependencies, and launches the client.

After Installation

From the second run onwards, just open Termux and run:

python3 ~/.reconnect/reconnect.py

Updating

Go to the #download channel in Discord and click Get Update Command, then paste it into Termux:

curl -sL https://dl.reconnect-tool.com/update.sh | bash

Startup

Every time the client launches, it runs four checks before showing the login screen:

Check	What it does
Root detection	Detects `su` access. Non-root mode uses `termux-am` instead.
Version check	Compares the local version against the server. Prompts `U` to update if behind.
Integrity check	Verifies the binary hasn’t been tampered with. Exits if check fails.
Startup check	Validates Termux version and platform against server minimums.

Auto-login (returning users)

If you’ve logged in before, the client logs you in automatically — no credentials needed.

Manual login

Enter your Reconnect email and password.

Get your verification code

Open the Reconnect Discord server and run the slash command:

/request-termux-code

The bot will send you a verification code. Enter it in the client to confirm your login.

Select a subscription

Choose which active subscription to use on this device.

Device binding

The device is registered to the selected subscription. Settings and templates are synced from the server.

Your login is saved securely on the device so future launches skip manual login automatically.

Architecture

Component	Role
Settings Manager	Loads settings from the server on login. No local file — server is always the source of truth.
WebSocket (non-free tiers)	Keeps a live connection to receive remote commands from the dashboard in real time.
Heartbeat (free tier)	Polls the server every 10 minutes instead of WebSocket. Device status visible in dashboard.
WS Router	Dispatches incoming dashboard commands (remote control, settings updates, account control) to the correct terminal module.
Crash Log	Writes panics and errors to `~/reconnect_crash.log` for debugging.

Tiers and Connectivity

Tier	Connection method	Remote control
Free	Heartbeat (10 min poll)	No
Limited	WebSocket	Yes
Pro	WebSocket	Yes
Pro+	WebSocket	Yes (full remote control)

Region Detection

The client automatically selects the nearest WebSocket gateway based on UTC offset:

Region	UTC offset
Asia (Singapore)	+5 to +12
Europe	0 to +4
Americas (default)	All others

​Requirements

Reconnect Account

License Key

Termux (F-Droid)

Discord Account

​Installation

​After Installation

​Updating

​Startup

​Login Flow

​Architecture

​Tiers and Connectivity

​Region Detection

Requirements

Installation

After Installation

Updating

Startup

Login Flow

Architecture

Tiers and Connectivity

Region Detection