Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hari7261/gitprofile-search

GitHub Profile Finder is a sleek desktop app built with Python and CustomTkinter that allows you to search and view detailed GitHub user profiles. Instantly fetch bio, repos, followers, and more in a modern, dark-themed UI!
https://github.com/hari7261/gitprofile-search

coustomtkinter dark-mode git github-profile-finder gui hari7261 python python3 requests tinker

Last synced: 13 days ago
JSON representation

GitHub Profile Finder is a sleek desktop app built with Python and CustomTkinter that allows you to search and view detailed GitHub user profiles. Instantly fetch bio, repos, followers, and more in a modern, dark-themed UI!

Awesome Lists containing this project

README

        

# πŸš€ GitHub Profile Finder πŸ”

Welcome to **GitHub Profile Finder**, a simple yet powerful desktop application built with **Python** and **Tkinter** to quickly search and retrieve any GitHub user's profile details. This app is designed with a modern and sleek user interface using **CustomTkinter** and can be used to explore GitHub user profiles in style.✨


Python version
CustomTkinter
Status

---

## 🌟 Features

- πŸ” **Search by Username**: Enter any GitHub username to retrieve profile details.
- πŸ–ΌοΈ **Profile Picture**: Displays the profile picture of the user.
- πŸ“œ **Detailed Profile Info**: Retrieves the user’s bio, location, repositories, followers, and more.
- 🌐 **Clickable GitHub Profile Link**: Open the user’s GitHub page directly from the app.
- πŸ•’ **Joined Date**: Format and display when the user joined GitHub.
- 🎨 **Dark Mode UI**: Enjoy a beautiful dark-themed user interface using CustomTkinter.
- πŸ“œ **Scrollable View**: See all the details without clutter using a smooth scrollable frame.

---

## πŸ“‹ Tech Stack

| Technology | Description |
|-------------------|------------------------------------|
| **Python** 🐍 | Core language of the project |
| **Tkinter** πŸ“¦ | GUI framework for Python |
| **CustomTkinter** 🎨 | Modern dark mode widgets and styling |
| **Requests** 🌐 | Fetches user data from the GitHub API |
| **Pillow** πŸ–ΌοΈ | Handles image processing for profile pictures |

---

## πŸš€ How to Run

1. **Clone the repository**:
```bash
git clone https://github.com/yourusername/github-profile-finder.git
cd github-profile-finder
```

2. **Install required dependencies**:
```bash
pip install -r requirements.txt
```

3. **Run the app**:
```bash
python github_profile_finder.py
```

---

## πŸ–ΌοΈ Screenshots

### Main Window:
![Main Window](/github/gitfinder%20(2).png)
*Search interface with a smooth dark-themed UI.*

### Profile Example:
![Profile Example](/github/gitfinder%20(1).png)
*User profile details fetched from the GitHub API.*

---

## 🚧 Future Enhancements

- πŸ” **Authentication**: Add GitHub OAuth to get private profile details.
- πŸ“Š **Advanced Stats**: Display charts of user activity, repositories, and contributions.
- πŸ—£οΈ **Social Sharing**: Add options to share GitHub profiles on social media.

---

## ❀️ Contributing

Feel free to fork this repository, make some improvements, and submit a pull request. Contributions are always welcome! πŸ™Œ

---

## πŸ› οΈ Dependencies

Make sure you have the following libraries installed:

- **CustomTkinter**
- **Requests**
- **Pillow**

You can install them with:
```bash
pip install customtkinter requests pillow
```

---

## πŸ“§ Contact

Created with ❀️ by **[@hari7261](https://github.com/hari7261)**.
Feel free to reach out for any queries, suggestions, or collaborations!

---

Enjoy exploring GitHub profiles effortlessly! πŸ˜ŽπŸŽ‰

---