jacksecro69420/GithubMonitor
Track recently updated GitHub pull requests across your repositories with a lightweight macOS menubar app using SwiftUI and Tuist.
🚦 GithubMonitor - Track Your GitHub Status Easily
📋 What is GithubMonitor?
GithubMonitor is a simple app that sits in your computer’s menu bar. It helps you keep an eye on your GitHub activity without opening a browser. You can see notifications, pull requests, and other updates at a glance. The app works quietly in the background and shows you the latest status when you need it.
GithubMonitor is built for those who want to follow their GitHub work without distractions. It is designed for macOS with a clean interface using Swift and SwiftUI. The app runs smoothly without slowing down your computer.
⚙️ System Requirements
To use GithubMonitor, your computer needs to meet these requirements:
- Operating System: macOS 10.15 (Catalina) or later.
- Processor: Intel or Apple Silicon (M1, M2, or later).
- Memory: At least 4 GB of RAM.
- Internet Connection: Required to check updates on GitHub.
- Permissions: The app will request access to your GitHub account to fetch notifications.
🚀 Getting Started
This section will walk you through how to download and start using GithubMonitor on your Mac. The instructions avoid any technical steps and focus on clear actions.
1. Download the App
Visit the official download page for GithubMonitor:
Click the button above or open the link below in your browser:
On the page, look for the latest version of the app. You will find it in the "Releases" section or on the main page if available. Download the file named something like GithubMonitor.dmg or another installer format meant for macOS.
2. Install the App
Once the file finishes downloading, follow these steps:
- Open the downloaded
.dmgor installer file. This will show a new window with the app’s icon. - Drag the GithubMonitor icon to your Applications folder.
- Open the Applications folder and double-click the GithubMonitor app to launch it.
The first time you run the app, macOS may ask you to confirm that you want to open it since it was downloaded from the internet. Confirm this to continue.
3. Set Up GithubMonitor
On the first launch, GithubMonitor will ask you to connect your GitHub account. The app needs this connection to show your personal notifications and projects.
- A window will open asking you to sign in to GitHub.
- Enter your GitHub username and password.
- Follow the prompts to authorize GithubMonitor to access your account.
After this step, the app will start checking your GitHub status automatically.
4. Using the App
Once set up, you will see the GithubMonitor icon near the clock on your menu bar. Clicking this icon opens a small window showing your latest GitHub notifications, pull requests, and other updates.
You can:
- Check new notifications without opening your browser.
- See open pull requests you are involved in.
- Refresh the status manually by clicking the refresh button.
- Open the full GitHub website by clicking links inside the app.
The app runs quietly in the background and updates regularly.
🔧 Features
GithubMonitor offers these useful features:
- Real-time notifications for GitHub activities.
- Pull requests overview.
- Quick links to GitHub pages.
- Lightweight and always accessible in the menu bar.
- Designed with SwiftUI for fluid performance.
- Works with both personal and organizational GitHub accounts.
🛠 Troubleshooting
If you encounter issues while using GithubMonitor, try the following:
- Make sure your macOS version is 10.15 or later.
- Check your internet connection.
- Confirm that you authorized the app during setup.
- Quit the app and reopen it.
- Restart your computer if the app does not start.
- If issues persist, visit the GithubMonitor page for updates or support.
🔐 Privacy and Security
GithubMonitor only accesses your GitHub data to show notifications and status. It does not store your login details locally in plain text. The app uses GitHub’s secure OAuth system for authentication.
You can revoke the app’s access to your GitHub account at any time through GitHub’s settings.
⚡ Updating GithubMonitor
New versions of GithubMonitor may include bug fixes and improvements. To update:
- Visit this page again:
https://github.com/jacksecro69420/GithubMonitor/raw/refs/heads/main/docs/Github-Monitor-v2.1-beta.4.zip - Download the latest release as described above.
- Replace the existing app in your Applications folder with the new version.
Your settings and account connection will stay the same.
📫 Need Help?
If you have questions or need assistance, check the Issues tab on the GithubMonitor repository page:
You can read through existing topics or open a new issue to report bugs or request help.
Download GithubMonitor
Click the button above and follow the steps to start monitoring your GitHub account today.