Skip to content

pindjouf/ruit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RUIT - CSV Integration for Ghunt 🌟

Gruvbox Dark

RUIT is a sleek and intuitive CSV integration tool for Ghunt, designed to make querying potential emails for people as smooth as possible. Just provide a CSV file with a Name column, and RUIT will handle the rest—automating email guesses and validating them via Ghunt.


🚀 Features

  • Parse a CSV with a Name column and generate email guesses.
  • Validate potential email addresses using Ghunt.
  • Beautiful, color-themed console output with Rich.
  • Automatic handling of Ghunt authentication and session management.
  • Output results to text files for discovered emails.

📦 Installation

  1. Clone this repository:

    git clone https://github.com/pindjouf/ruit.git
    cd ruit
  2. Install dependencies:

    pip install -r requirements.txt
  3. Authenticate Ghunt:

    ghunt login

🛠 Usage

Run the script with the following command:

python ruit.py <input_file>
  • <input_file>: Path to the CSV file containing a Name column with the names you want to process.

Example:

Name
John Doe
Jane Smith

The tool will:

  1. Parse names and create email guesses like john.doe@gmail.com.
  2. Query Ghunt for these potential emails.
  3. Output results to found_emails/.

⚡ Example Output

██████╗ ██╗   ██╗██╗████████╗
██╔══██╗██║   ██║██║╚══██╔══╝
██████╔╝██║   ██║██║   ██║   
██╔══██╗██║   ██║██║   ██║   
██║  ██║╚██████╔╝██║   ██║   
╚═╝  ╚═╝ ╚═════╝ ╚═╝   ╚═╝   

CSV integration for Ghunt

🔍 Processing: john.doe
✅ Found data for john.doe@gmail.com

🔍 Processing: jane.smith
⚠️  No data found for jane.smith@gmail.com

🤝 Contributing

Feel free to fork the repository and submit pull requests. Contributions are always welcome!


🛡 License

This project is licensed under the WTFPL License - see the LICENSE file for details.

About

CSV integration for Ghunt

Resources

License

Stars

Watchers

Forks

Languages