xfce4 GitHub notifications plugin

This repository offers a script, which reads your GitHub Notifications using GitHub API and presents them on Xfce panel using xfce4-genmon-plugin.

To save some API calls, script uses xprintidle to detect if you are idle and sets idle icon on the panel.

Screenshots

When you have some unread notications:

And when there is no notifcations:

Installation

Copy the script to your PATH, for example to ~/.local/bin:

mkdir -p ~/.local/bin
cp github-status ~/.local/bin/

Configuration

Status script use GitHub CLI credentials to talk to GitHub API, so follow https://cli.github.com/manual/gh_auth_login to configure it.

Alternatively, you can create the configuration file yourself:

mkdir -p ~/.config/gh/
cat <<EOF > ~/.config/gh/config.yml
hosts:
    github.com:
        oauth_token: <token>
        user: <username>
EOF

Adding to Panel

Add new xfce4-genmon-plugin to your panel and configure it to run the following command:

.local/bin/github-status