![](assets/long_banner.png)
<br>
#### 🌐 GHunt Online version : https://osint.industries
<br>
![Python minimum version](https://img.shields.io/badge/Python-3.10%2B-brightgreen)
# 😊 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 :\
\
[![Firefox](https://files.catbox.moe/5g2ld5.png)](https://addons.mozilla.org/en-US/firefox/addon/ghunt-companion/) [![Chrome](https://storage.googleapis.com/web-dev-uploads/image/WlD8wC6g8khYWPJUsQceQkhXSlv1/UV4C4ybeBTsZt43U4xis.png)](https://chrome.google.com/webstore/detail/ghunt-companion/dpdcofblfbmmnikcbmmiakkclocadjab)
## Modules
Then, profit :
```bash
usage: ghunt [-h] {login,email,gaia,drive} ...
positional arguments:
{login,email,gaia,drive}
login (--clean) Authenticate GHunt to Google.
email (--json) Get information on an email address.
gaia (--json) Get information on a Gaia ID.
drive (--json) Get information on a Drive file or folder.
options:
-h, --help show this help message and exit
```
📄 You can also use --json with email, gaia and drive 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/im-hanzou"><img src="https://github.com/im-hanzou.png" width="50px" alt="im-hanzou" /></a> <a href="https://github.com/gingeleski"><img src="https://github.com/gingeleski.png" width="50px" alt="gingeleski" /></a> <a href="https://github.com/ItsMalware"><img src="https://github.com/ItsMalware.png" width="50px" alt="ItsMalware" /></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": ">=3.10",
"maintainer_email": null,
"keywords": "osint, pentest, cybersecurity, investigation, hideandsec, malfrats",
"author": null,
"author_email": "mxrch <mxrch.dev@pm.me>",
"download_url": null,
"platform": null,
"description": "![](assets/long_banner.png)\r\n\r\n<br>\r\n\r\n#### \ud83c\udf10 GHunt Online version : https://osint.industries\r\n\r\n<br>\r\n\r\n![Python minimum version](https://img.shields.io/badge/Python-3.10%2B-brightgreen)\r\n\r\n# \ud83d\ude0a Description\r\n\r\nGHunt (v2) is an offensive Google framework, designed to evolve efficiently.\\\r\nIt's currently focused on OSINT, but any use related with Google is possible.\r\n\r\nFeatures :\r\n- CLI usage and modules\r\n- Python library usage\r\n- Fully async\r\n- JSON export\r\n- Browser extension to ease login\r\n\r\n# \u2714\ufe0f Requirements\r\n- Python >= 3.10\r\n\r\n# \u2699\ufe0f Installation\r\n\r\n```bash\r\n$ pip3 install pipx\r\n$ pipx ensurepath\r\n$ pipx install ghunt\r\n```\r\nIt will automatically use venvs to avoid dependency conflicts with other projects.\r\n\r\n# \ud83d\udc83 Usage\r\n\r\n## Login\r\n\r\nFirst, launch the listener by doing `ghunt login` and choose between 1 of the 2 first methods :\r\n```bash\r\n$ ghunt login\r\n\r\n[1] (Companion) Put GHunt on listening mode (currently not compatible with docker)\r\n[2] (Companion) Paste base64-encoded cookies\r\n[3] Enter manually all cookies\r\n\r\nChoice =>\r\n```\r\n\r\nThen, use GHunt Companion to complete the login.\r\n\r\nThe extension is available on the following stores :\\\r\n\\\r\n[![Firefox](https://files.catbox.moe/5g2ld5.png)](https://addons.mozilla.org/en-US/firefox/addon/ghunt-companion/) [![Chrome](https://storage.googleapis.com/web-dev-uploads/image/WlD8wC6g8khYWPJUsQceQkhXSlv1/UV4C4ybeBTsZt43U4xis.png)](https://chrome.google.com/webstore/detail/ghunt-companion/dpdcofblfbmmnikcbmmiakkclocadjab)\r\n\r\n## Modules\r\n\r\nThen, profit :\r\n```bash\r\nusage: ghunt [-h] {login,email,gaia,drive} ...\r\n\r\npositional arguments:\r\n {login,email,gaia,drive}\r\n login (--clean) Authenticate GHunt to Google.\r\n email (--json) Get information on an email address.\r\n gaia (--json) Get information on a Gaia ID.\r\n drive (--json) Get information on a Drive file or folder.\r\n\r\noptions:\r\n -h, --help show this help message and exit\r\n```\r\n\r\n\ud83d\udcc4 You can also use --json with email, gaia and drive modules to export in JSON ! Example :\r\n\r\n```bash\r\n$ ghunt email <email_address> --json user_data.json\r\n```\r\n\r\n**Have fun \ud83e\udd70\ud83d\udc9e**\r\n\r\n# \ud83e\uddd1\u200d\ud83d\udcbb Developers\r\n\r\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 !\r\n\r\nTo use GHunt as a lib, you can't use pipx because it uses a venv.\\\r\nSo you should install GHunt with pip :\r\n```bash\r\n$ pip3 install ghunt\r\n```\r\n\r\nAnd now, you should be able to `import ghunt` in your projects !\\\r\nYou can right now play with the [examples](https://github.com/mxrch/GHunt/tree/master/examples).\r\n\r\n# \ud83d\udcee Details\r\n\r\n## Obvious disclaimer\r\n\r\nThis tool is for educational purposes only, I am not responsible for its use.\r\n\r\n## Less obvious disclaimer\r\n\r\nThis project is under [AGPL Licence](https://choosealicense.com/licenses/agpl-3.0/), and you have to respect it.\\\r\n**Use it only in personal, criminal investigations, pentesting, or open-source projects.**\r\n\r\n## Thanks\r\n\r\n- [novitae](https://github.com/novitae) for being my Python colleague\r\n- All the people on [Malfrats Industries](https://discord.gg/sg2YcrC6x9) and elsewhere for the beta test !\r\n- The HideAndSec team \ud83d\udc97 (blog : https://hideandsec.sh)\r\n- [Med Amine Jouini](https://dribbble.com/jouiniamine) for his beautiful rework of the Google logo, which I was inspired by *a lot*.\r\n\r\n## Sponsors\r\n\r\nThanks to these awesome people for supporting me !\r\n\r\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/im-hanzou\"><img src=\"https://github.com/im-hanzou.png\" width=\"50px\" alt=\"im-hanzou\" /></a> <a href=\"https://github.com/gingeleski\"><img src=\"https://github.com/gingeleski.png\" width=\"50px\" alt=\"gingeleski\" /></a> <a href=\"https://github.com/ItsMalware\"><img src=\"https://github.com/ItsMalware.png\" width=\"50px\" alt=\"ItsMalware\" /></a> <!-- sponsors -->\r\n\r\n\\\r\nYou like my work ?\\\r\n[Sponsor me](https://github.com/sponsors/mxrch) on GitHub ! \ud83e\udd17\r\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "An offensive Google framework.",
"version": "2.1.6",
"project_urls": {
"Bug Reports": "https://github.com/mxrch/GHunt/issues",
"Funding": "https://github.com/sponsors/mxrch",
"Homepage": "https://github.com/mxrch/GHunt",
"Source": "https://github.com/mxrch/GHunt"
},
"split_keywords": [
"osint",
" pentest",
" cybersecurity",
" investigation",
" hideandsec",
" malfrats"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f94766c8f4e9979c91ae6f5c1e923cf9e68981850494117d9e1e9420714e707f",
"md5": "f09d97a8175ad87acdabc010d3b4059f",
"sha256": "39bf4c5c80d4858c4a7c9d66315a1eb86b64c440500da9e2d4226b89e6fe8843"
},
"downloads": -1,
"filename": "ghunt-2.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f09d97a8175ad87acdabc010d3b4059f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 85171,
"upload_time": "2024-04-05T18:43:01",
"upload_time_iso_8601": "2024-04-05T18:43:01.715806Z",
"url": "https://files.pythonhosted.org/packages/f9/47/66c8f4e9979c91ae6f5c1e923cf9e68981850494117d9e1e9420714e707f/ghunt-2.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-05 18:43:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mxrch",
"github_project": "GHunt",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "ghunt"
}