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