GitHub Monitor
A lightweight background utility for the Linux system tray that polls your public and private repositories via the GitHub GraphQL API and shows, at a glance, how many pull requests and unanswered issues need your attention.
Key Features
At-a-glance repository monitoringSystem Tray Centric
A single icon with a badge counter. Left click refreshes immediately, right click opens a per-repository menu.
Pull Requests & Issues
Every open pull request, plus every open issue whose last comment does not come from a maintainer.
Public & Private Repos
Works with any repository your token can read, using a classic token or a read-only fine-grained one.
Desktop Notifications
A notification is shown whenever new pending items appear since the previous check.
Theme-Aware Icon
The GitHub logo is repainted with your theme's text colour at runtime, with an orange or red status badge.
Translated Interface
English source strings with gettext catalogs. The language follows your system locale; Spanish is included.
Reading the Icon
| Icon | Meaning |
|---|---|
| Semi-transparent logo | First check in progress. |
| Logo without badge | All clear. |
| Orange badge with a number | Total pending pull requests and issues (99+ above 99). |
| Red badge | Some repository failed in the last check; shows the pending count, or ! if there is none. |
Documentation
Architecture, attention rules & setup guidesArchitecture & Design
Module layout, the Qt main thread versus the polling thread, and how results flow back into the UI.
Attention Rules
The GraphQL queries, pagination, and the rule that decides whether an issue is waiting for a reply.
Tray Icon & Notifications
Icon rendering, badge states, tooltip, context menu, click behaviour and new-item notifications.
Configuration
Reference for config.toml: token, repositories, maintainers and polling interval.
Localization
How the language is selected and how to update or add gettext translation catalogs.
Installation & Setup
Install with pipx or uv and start the monitor automatically on login.
Development
Editable install, running the test suite, and the project's code principles.