{"id":22645543,"url":"https://github.com/mcgillij/py3status-github-notifications","last_synced_at":"2025-04-12T00:33:56.085Z","repository":{"id":62578500,"uuid":"346222349","full_name":"mcgillij/py3status-github-notifications","owner":"mcgillij","description":"py3status module to display your github notifications","archived":false,"fork":false,"pushed_at":"2024-12-23T04:42:28.000Z","size":364,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-11T09:58:26.430Z","etag":null,"topics":["github","notifications","py3status","python"],"latest_commit_sha":null,"homepage":"","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/mcgillij.png","metadata":{"files":{"readme":"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":"2021-03-10T03:43:02.000Z","updated_at":"2025-02-23T02:18:29.000Z","dependencies_parsed_at":"2024-12-09T06:06:34.472Z","dependency_job_id":"b90714e5-ae5c-4eb0-94e4-b2de92bb5505","html_url":"https://github.com/mcgillij/py3status-github-notifications","commit_stats":{"total_commits":18,"total_committers":2,"mean_commits":9.0,"dds":0.05555555555555558,"last_synced_commit":"8ed792abd1d1ccb0333a63e4ad7f66660a90c622"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcgillij%2Fpy3status-github-notifications","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcgillij%2Fpy3status-github-notifications/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcgillij%2Fpy3status-github-notifications/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcgillij%2Fpy3status-github-notifications/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mcgillij","download_url":"https://codeload.github.com/mcgillij/py3status-github-notifications/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248501696,"owners_count":21114676,"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":["github","notifications","py3status","python"],"created_at":"2024-12-09T06:06:25.614Z","updated_at":"2025-04-12T00:33:56.058Z","avatar_url":"https://github.com/mcgillij.png","language":"Python","readme":"# py3status-github-notifications\npy3status module for showing your Github notifications in i3\n\n[![Downloads](https://static.pepy.tech/personalized-badge/py3status-github-notifications?period=total\u0026units=international_system\u0026left_color=blue\u0026right_color=green\u0026left_text=Downloads)](https://pepy.tech/project/py3status-github-notifications)\n\n## Screenshot\n![Status Bar with py3status-github-notifications](https://raw.githubusercontent.com/mcgillij/py3status-github-notifications/main/images/github_notifications.png)\n![Status Bar with py3status-github-notifications red](https://raw.githubusercontent.com/mcgillij/py3status-github-notifications/main/images/notifications_red.png)\n## Prerequisites\n\n* [i3wm](https://i3wm.org/)\n* [py3status](https://github.com/ultrabug/py3status)\n* [pygithub](https://github.com/PyGithub/PyGithub)\n* Notification API token from Github\n* [Awesome Terminal Fonts](https://github.com/gabrielelana/awesome-terminal-fonts)\n\n## Getting your Notification API Token\n\nYou can get this directly on Github, by going to your own *Account settings*, *Developer Settings* and finally **Personal access tokens**.\n\nMake sure to limit the access to **ONLY** notifications.\n\n![notifications only](https://raw.githubusercontent.com/mcgillij/py3status-github-notifications/main/images/notifications_only.png)\n\n## Installation\nThere are several methods to install py3status-github-notifications.\n\nDirectly from Github using git, pip / pipenv or poetry, the AUR (Arch package).\n\n### Direct From Github\n\nInstalling directly from Github with git, means you will need to make sure you have the dependencies already installed.\n\n``` bash\ngit clone git@github.com:mcgillij/py3status-github-notifications.git\nmkdir -p ~/.i3/py3status/ \u0026\u0026 cd ~/i3/py3status/\nln -s ../../py3status-github-notifications/src/py3status_github_notifications/github_notifications.py ./\n```\nAnd down to the configuration section.\n\n### Installing with Pip, Pipenv or Poetry\n\nYou will need to install the fonts separately to get the :octocat: emoji.\n\n``` bash\npip install py3status-github-notifications\npipenv install py3status-github-notifications\npoetry add py3status-github-notifications\n```\n\n### With `yay`\n``` bash\nyay -S py3status-github-notifications\n```\n\n## Configuration\n\nOnce you have the module installed using whichever method you chose above, edit your py3status configuration and add the following options.\n\n**~/.config/i3/i3status.conf**\n\n``` bash\n...\n\norder += \"github_notifications\"\n\ngithub_notifications {\n    gh_token = \"PASTE YOUR NOTIFICATIONS ONLY TOKEN HERE\"\n    on_click 1 = \"exec xdg-open https://github.com/notifications\"$\n}\n...\n\n```\nAnd restart **i3** and your should be good to go.\n\n## Configuration Options\n\nYou can pass in the following configuration options:\n\n* cache_timeout # default 300\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcgillij%2Fpy3status-github-notifications","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcgillij%2Fpy3status-github-notifications","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcgillij%2Fpy3status-github-notifications/lists"}