{"id":29979585,"url":"https://github.com/reginald-gillespie/gitsniff","last_synced_at":"2025-08-04T13:06:43.416Z","repository":{"id":305914519,"uuid":"1024366805","full_name":"Reginald-Gillespie/GitSniff","owner":"Reginald-Gillespie","description":"GitSniff is an OSINT tool designed to extract emails from metadata on GitHub accounts and repos.","archived":false,"fork":false,"pushed_at":"2025-08-04T03:13:16.000Z","size":47,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-04T03:30:04.686Z","etag":null,"topics":["email","email-osint","github","github-osint","information-gathering","osint","osint-python","osint-reconnaissance","osint-tool","osint-tools","scanner"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Reginald-Gillespie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-22T15:30:19.000Z","updated_at":"2025-08-04T03:13:19.000Z","dependencies_parsed_at":"2025-07-22T17:38:44.958Z","dependency_job_id":"df668718-ee7a-4377-961a-1037640a873e","html_url":"https://github.com/Reginald-Gillespie/GitSniff","commit_stats":null,"previous_names":["reginald-gillespie/gitsniff"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Reginald-Gillespie/GitSniff","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Reginald-Gillespie%2FGitSniff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Reginald-Gillespie%2FGitSniff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Reginald-Gillespie%2FGitSniff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Reginald-Gillespie%2FGitSniff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Reginald-Gillespie","download_url":"https://codeload.github.com/Reginald-Gillespie/GitSniff/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Reginald-Gillespie%2FGitSniff/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268699276,"owners_count":24292445,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-04T02:00:09.867Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["email","email-osint","github","github-osint","information-gathering","osint","osint-python","osint-reconnaissance","osint-tool","osint-tools","scanner"],"created_at":"2025-08-04T13:06:42.580Z","updated_at":"2025-08-04T13:06:43.407Z","avatar_url":"https://github.com/Reginald-Gillespie.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![License](https://img.shields.io/badge/license-MIT-green.svg)\n![GitHub stars](https://img.shields.io/github/stars/Reginald-Gillespie/GitSniff.svg)\n\n# GitSniff\nGitSniff is an MIT licensed OSINT tool designed to extract emails from metadata on GitHub accounts and repos. \nI built this because all the other similar tools were too limited or broke years ago.\n\n\n## Features\n- Find emails in github repo metadata.\n- Find emails from GitHub's user event feed\n- Outputs results as a table or JSON\n\n## Install\n```bash\npip install gitsniff\n```\n\n## Usage\n```bash\n# Scan a user.\ngitsniff -u \u003cusername\u003e\n\n# Scan a single repo.\ngitsniff -r \u003crepo\u003e\n\n# Show full help pages.\ngitsniff -h\n```\n\n![GitSniff Scan Results](results.png)\n\nThe email, `reginaldgillespie@protonmail.com`, is my email. The rest are the emails of other users found in my repositories because they contributed to them using their real emails.\n\n\n### Full Help Page\n```\n$ gitsniff -h\nusage: gitsniff [-h] (-u USERNAME | -r OWNER/REPO) [--no-repos] [--no-events] [-f] [--private] [--max-commits N] [--start-index N] [--max-repos N] [--max-events N] [-t TOKEN] [--token-file FILE] [-p URL] [-j]\n\nGitSniff - GitHub Email Scanner for OSINT\n\noptions:\n  -h, --help            Show this help message and exit\n\nTarget Selection (required):\n  -u, --user USERNAME   Scan GitHub user or organization\n  -r, --repo OWNER/REPO\n                        Scan single repository\n\nScanning Methods:\n  --no-repos            Disable repository cloning scan\n  --no-events           Disable public event API scan\n\nRepository Options:\n  -f, --forks           Include forked repositories\n  --private             Include private repositories (requires token)\n  --max-commits N       Max commits per repository (default: 1000)\n  --start-index N       Start repo scan from index N (default: 0)\n  --max-repos N         Maximum repositories to scan\n\nEvent Options:\n  --max-events N        Max public events to scan (default: 1000)\n\nConnection \u0026 Output:\n  -t, --token TOKEN     GitHub personal access token\n  --token-file FILE     Path to token file (default: pat.env)\n  -p, --proxy URL       HTTP/SOCKS proxy URL\n  -j, --json            Output in JSON format\n\nExamples:\n  gitsniff -u username                     # Scan user's repositories and events\n  gitsniff -u username --no-events         # Scan only repositories\n  gitsniff -u username --no-repos          # Scan only public events\n  gitsniff -r owner/repo                   # Scan specific repository\n  gitsniff -u username -f --max-repos 5    # Include forks, limit to 5 repos\n  gitsniff -u username --private -t TOKEN  # Include private repos with token\n```\n\n\n---\n\u003cbr\u003e\n\nThis project was inspired by similar, but more limited projects such as:\n- [GONZOsint/gitrecon](https://github.com/GONZOsint/gitrecon) - scans event feeds for information.\n- [chm0dx/gitSome](https://github.com/chm0dx/gitSome) - scans single repositories.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freginald-gillespie%2Fgitsniff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freginald-gillespie%2Fgitsniff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freginald-gillespie%2Fgitsniff/lists"}