• Async scanning across a large platform catalog from sites.json
• Feature extraction with selectolax instead of fragile regex
• Heuristic detection with confidence scoring
• JSON, CSV, and HTML reports
• Playwright fallback for hard pages

• Python 3.10+
• Required packages: aiohttp, selectolax, playwright
• Internet connection

# Clone the repository
git clone https://github.com/arxhr007/Aliens_eye.git
cd Aliens_eye

# Upgrade pip
python3 -m pip install --upgrade pip

# Install dependencies
python3 -m pip install -r requirements.txt

# Install Playwright browser binaries
python3 -m playwright install --with-deps

git clone https://github.com/arxhr007/Aliens_eye.git
cd Aliens_eye

# Upgrade pip
py -m pip install --upgrade pip

# Install dependencies
py -m pip install -r requirements.txt

# Install Playwright browser binaries
py -m playwright install

After installation, run the scanner from the project directory.

Linux / iSH:

cd Aliens_eye
python3 aliens_eye.py username

Windows (PowerShell):

cd Aliens_eye
py .\aliens_eye.py username

Aliens Eye reads a JSON config file and merges it with CLI flags. CLI flags always win.

Search order when no --config is provided:

• ./config.json
• <script_dir>/config.json
• /etc/aliens_eye/config.json
• /usr/local/etc/aliens_eye/config.json
• /data/data/com.termux/files/usr/etc/aliens_eye/config.json

Example config.json:

{
  "concurrent": 50,
  "timeout": 10.0,
  "max_content_bytes": 100000,
  "retries": 2,
  "backoff_base": 0.5,
  "backoff_cap": 8.0,
  "jitter": 0.2,
  "rate_limit_delay": 0.2,
  "fingerprints_path": "cache/fingerprints.json",
  "output_dir": "results",
  "output_formats": ["json", "csv", "html"],
  "use_playwright": false,
  "max_fingerprints_per_label": 50,
  "level": "basic"
}

# Interactive prompts
aliens_eye

# Single username
aliens_eye username

# Multiple usernames
aliens_eye username1 username2

# Advanced scan level
aliens_eye username -l advanced

# Limit concurrency
aliens_eye username -c 30

# Enable verbose logs
aliens_eye username -v

# Use a custom config file
aliens_eye --config config.json username

# Export CSV + HTML in addition to JSON
aliens_eye username --format json,csv,html --output results

# Enable Playwright fallback for Maybe results
aliens_eye username --playwright

# View results from a previous scan
aliens_eye -r results/username_advanced_20250514_120000.json

If you run from source, call:

python aliens_eye.py username

Results are saved to the output directory with timestamped filenames:

• JSON: username_level_YYYYMMDD_HHMMSS.json
• CSV: username_level_YYYYMMDD_HHMMSS.csv
• HTML: username_level_YYYYMMDD_HHMMSS.html

Core modules live under core/ (scanner, detector, analyzer, http, exporter). Utilities are in utils/. For internals and flowcharts, see WORKING.md.

This tool is for educational purposes and legitimate OSINT research only. You are responsible for complying with laws and site terms of service.