https://github.com/owenrumney/notibar
Simple menu bar to notify about GitHub notifications you're mentioned in
https://github.com/owenrumney/notibar
basic-app github notifications python rumps
Last synced: 3 months ago
JSON representation
Simple menu bar to notify about GitHub notifications you're mentioned in
- Host: GitHub
- URL: https://github.com/owenrumney/notibar
- Owner: owenrumney
- Created: 2025-05-01T08:49:16.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-06-19T08:04:06.000Z (4 months ago)
- Last Synced: 2025-07-04T07:46:35.264Z (3 months ago)
- Topics: basic-app, github, notifications, python, rumps
- Language: Python
- Homepage:
- Size: 541 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Notibar
Notibar is a macOS menu bar app that will alert you to any notifications you have that you're specifically participating in or mentioned in.
# Building
Notibar is built using Python and relies on the following libraries:
- [rumps](https://github.com/jaredks/rumps) - Simple Python library for macOS status bar apps
- `requests` - For making GitHub API calls
- `keyring` - For securely storing your GitHub token
To set up the development environment:
1. Clone the repository
2. Install the required dependencies:
```bash
pip install -r requirements.txt
```
You can now either run as `python notibar.py` or if you prefer to make it into an app using
```bash
make build # builds the app to dist
```
```bash
make install # builds that app to dist then copies to ~/Applications`
```
# Usage
## Prerequisites
You need to have a `GITHUB_TOKEN`, the only scope it needs is to read notifications.
## Configuration
1. Launch the app
2. Click the 📢 icon in the menu bar
3. Select "Settings"
4. Enter your GitHub token in the dialog box that appears
5. Click "Save"
## Features
- Shows a 📢 icon in the menu bar
- Displays notification count when you have unread notifications (e.g., "📢 (3)")
- Checks for new notifications every 5 minutes
- Only shows notifications where you are specifically mentioned or participating
- Click on any notification in the menu to view its details
- Settings option to update your GitHub token anytime
The app securely stores your GitHub token using the system keychain.
# Roadmap
I don't think much more will be done because its serving the purpose it was intended, I stop missing notifications.
- Add an icon
- Support marking notification as read
- Use more of the data from the notification in the menu item
- Add option to startup at login