Metadata-Version: 2.1
Name: stargazerz
Version: 0.0.2
Summary: Instantly Retrieve Email Addresses and Usernames of Stargazers from Designated Repositories, Achieving Unparalleled Speed and Efficiency - All Without the Need for an API Key
Home-page: https://github.com/Frikallo/stargazerz
Author: Noah Kay
Author-email: noahkay13@gmail.com
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: beautifulsoup4 ==4.12.2
Requires-Dist: bs4 ==0.0.1
Requires-Dist: requests ==2.31.0
Requires-Dist: tqdm ==4.66.1

<div align="center">

[![](./stargazerz/Assets/banner.png)](https://github.com/Frikallo/stargazerz)

[![PyPI](https://img.shields.io/pypi/v/stargazerz.svg?color=orange)](https://pypi.org/project/stargazerz/)
[![PyPI - Downloads](https://img.shields.io/pypi/dd/stargazerz?color=orange)](https://pypi.org/project/stargazerz/) 
[![License](https://img.shields.io/github/license/frikallo/stargazerz?color=orange)](https://github.com/Frikallo/MISST/blob/main/LICENSE) 
![GitHub code size](https://img.shields.io/github/languages/code-size/frikallo/stargazerz?color=orange)

</div>

---

###

Original Repository of stargazerz

This application uses state-of-the-art OSINT and webscraping techniques to find emails and usernames of people who have starred a GitHub repository without the need of authentication. This prjects is useful for developers looking to promote their projects or contact developers with similar interests.

This project is OpenSource, feel free to use, study and/or send pull request.

## Key Features

- **Fast**: stargazerz uses multithreading to scrape GitHub pages and find emails and usernames of stargazers.

- **Easy**: stargazerz is easy to use, just define the target repository and the number of threads and you are ready to go.

- **Powerful**: stargazerz uses state-of-the-art OSINT and webscraping techniques to find emails and usernames of stargazers.

- **Customizable**: stargazerz allows you to save the results to a file and choose which results to save.

- **Free**: stargazerz is free and open-source.

## Installation

You can install stargazerz using `pip`:

```shell
pip install stargazerz
```

## Usage
```python
import stargazerz

# Define Crawler
crawler = stargazerz.Crawler(threads=16, target="Frikallo/stargazerz")

# Run Crawler
crawler.run()

# Get Results after Crawler is done
crawler.print_results()

# Save results to file
crawler.save_results("emails", "emails.txt")
crawler.save_results("stargazers", "stargazers.txt")
crawler.save_results("all", "all.txt")
```

## Example Output
```shell
$ python3 stargazerz-example.py
[+] Target: Frikallo/stargazerz
[+] Threads: 16
[+] Starting crawler
[+] Crawler started
[+] Fetching page 1 of stargazers for Frikallo/stargazerz
[+] Fetching page 2 of stargazers for Frikallo/stargazerz
[+] Found 34 stargazers
[+] Fetching emails
Complete ✅: 100%|███████████████| 34/34 [00:18<00:00,  1.40stargazers/s]
[+] Crawler finished
[+] Time: 19.92 seconds
[-] Results
[+] Stargazers: 34
[+] Emails: 26
[+] Emails saved to emails.txt
[+] Stargazers saved to stargazers.txt
[+] All results saved to all.txt
```

