tokenalive-x

x(twitter) account checker for auth_token lists with sticky proxy management, proxy tracking, controlled retries, and sqlite stats.

What it does

• checks account status via tweepy-self (Client.establish_status())
• treats only GOOD as alive
• runs in parallel with configurable concurrency
• retries up to 3 times only on temporary/network failures
• stores runs, attempts, statuses, and proxy observations in sqlite

Safety defaults

• update_account_info_on_startup = false (no extra startup requests)
• wait_on_rate_limit = false (no long built-in sleeps)
• auto_relogin = false (no relogin side effects)

Files

• config.toml - local config (copy from example)
• twitters.txt - input tokens (one per line)
• proxy.txt - sticky proxy pool (one proxy URL per line)
• tokenalive-x.db - sqlite database

if twitters.txt exists and check_only_file_if_exists = true, checker runs only tokens from file. if twitters.txt is absent, checker runs all accounts from DB.

Install

uv sync

Run

cp config.example.toml config.toml
uv run python main.py

Status mapping

• GOOD -> alive
• BAD_TOKEN, SUSPENDED, LOCKED, CONSENT_LOCKED, NOT_FOUND -> not alive
• UNKNOWN -> technical failure after retries