Giggity: GitHub OSINT Reconnaissance Tool
Friday, January 18, 2019
2-minute read
Giggity is a tool for gathering openly available information about GitHub organizations, users, and repositories. It stores all data in a JSON file organized in a tree of dictionaries for easy analysis or database transfer.
Installation
pip3 install giggity
Or clone the repository:
pip3 install -r requirements.txt
Usage
giggity.py [-h] [-v] [-a] [-u] [-o] [-O OUTPUT] path
positional arguments:
path name of organization or user (or url of repository)
optional arguments:
-h, --help show this help message and exit
-v, --verbose increase output verbosity
-a, --authenticate allows github authentication to avoid ratelimiting
-u, --user denotes that given input is a user
-o, --org denotes that given input is an organization
-O OUTPUT, --outfile OUTPUT
location to put generated json file
Scraping a User
python3 giggity.py -a -O needmorecowbell.json -v -u needmorecowbell
This will authenticate, scrape the user needmorecowbell, and output to needmorecowbell.json.
Scraping an Organization
python3 giggity.py -a -o github -O github.json
Scrape the GitHub organization and output results.
Using as a Module
Giggity can also be used programmatically:
from giggity import giggity
g = giggity("username", "password")
data = g.getUsers("organization-name", followers=True)
print("List of users in organization: ")
for user, info in data.items():
print(user)
data = g.getEmails("username", verbose=True) # Get any emails found
Example Output
When running python3 giggity.py -a -u geohot -O output.json:
{
"emails": [
"george@comma.ai"
],
"names": [
"Charles Ellis",
"George Hotz"
],
"repos": {
"ORB_SLAM2": {
"created_at": "2017-04-08T00:21:13Z",
"description": "ORBSLAM2 running on Mac OS X",
"fork": true,
"name": "ORB_SLAM2",
"updated_at": "2018-10-22T23:51:28Z",
"url": "https://github.com/geohot/ORB_SLAM2"
}
}
}
Note on API Versions
GitHub API still supports v3 (what this script uses), however they are making the shift to GraphQL in v4. Authentication is highly recommended to avoid rate limiting.
Check out the project on GitHub.