GitHub notifications

Description #

The GitHub widget displays the number of unread notifications you have on GitHub.

It uses the GitHub CLI to fetch the number of unread notifications. Make sure you have it installed and authenticated.

# Installs the GitHub CLI using Homebrew
brew install gh

# Authenticate with gh
gh auth login

Interactions #

You can click on the widget to open your GitHub notifications page in your default web browser.

Available settings #

You can set the following Music/iTunes widget settings in the simple-bar settings:

  • Refresh frequency: The refresh frequency in milliseconds. Default is 600000 (10 minutes).
  • Show on display: The displays on which the widget will be displayed. Add a list of indexes (for example: "1,2"). Leave blank to display the widget on every spaces. Default is "".
  • Show icon: Show or hide the icon. Default is true.
  • Hide widget when no notification: Hide the widget when there is no unread notification. Default is false.
  • The URL opened on click: The URL opened when clicking on the widget. **Default is "
  • Path to gh binary: The path to the gh binary. Default is "/opt/homebrew/bin/gh".
Something is wrong in this documentation? Please open an issue on GitHub in simple-bar repo.
Toggle documentation menu