| Name | ghunt JSON |
| Version |
2.3.3
JSON |
| download |
| home_page | None |
| Summary | An offensive Google framework. |
| upload_time | 2025-01-25 23:22:49 |
| maintainer | None |
| docs_url | None |
| author | mxrch |
| requires_python | <4.0,>=3.11 |
| license | AGPL-3.0 |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<br>
#### 🌐 GHunt Online version : https://osint.industries
#### 🐍 Now Python 3.13 compatible !
<br>
# 😊 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.
spiderdal Find assets using Digital Assets Links.
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 <email_address> --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 !
<!-- sponsors --><a href="https://github.com/BlWasp"><img src="https://github.com/BlWasp.png" width="50px" alt="BlWasp" /></a> <a href="https://github.com/C3n7ral051nt4g3ncy"><img src="https://github.com/C3n7ral051nt4g3ncy.png" width="50px" alt="C3n7ral051nt4g3ncy" /></a> <a href="https://github.com/gingeleski"><img src="https://github.com/gingeleski.png" width="50px" alt="gingeleski" /></a> <!-- sponsors -->
\
You like my work ?\
[Sponsor me](https://github.com/sponsors/mxrch) on GitHub ! 🤗
Raw data
{
"_id": null,
"home_page": null,
"name": "ghunt",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": null,
"author": "mxrch",
"author_email": "mxrch.dev@pm.me",
"download_url": null,
"platform": null,
"description": "\n\n<br>\n\n#### \ud83c\udf10 GHunt Online version : https://osint.industries\n#### \ud83d\udc0d Now Python 3.13 compatible !\n\n<br>\n\n\n\n# \ud83d\ude0a Description\n\nGHunt (v2) is an offensive Google framework, designed to evolve efficiently.\\\nIt's currently focused on OSINT, but any use related with Google is possible.\n\nFeatures :\n- CLI usage and modules\n- Python library usage\n- Fully async\n- JSON export\n- Browser extension to ease login\n\n# \u2714\ufe0f Requirements\n- Python >= 3.10\n\n# \u2699\ufe0f Installation\n\n```bash\n$ pip3 install pipx\n$ pipx ensurepath\n$ pipx install ghunt\n```\nIt will automatically use venvs to avoid dependency conflicts with other projects.\n\n# \ud83d\udc83 Usage\n\n## Login\n\nFirst, launch the listener by doing `ghunt login` and choose between 1 of the 2 first methods :\n```bash\n$ ghunt login\n\n[1] (Companion) Put GHunt on listening mode (currently not compatible with docker)\n[2] (Companion) Paste base64-encoded cookies\n[3] Enter manually all cookies\n\nChoice =>\n```\n\nThen, use GHunt Companion to complete the login.\n\nThe extension is available on the following stores :\\\n\\\n[](https://addons.mozilla.org/en-US/firefox/addon/ghunt-companion/) [](https://chrome.google.com/webstore/detail/ghunt-companion/dpdcofblfbmmnikcbmmiakkclocadjab)\n\n## Modules\n\nThen, profit :\n```bash\nUsage: ghunt [-h] {login,email,gaia,drive,geolocate} ...\n\nPositional Arguments:\n {login,email,gaia,drive,geolocate}\n login Authenticate GHunt to Google.\n email Get information on an email address.\n gaia Get information on a Gaia ID.\n drive Get information on a Drive file or folder.\n geolocate Geolocate a BSSID.\n spiderdal Find assets using Digital Assets Links.\n\nOptions:\n -h, --help show this help message and exit\n```\n\n\ud83d\udcc4 You can also use --json with email, gaia, drive and geolocate modules to export in JSON ! Example :\n\n```bash\n$ ghunt email <email_address> --json user_data.json\n```\n\n**Have fun \ud83e\udd70\ud83d\udc9e**\n\n# \ud83e\uddd1\u200d\ud83d\udcbb Developers\n\n\ud83d\udcd5 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 !\n\nTo use GHunt as a lib, you can't use pipx because it uses a venv.\\\nSo you should install GHunt with pip :\n```bash\n$ pip3 install ghunt\n```\n\nAnd now, you should be able to `import ghunt` in your projects !\\\nYou can right now play with the [examples](https://github.com/mxrch/GHunt/tree/master/examples).\n\n# \ud83d\udcee Details\n\n## Obvious disclaimer\n\nThis tool is for educational purposes only, I am not responsible for its use.\n\n## Less obvious disclaimer\n\nThis project is under [AGPL Licence](https://choosealicense.com/licenses/agpl-3.0/), and you have to respect it.\\\n**Use it only in personal, criminal investigations, pentesting, or open-source projects.**\n\n## Thanks\n\n- [novitae](https://github.com/novitae) for being my Python colleague\n- All the people on [Malfrats Industries](https://discord.gg/sg2YcrC6x9) and elsewhere for the beta test !\n- The HideAndSec team \ud83d\udc97 (blog : https://hideandsec.sh)\n- [Med Amine Jouini](https://dribbble.com/jouiniamine) for his beautiful rework of the Google logo, which I was inspired by *a lot*.\n\n## Sponsors\n\nThanks to these awesome people for supporting me !\n\n<!-- sponsors --><a href=\"https://github.com/BlWasp\"><img src=\"https://github.com/BlWasp.png\" width=\"50px\" alt=\"BlWasp\" /></a> <a href=\"https://github.com/C3n7ral051nt4g3ncy\"><img src=\"https://github.com/C3n7ral051nt4g3ncy.png\" width=\"50px\" alt=\"C3n7ral051nt4g3ncy\" /></a> <a href=\"https://github.com/gingeleski\"><img src=\"https://github.com/gingeleski.png\" width=\"50px\" alt=\"gingeleski\" /></a> <!-- sponsors -->\n\n\\\nYou like my work ?\\\n[Sponsor me](https://github.com/sponsors/mxrch) on GitHub ! \ud83e\udd17\n\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "An offensive Google framework.",
"version": "2.3.3",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2802931aa55c6db55f726c8022e32271d9bcf563c16fe25b0819f9e6be97325d",
"md5": "38333231ed66d8c02d7672e9fd9b5830",
"sha256": "d9d7f5ed6fa943390819e9313cc747df82e1f372ad546024cb40f3d38d7534bc"
},
"downloads": -1,
"filename": "ghunt-2.3.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "38333231ed66d8c02d7672e9fd9b5830",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 134870,
"upload_time": "2025-01-25T23:22:49",
"upload_time_iso_8601": "2025-01-25T23:22:49.014953Z",
"url": "https://files.pythonhosted.org/packages/28/02/931aa55c6db55f726c8022e32271d9bcf563c16fe25b0819f9e6be97325d/ghunt-2.3.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-25 23:22:49",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "ghunt"
}
