hablas-tools
v13.0.15
Published
HABLAS — Username Intelligence Suite (TikTok + WhatsApp + Instagram) — Windows/macOS/Linux
Maintainers
Readme
HABLAS Tools
Username Intelligence Suite — by Abdulmoin Hablas
All-in-one CLI username checker for TikTok and WhatsApp. Finds available usernames using random, sequential, pattern, or file-based generation modes.
Install
npm install -g hablas-toolsUsage
hablas-tools
# or use the alias:
htCLI Flags
| Flag | Description |
|--------------|--------------------|
| -v | Show version |
| -h | Show help |
First Run
- Enter password when prompted (default: set by admin)
- Choose a tool from the main menu
- Follow the interactive Quick Start wizard
Platforms
| 🪟 Windows | 🍎 macOS | 🐧 Linux | |:----------:|:--------:|:--------:| | ✅ | ✅ | ✅ |
No Android/Termux support.
TikTok Username Checker
Checks TikTok username availability by scraping profile pages via HTTP CONNECT tunnel proxies.
Features
- Generation modes: Random · Sequential (brute force) · Pattern · From File · Single Name
- Username length: 1–5 characters (fixed) or 1–5 mixed
- Character sets: TikTok Full (a-z 0-9 . _) · Alpha+Digits · Letters Only
- Proxy support: Auto-scrape & validate working proxies, or add manually
- Smart proxy fallback: Auto-switches to direct connection when proxies return bot pages
- Skip checked: Remembers previously checked usernames across runs
- Notifications: Discord webhook + Telegram bot for available/banned names
- File logging: Timestamped logs in
logs/directory - Resume: Continue interrupted sequential scans from where you stopped
- Statistics: Real-time progress bar, checks/min, available/banned/taken counts
Username Validation
The generator automatically skips usernames that TikTok is guaranteed to reject:
- ❌ Starts with a period (
.) — e.g..abc - ❌ Ends with a period (
.) — e.g.abc. - ❌ Digits only — e.g.
1234
This saves significant time by not checking invalid usernames.
Speed Presets
| Preset | Delay | Risk Level | |------------|-----------|---------------| | Safe | 3–6s | Lowest risk | | Normal | 1.5–4s | Balanced | | Fast | 1–2s | Higher risk | | Aggressive | 0.5–1s | Will get rate limited |
WhatsApp Username Checker
Checks WhatsApp username availability using the MEX/GraphQL API (same API WhatsApp Web uses internally).
Features
- Generation modes: Random · Sequential · Pattern · From File · Single Name
- Username length: 1–5 characters (fixed) or 1–5 mixed
- Character sets: WhatsApp Full (a-z 0-9 . _) · Alpha+Digits · Letters Only
- Proxy support: HTTP/HTTPS/SOCKS5 for Baileys connection
- QR authentication: Scan once, session persists in
auth_info/ - Dual protocol: MEX/GraphQL (primary) + USync manual injection (fallback)
- Skip checked: Remembers previously checked usernames across runs
- Notifications: Discord webhook + Telegram bot for available names
- File logging: Timestamped logs in
logs/directory - Rate limiting: Per-run/per-hour caps + periodic cooldown + ban detection
Username Feature Availability
WhatsApp usernames are rolling out in waves during 2026:
- Wave 1: Started July 7, 2026 (limited countries)
- Wave 2: Starts July 20, 2026
- Global: From September 2026
If your account doesn't have the feature yet, the tool will show a clear error message.
Username Validation
The generator automatically skips usernames WhatsApp is guaranteed to reject:
- ❌ Starts with a period (
.) - ❌ Digits only — e.g.
1234
Configuration
All settings are saved to data/config.json and persist across runs. Each tool has its own Settings menu accessible from the tool's main menu.
Global Settings
- Discord webhook URL (shared across tools)
- Telegram bot token + chat ID (shared across tools)
- Password change
Output Files
data/
├── config.json # Persistent configuration
├── tiktok_checked_log.json # TikTok checked username cache
├── tiktok_resume_state.json # TikTok sequential scan resume state
├── wa_checked.txt # WhatsApp checked username cache
├── wa_available.txt # WhatsApp available usernames
├── wa_taken.txt # WhatsApp taken usernames
├── available.txt # TikTok available usernames
├── banned.txt # TikTok banned usernames
└── taken.txt # TikTok taken usernames
results/ # Per-scan result files
├── tiktok_check_*_available.txt
├── tiktok_check_*_banned.txt
├── whatsapp_check_*_available.txt
└── whatsapp_check_*_taken.txt
logs/ # Timestamped run logs
├── tiktok_*.log
└── whatsapp_*.logRequirements
- Node.js ≥ 18
- WhatsApp account (for WhatsApp tool — scan QR on first run)
- Internet connection (for proxy scraping and username checking)
License
MIT
by Abdulmoin Hablas — hablas.tech
