Skip to content

README.md

Latest commit

 

History

History
122 lines (95 loc) · 3.75 KB

README.md

File metadata and controls

122 lines (95 loc) · 3.75 KB

🌐 Hey 403 - CLI Edition
⚡ DNS Accessibility Testing Tool ⚡

Stars Forks Issues License PyPI PyPI Downloads

📖 What is Hey 403?

Hey 403 - CLI Edition is your go-to command-line tool for diagnosing domain accessibility issues across multiple DNS providers. Built for developers, network admins, and security enthusiasts, it helps you uncover:

  • 🚫 Geo-restrictions & Censorship: Spot blocks instantly.
  • 🌍 DNS Inconsistencies: Compare resolutions globally.
  • 🔄 Server Variations: Detect response differences.
  • 🔍 Connectivity Issues: Pinpoint problems fast.

Why Hey 403?

  • ⚡ Lightning-Fast: Get results in seconds with parallel testing.
  • 🌐 Global Scope: Test with 15+ DNS servers worldwide.
  • 🔧 Actionable Insights: Troubleshoot DNS issues like a pro.
  • 📊 Pretty Output: Colorful, rich terminal formatting.

✨ Features

Feature Description
🚪 CLI-First Built for the terminal, no GUI nonsense.
🌍 15+ DNS Preloaded with top global DNS providers.
⚡ Parallel Tests Concurrent checks for speed.
🎨 Rich Output Eye-catching, formatted results.
🔧 DNS Control Set or unset DNS directly from the CLI.
📊 Export Data Save results in CSV and JSON formats.

🚀 Get Started

  1. Install it: 
    pip install hey403
  2. Check the help: 
    hey403 --help
  3. Test a domain: 
    hey403 example.com

🔧 Usage Examples

# Test a domain across all DNS providers
hey403 example.com

# Set the fastest DNS for your system
hey403 example.com --set

# Check your current DNS
hey403 -c

# Revert to default DNS
hey403 --unset

See all options with hey403 --help!

🤝 Contributing

Love Hey 403? Help make it better!

  1. Fork it 🍴
  2. Set up your dev environment: 
    git clone https://github.com/Diramid/hey-403-cli.git
cd hey-403-cli
pip install -e .[dev]
  3. Test your changes: 
    pytest tests/ -v
  4. Push & PR: 
    git checkout -b feature/cool-stuff
git commit -m "Add cool stuff"
git push origin feature/cool-stuff
  5. Open a Pull Request on GitHub

Check out our Contributing Guide for more!

⚖️ License

Hey 403 is proudly open-source under the MIT License. Use it, tweak it, share it—just keep it legal!

🌟 Show Your Support

  • ⭐ Star us on GitHub!
  • 🐛 Report bugs or suggest features in Issues.
  • 💬 Join the conversation—tell us how you use Hey 403!

Heads Up! 📢
Use Hey 403 responsibly and respect local laws. Unauthorized system access is a no-go.