Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mxrch/GHunt
🕵️♂️ Offensive Google framework.
https://github.com/mxrch/GHunt
google hideandsec osint
Last synced: about 1 month ago
JSON representation
🕵️♂️ Offensive Google framework.
- Host: GitHub
- URL: https://github.com/mxrch/GHunt
- Owner: mxrch
- License: other
- Created: 2020-10-02T11:26:03.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-06-21T14:18:41.000Z (3 months ago)
- Last Synced: 2024-07-22T14:38:32.657Z (about 2 months ago)
- Topics: google, hideandsec, osint
- Language: Python
- Homepage:
- Size: 417 KB
- Stars: 15,303
- Watchers: 511
- Forks: 1,269
- Open Issues: 54
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
- awesome - mxrch/GHunt - 🕵️♂️ Offensive Google framework. (Python)
- awesome-starts - mxrch/GHunt - 🕵️♂️ Investigate Google emails and documents. (Python)
- awesome-hacking-lists - mxrch/GHunt - 🕵️♂️ Offensive Google framework. (Python)
- jimsghstars - mxrch/GHunt - 🕵️♂️ Offensive Google framework. (Python)
- project-awesome - mxrch/GHunt - 🕵️♂️ Offensive Google framework. (Python)
README
#### 🌐 GHunt Online version : https://osint.industries
# 😊 Description
GHunt (v2) is an offensive Google framework, designed to evolve efficiently.\
It's currently focused on OSINT, but any use related with Google is possible.
Features :
- CLI usage and modules
- Python library usage
- Fully async
- JSON export
- Browser extension to ease login
# ✔️ Requirements
- Python >= 3.10
# ⚙️ Installation
```bash
$ pip3 install pipx
$ pipx ensurepath
$ pipx install ghunt
```
It will automatically use venvs to avoid dependency conflicts with other projects.
# 💃 Usage
## Login
First, launch the listener by doing `ghunt login` and choose between 1 of the 2 first methods :
```bash
$ ghunt login
[1] (Companion) Put GHunt on listening mode (currently not compatible with docker)
[2] (Companion) Paste base64-encoded cookies
[3] Enter manually all cookies
Choice =>
```
Then, use GHunt Companion to complete the login.
The extension is available on the following stores :\
\
[](https://addons.mozilla.org/en-US/firefox/addon/ghunt-companion/) [](https://chrome.google.com/webstore/detail/ghunt-companion/dpdcofblfbmmnikcbmmiakkclocadjab)
## Modules
Then, profit :
```bash
Usage: ghunt [-h] {login,email,gaia,drive,geolocate} ...
Positional Arguments:
{login,email,gaia,drive,geolocate}
login Authenticate GHunt to Google.
email Get information on an email address.
gaia Get information on a Gaia ID.
drive Get information on a Drive file or folder.
geolocate Geolocate a BSSID.
Options:
-h, --help show this help message and exit
```
📄 You can also use --json with email, gaia, drive and geolocate modules to export in JSON ! Example :
```bash
$ ghunt email --json user_data.json
```
**Have fun 🥰💞**
# 🧑💻 Developers
📕 I started writing some docs [here](https://github.com/mxrch/GHunt/wiki) and examples [here](https://github.com/mxrch/GHunt/tree/master/examples), feel free to contribute !
To use GHunt as a lib, you can't use pipx because it uses a venv.\
So you should install GHunt with pip :
```bash
$ pip3 install ghunt
```
And now, you should be able to `import ghunt` in your projects !\
You can right now play with the [examples](https://github.com/mxrch/GHunt/tree/master/examples).
# 📮 Details
## Obvious disclaimer
This tool is for educational purposes only, I am not responsible for its use.
## Less obvious disclaimer
This project is under [AGPL Licence](https://choosealicense.com/licenses/agpl-3.0/), and you have to respect it.\
**Use it only in personal, criminal investigations, pentesting, or open-source projects.**
## Thanks
- [novitae](https://github.com/novitae) for being my Python colleague
- All the people on [Malfrats Industries](https://discord.gg/sg2YcrC6x9) and elsewhere for the beta test !
- The HideAndSec team 💗 (blog : https://hideandsec.sh)
- [Med Amine Jouini](https://dribbble.com/jouiniamine) for his beautiful rework of the Google logo, which I was inspired by *a lot*.
## Sponsors
Thanks to these awesome people for supporting me !
\
You like my work ?\
[Sponsor me](https://github.com/sponsors/mxrch) on GitHub ! 🤗