Skip to main content

Auto-notify a friend when a new GitHub repo is created

Project description

GitHub Repo Notifier 🚀

A simple CLI tool to notify your friend via email whenever a new GitHub repository is created.

This tool fetches your GitHub repos using the API and compares them to the previous list. If a new repo is found, it automatically sends an email notification.


📦 Installation (after PyPI upload)

pip install repo-notifier

Or install locally:

git clone https://github.com/Priyanshu-1477/github-repo-notifier.git
cd github-repo-notifier
pip install .

🚀 Usage

Once installed, run:

repo-notifier

Make sure you have a .env file in the current directory with the following keys:

GITHUB_USERNAME=your_github_username
GITHUB_TOKEN=your_github_token
SENDER_EMAIL=your_email@gmail.com
APP_PASSWORD=your_app_password
RECEIVER_EMAIL=friend_email@gmail.com

🛠️ Features

Checks for new public repos on your GitHub account

Sends email to your friend when a new repo is created

Logs output with rich formatting

Can be scheduled using cron or systemd

🔐 Security

Secrets are handled via environment variables using a .env file and never hardcoded.

💡 Author

Made with ❤️ by Priyanshu Raj


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

repo_notifier-0.1.0.tar.gz (3.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

repo_notifier-0.1.0-py3-none-any.whl (3.5 kB view details)

Uploaded Python 3

File details

Details for the file repo_notifier-0.1.0.tar.gz.

File metadata

  • Download URL: repo_notifier-0.1.0.tar.gz
  • Upload date:
  • Size: 3.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for repo_notifier-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f2b2b94beb9321e912f60005c74e86c4f9823c3dca8c3790c90c7ffe4560a0c7
MD5 0d5d6ce8025eab81e71e55b465d76989
BLAKE2b-256 143c6f619b02d1a1a12fd17dcef3deca2cfe70359e16e2f42a9e4d8a392cd947

See more details on using hashes here.

File details

Details for the file repo_notifier-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: repo_notifier-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 3.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for repo_notifier-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e9ae2103bec1d9770cece5f2b2b5ee1b5ef6886f66080cf6a220c793ea70478e
MD5 2223ea000ee557a2432ffcf876562e98
BLAKE2b-256 5313c44927044043aa76361b0f3dbe22af10c7527b94cccb8a26b8386d77a5a7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page