Metadata-Version: 2.1
Name: py3status-github-notifications
Version: 0.1.4
Summary: py3status module to show your Github notifications
Home-page: https://github.com/mcgillij/py3status-github-notifications
License: MIT
Keywords: github,notifications,py3status,i3,git
Author: mcgillij
Author-email: mcgillivray.jason@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Desktop Environment :: Window Managers
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Topic :: System :: Monitoring
Requires-Dist: PyGithub (>=1.55,<2.0)
Requires-Dist: PyJWT (==2.2.0)
Requires-Dist: py3status (>=3.36,<4.0)
Project-URL: Documentation, https://github.com/mcgillij/py3status-github-notifications
Project-URL: Repository, https://github.com/mcgillij/py3status-github-notifications
Description-Content-Type: text/markdown

# py3status-github-notifications
py3status module for showing your Github notifications in i3

[![Downloads](https://static.pepy.tech/personalized-badge/py3status-github-notifications?period=total&units=international_system&left_color=blue&right_color=green&left_text=Downloads)](https://pepy.tech/project/py3status-github-notifications)

## Screenshot
![Status Bar with py3status-github-notifications](https://raw.githubusercontent.com/mcgillij/py3status-github-notifications/main/images/github_notifications.png)
![Status Bar with py3status-github-notifications red](https://raw.githubusercontent.com/mcgillij/py3status-github-notifications/main/images/notifications_red.png)
## Prerequisites

* [i3wm](https://i3wm.org/)
* [py3status](https://github.com/ultrabug/py3status)
* [pygithub](https://github.com/PyGithub/PyGithub)
* Notification API token from Github
* [Awesome Terminal Fonts](https://github.com/gabrielelana/awesome-terminal-fonts)

## Getting your Notification API Token

You can get this directly on Github, by going to your own *Account settings*, *Developer Settings* and finally **Personal access tokens**.

Make sure to limit the access to **ONLY** notifications.

![notifications only](https://raw.githubusercontent.com/mcgillij/py3status-github-notifications/main/images/notifications_only.png)

## Installation
There are several methods to install py3status-github-notifications.

Directly from Github using git, pip / pipenv or poetry, the AUR (Arch package).

### Direct From Github

Installing directly from Github with git, means you will need to make sure you have the dependencies already installed.

``` bash
git clone git@github.com:mcgillij/py3status-github-notifications.git
mkdir -p ~/.i3/py3status/ && cd ~/i3/py3status/
ln -s ../../py3status-github-notifications/src/py3status_github_notifications/github_notifications.py ./
```
And down to the configuration section.

### Installing with Pip, Pipenv or Poetry

You will need to install the fonts separately to get the :octocat: emoji.

``` bash
pip install py3status-github-notifications
pipenv install py3status-github-notifications
poetry add py3status-github-notifications
```

### With `yay`
``` bash
yay -S py3status-github-notifications
```

## Configuration

Once you have the module installed using whichever method you chose above, edit your py3status configuration and add the following options.

**~/.config/i3/i3status.conf**

``` bash
...

order += "github_notifications"

github_notifications {
    gh_token = "PASTE YOUR NOTIFICATIONS ONLY TOKEN HERE"
    on_click 1 = "exec xdg-open https://github.com/notifications"$
}
...

```
And restart **i3** and your should be good to go.

## Configuration Options

You can pass in the following configuration options:

* cache_timeout # default 300

