{"id":21508567,"url":"https://github.com/bytexenon/github-desktop-notifier","last_synced_at":"2025-07-21T11:35:55.348Z","repository":{"id":262891478,"uuid":"888615932","full_name":"bytexenon/Github-Desktop-Notifier","owner":"bytexenon","description":"🔔 Receive instant GitHub notifications on your Linux desktop","archived":false,"fork":false,"pushed_at":"2024-11-16T22:16:52.000Z","size":47,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-14T12:17:36.425Z","etag":null,"topics":["cli","daemon","desktop-notifications","desktop-notifier","dunst","github","github-api","github-integration","github-notifications","notification-daemon","notifications","notifier","productivity","xfce4-notifications"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/github-desktop-notifier/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bytexenon.png","metadata":{"files":{"readme":"docs/README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-14T17:49:13.000Z","updated_at":"2025-05-01T09:21:58.000Z","dependencies_parsed_at":"2024-11-14T21:32:54.100Z","dependency_job_id":"93b66d81-a903-4455-8f97-11001a2fd136","html_url":"https://github.com/bytexenon/Github-Desktop-Notifier","commit_stats":null,"previous_names":["bytexenon/github-desktop-notifier"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/bytexenon/Github-Desktop-Notifier","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytexenon%2FGithub-Desktop-Notifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytexenon%2FGithub-Desktop-Notifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytexenon%2FGithub-Desktop-Notifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytexenon%2FGithub-Desktop-Notifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bytexenon","download_url":"https://codeload.github.com/bytexenon/Github-Desktop-Notifier/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytexenon%2FGithub-Desktop-Notifier/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266292479,"owners_count":23906512,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","daemon","desktop-notifications","desktop-notifier","dunst","github","github-api","github-integration","github-notifications","notification-daemon","notifications","notifier","productivity","xfce4-notifications"],"created_at":"2024-11-23T21:06:37.684Z","updated_at":"2025-07-21T11:35:55.300Z","avatar_url":"https://github.com/bytexenon.png","language":"Python","readme":"# GitHub Desktop Notifier\n\n[![License](https://img.shields.io/github/license/bytexenon/Github-Desktop-Notifier)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/bytexenon/Github-Desktop-Notifier)](https://github.com/bytexenon/Github-Desktop-Notifier/stargazers)\n\n**GitHub Desktop Notifier** is an easy-to-use Python script that sends you a desktop notification whenever you receive a notification on GitHub. Stay updated with your GitHub activities without constantly checking your email or GitHub dashboard. Get instant desktop notifications for new issues, pull requests, comments, and more.\n\n## Features\n\n- **Real-time Notifications**: Receive instant desktop alerts for new GitHub activities.\n- **Interactive Actions**: Open notifications in your browser or mark them as read directly from the notification popup.\n- **Supports All Notification Types**: Get notifications for issues, pull requests, comments, and more.\n- **Easy to Use**: Simply run the script and authenticate with GitHub via browser to start receiving notifications, no need to create GitHub API tokens.\n\n## Preview\n\n![GitHub Desktop Notifier Preview](https://github.com/user-attachments/assets/63951238-ec37-433d-9ec2-aad393e6442e)\n\n## Getting Started\n\n### Prerequisites\n\nBefore you begin, ensure you have the following installed:\n\n- **Python 3**: The script is written in Python and requires Python 3 to run.\n- **libnotify-bin**: Enables desktop notifications on Linux systems.\n- **GitHub CLI (`gh`)**: Allows the script to interact with GitHub.\n- **Pipx**: Used to install Python packages globally.\n\n### Installation\n\n1. **Install required packages on Debian/Ubuntu:**\n\n```bash\nsudo apt update\nsudo apt install -y python3 libnotify-bin gh pipx\n```\n\n2. **Install GitHub Desktop Notifier:**\n\n```bash\npipx install github-desktop-notifier\n```\n\n### Usage\n\nUsing GitHub Desktop Notifier is simple. Just run the following command in your terminal:\n\n```bash\ngithub-notifier\n```\n\n### Command-Line Options\n\nYou can customize the behavior of the notifier using the following command-line options:\n\n```console\n$ github-notifier --help\nusage: github-notifier [-h] [--refresh-rate REFRESH_RATE] [--timeout TIMEOUT]\n                       [--urgency {low,normal,critical}] [--icon-path ICON_PATH]\n\nGitHub Desktop Notifier\n\noptions:\n  -h, --help            show this help message and exit\n  --refresh-rate REFRESH_RATE\n                        Interval in seconds to check for new notifications (default:\n                        10)\n  --timeout TIMEOUT     Timeout in seconds for the notification (default: 15).\n                        Ignored if urgency is 'critical'.\n  --urgency {low,normal,critical}\n                        Urgency level of the notification: 'low', 'normal', or\n                        'critical' (default: critical)\n  --icon-path ICON_PATH\n                        Path to the icon to display in the notification (default:\n                        /path/to/github-logo.png)\n```\n\n- If you haven't authenticated with `gh` (GitHub CLI), you'll be prompted to do so. Follow the instructions to authenticate via your web browser.\n- After authenticating, the script will run in the background and send you desktop notifications for new GitHub activities.\n\n**That's it!** You'll now receive desktop notifications for new GitHub activities. Click on the notification buttons to open the notification in your browser or mark it as read.\n\n## License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](https://github.com/bytexenon/Github-Desktop-Notifier/blob/main/LICENSE) file for details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytexenon%2Fgithub-desktop-notifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbytexenon%2Fgithub-desktop-notifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytexenon%2Fgithub-desktop-notifier/lists"}