| Name | gitfive JSON |
| Version |
1.1.9
JSON |
| download |
| home_page | None |
| Summary | Track down GitHub users. |
| upload_time | 2024-10-02 01:49:19 |
| maintainer | None |
| docs_url | None |
| author | mxrch |
| requires_python | <4.0,>=3.11 |
| license | MPL-2.0 |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<br>
#### 🐍 Now Python 3.13 compatible !
# Description
GitFive is an OSINT tool to investigate GitHub profiles.
Main features :
- Usernames / names history
- Usernames / names variations
- Email address to GitHub account
- Find GitHub's accounts from a list of email addresses
- Lists identities used by the target
- Clones and analyze every target's repos
- Highlights emails tied to GitHub's target account
- Finds local identities (UPNs, ex : jeanpierre@My-Computer.local)
- Finds potential secondary GitHub accounts
- Don't need repos to work (but better)
- Generates every possible email address combinations and looks for matchs
- Dumps SSH public keys
- JSON export
Optimizations :
- Very low API consumption, stays under the rate-limit
- Multi-processing tasks (bypassing Python's GIL)
- Async scraping
# Workflow
**Click [here](https://raw.githubusercontent.com/mxrch/GitFive/master/assets/workflow.png) for a full view**
<br>
# Requirements
- Git
- Python >= 3.10
# Installation
```bash
$ pip3 install pipx
$ pipx ensurepath
$ pipx install gitfive
```
It will automatically use venvs to avoid dependency conflicts with other projects.
# Usage
First, login to GitHub *(preferably with a secondary account)* :
```bash
$ gitfive login
```
Then, profit :
```bash
usage: gitfive [-h] {login,user,email,emails,light} ...
positional arguments:
{login,user,email,emails,light}
login Let GitFive authenticate to GitHub.
user Track down a GitHub user by its username.
email Track down a GitHub user by its email address.
emails Find GitHub usernames of a given list of email addresses.
light Quickly find emails addresses from a GitHub username.
options:
-h, --help show this help message and exit
```
*PS : plz avoid testing on torvalds or other authors of repos with 1 million commits*
📄 You can also use --json with user and email modules to export in JSON ! Example :
```bash
$ gitfive user mxrch --json mxrch_data.json
```
**Have fun 🥰💞**
## Video demo
https://github.com/mxrch/GitFive/assets/17338428/28a22d30-f651-483f-84e8-7fc6e00b831f
## Obvious disclaimer
This tool is for educational purposes only, I am not responsible for its use.
### Less obvious disclaimer
The use of this tool in an automated paid service / software is strictly forbidden without my personal agreement.\
Please use it only in personal, criminal investigations, or open-source projects.
## Thanks
- [novitae](https://github.com/novitae) for being my Python colleague
- [rayanlecat](https://twitter.com/rayanlecat), [ABH](https://twitter.com/ABHsec), [22sh](https://twitter.com/0x22sh), [BlackWasp](https://twitter.com/BlWasp_), [Tartofraise](https://twitter.com/_Tartofraise), [mpgn](https://twitter.com/mpgn_x64), [M3SS](https://twitter.com/0x4D335353) and [n1nj4sec](https://twitter.com/n1nj4sec) for the beta test
- The HideAndSec team 💗 (blog : https://hideandsec.sh)
## 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": "gitfive",
"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\n\n#### \ud83d\udc0d Now Python 3.13 compatible !\n\n# Description\n\nGitFive is an OSINT tool to investigate GitHub profiles.\n\nMain features :\n- Usernames / names history\n- Usernames / names variations\n- Email address to GitHub account\n- Find GitHub's accounts from a list of email addresses\n- Lists identities used by the target\n- Clones and analyze every target's repos\n- Highlights emails tied to GitHub's target account\n- Finds local identities (UPNs, ex : jeanpierre@My-Computer.local)\n- Finds potential secondary GitHub accounts\n- Don't need repos to work (but better)\n- Generates every possible email address combinations and looks for matchs\n- Dumps SSH public keys\n- JSON export\n\nOptimizations :\n- Very low API consumption, stays under the rate-limit\n- Multi-processing tasks (bypassing Python's GIL)\n- Async scraping\n\n# Workflow\n**Click [here](https://raw.githubusercontent.com/mxrch/GitFive/master/assets/workflow.png) for a full view**\n\n<br>\n\n\n\n# Requirements\n- Git\n- Python >= 3.10\n\n# Installation\n\n```bash\n$ pip3 install pipx\n$ pipx ensurepath\n$ pipx install gitfive\n```\nIt will automatically use venvs to avoid dependency conflicts with other projects.\n\n# Usage\nFirst, login to GitHub *(preferably with a secondary account)* :\n```bash\n$ gitfive login\n```\n\nThen, profit :\n```bash\nusage: gitfive [-h] {login,user,email,emails,light} ...\n\npositional arguments:\n {login,user,email,emails,light}\n login Let GitFive authenticate to GitHub.\n user Track down a GitHub user by its username.\n email Track down a GitHub user by its email address.\n emails Find GitHub usernames of a given list of email addresses.\n light Quickly find emails addresses from a GitHub username.\n\noptions:\n -h, --help show this help message and exit\n```\n\n\n*PS : plz avoid testing on torvalds or other authors of repos with 1 million commits*\n\n\ud83d\udcc4 You can also use --json with user and email modules to export in JSON ! Example :\n\n```bash\n$ gitfive user mxrch --json mxrch_data.json\n```\n\n**Have fun \ud83e\udd70\ud83d\udc9e**\n\n## Video demo\n\nhttps://github.com/mxrch/GitFive/assets/17338428/28a22d30-f651-483f-84e8-7fc6e00b831f\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\nThe use of this tool in an automated paid service / software is strictly forbidden without my personal agreement.\\\nPlease use it only in personal, criminal investigations, or open-source projects.\n\n## Thanks\n\n- [novitae](https://github.com/novitae) for being my Python colleague\n- [rayanlecat](https://twitter.com/rayanlecat), [ABH](https://twitter.com/ABHsec), [22sh](https://twitter.com/0x22sh), [BlackWasp](https://twitter.com/BlWasp_), [Tartofraise](https://twitter.com/_Tartofraise), [mpgn](https://twitter.com/mpgn_x64), [M3SS](https://twitter.com/0x4D335353) and [n1nj4sec](https://twitter.com/n1nj4sec) for the beta test\n- The HideAndSec team \ud83d\udc97 (blog : https://hideandsec.sh)\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/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 -->\n\n\\\nYou like my work ?\\\n[Sponsor me](https://github.com/sponsors/mxrch) on GitHub ! \ud83e\udd17\n\n",
"bugtrack_url": null,
"license": "MPL-2.0",
"summary": "Track down GitHub users.",
"version": "1.1.9",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bc21108207ff5c4147e841c9b793cb2f9e746cf450feeddf8c21b59db940585d",
"md5": "7c14363064d44ca6b268bb62fa44c9f1",
"sha256": "1b74ecdbe12a87b13a3db081b5201f35e3696412a9c5278b9336b0d8a891e629"
},
"downloads": -1,
"filename": "gitfive-1.1.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7c14363064d44ca6b268bb62fa44c9f1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 46722,
"upload_time": "2024-10-02T01:49:19",
"upload_time_iso_8601": "2024-10-02T01:49:19.767049Z",
"url": "https://files.pythonhosted.org/packages/bc/21/108207ff5c4147e841c9b793cb2f9e746cf450feeddf8c21b59db940585d/gitfive-1.1.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-02 01:49:19",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "gitfive"
}
