Skip to content
Bash script that finds a GitHub user's email address based on username
Shell
Find file
Latest commit bc95149 May 8, 2014 @hodgesmr Merge pull request #10 from clue/errorcode
Return error code 1 if no email has been found
Failed to load latest commit information.
LICENSE
README.md
findGitHubEmail

README.md

FindGitHubEmail

Find the email address of any GitHub user

It's a well-known fact (or at least it should be) that everything you push to a public GitHub repository is public. This includes a lot of information other than just source files. Since both Git and GitHub require you to provide an email address, it should be no surprise that this information is public as well. FindGitHubEmail (catchy title, I know) is a simple script that queries the GitHub API and guesses a given user's email address based on their public activity. The script is a bit of a hack; sorry if your eyes are bleeding.

FindGitHubEmail makes it easy to get in contact with open source developers. Please use it for good, not evil.

Usage

Run this:

git clone https://github.com/hodgesmr/FindGitHubEmail.git ~/FindGitHubEmail
bash ~/FindGitHubEmail/findGitHubEmail hodgesmr

If you're not looking for me, replace hodgesmr with another GitHub user.

The above will return the best guess of the email based on the user's event log.

Print all emails in the user's event log: findGitHubEmail -e hodgesmr

Or cross-check the discovered emails with the user's Gravatar ID: findGitHubEmail -g hodgesmr

A Matt Hodges project

This project is maintained by @hodgesmr.

Something went wrong with that request. Please try again.