A simple macOS menu bar application that displays your GitHub notifications.
- Sign in with your GitHub account
- Display unread notifications count in the menu bar
- Show native macOS notifications for new GitHub notifications
- Quick access to open GitHub notifications in your browser
- Auto-refresh notifications every minute
- Clone this repository:
git clone https://github.com/estevaoam/gitmenu.git
cd gitmenu- Create a virtual environment and install dependencies:
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt- Build the application:
# Remove existing dist and build folders
rm -rf dist/ build/
# Build the application
python setup.py py2app -a- The application will be available in the
distfolder. You can move it to your Applications folder:
mv dist/GitMenu.app /Applications/Or you can initialize directly from the shell:
./dist/GitMenu.app/Contents/MacOS/GitMenu- Launch the application from your Applications folder
- Click on the menu bar icon and select "Sign in with GitHub"
- Create a new GitHub access token with the "notifications" scope
- Copy and paste the token into the application when prompted
- The application will start monitoring your GitHub notifications
- 📭 No unread notifications
- 📫 Unread notifications (with count)
⚠️ Error state
The GitHub access token is stored in ~/.gitmenu_config.json. You can delete this file to reset the application.