Skip to content

xsyncio/checkcord

Repository files navigation

CheckCord Banner

CheckCord

A Discord username availability checker and generator.

License: MIT Python Code Style: Ruff Checked with BasedPyright


✨ Features

  • 🚀 Blazing Fast: Engineered with curl_cffi for high-performance, async HTTP requests that mimic browser fingerprints.
  • 🧠 Smart Generators:
    • Random: xc._
    • Dictionary: Cool Adjective + Noun combinations.
    • Leet Speak: v1p3r style transformations.
    • Remote: Fetch wordlists dynamically.
  • ⏱️ Intelligent Rate Limiting: Global backoff handling that respects Discord's API limits automatically.
  • 🔄 Proxy Rotation: Just drop a proxies.txt file and let CheckCord handle the rotation.
  • 🔔 Webhook Notifications: Get notified instantly via Discord webhooks when a username is found.

📦 Installation

git clone https://github.com/Xsyncio/checkcord.git
cd checkcord
pip install -e .

⚡ Usage

🧙 Interactive Wizard

Simply run the tool to enter the interactive mode:

checkcord

🖥️ Command Line Interface

Generate & Check:

# Generate 50 usernames of length 4
checkcord generate --count 50 --length 4

Check from File:

# Check validity of a list of usernames
checkcord check --file my_usernames.txt

⚙️ Configuration

CheckCord automatically generates a config.json on first run.

{
  "token": "YOUR_USER_TOKEN",
  "webhook_url": "YOUR_WEBHOOK_URL",
  "thread_count": 5,
  "retry_delay": 2.5
}

Warning

Use at your own risk. Automating user accounts may violate Discord Terms of Service.


🛠️ Development

Command Description
pytest Run the test suite
basedpyright Run strict type checking

Built with ❤️ by Xsyncio

About

Efficient and reliable Discord username validation with alot of filters.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages