A simple macOS widget that displays your GitHub contribution graph directly on your desktop.
This app was created in a "one-time vibe" coding session. I had never worked with Swift or macOS development before, but I wanted to see my GitHub contributions as a desktop widget - so I just built it. It's nothing fancy, just a straightforward contribution graph on your desktop.
If you have suggestions, improvements, or bug fixes, feel free to open a pull request!
Don't forget to leave a star! ⭐️
- macOS 11.0 (Big Sur) or later
- Xcode 12.0 or later (includes Command Line Tools and Swift 5.0+)
- Git
If you don't have Xcode installed, you'll need at least the Command Line Tools:
xcode-select --installgit clone https://github.com/SekulDev/GithubContributionWidgetMacOS.git
cd GithubContributionWidgetMacOSRun the installation script:
chmod +x install.sh
./install.shThis script will build the application and copy it to your Applications folder.
- Visit GitHub Personal Access Tokens
- Click "Generate new token"
- Select "Classic" token type
- Choose "No expiration" for duration
- Check "user:read" permission
- Click "Generate token" and copy it securely
- Right-click on your desktop
- Select "Edit Widgets" from the menu
- Find "GithubContributionWidgetMacOS" in the list
- Drag your preferred widget size to the desktop
- Right-click on the newly added widget
- Enter your GitHub username
- Paste the personal access token you generated
- Click "Done" to save your settings
You're all set! Enjoy tracking your contributions right from your desktop.
Contributions are welcome! Feel free to:
- Report bugs
- Suggest new features
- Submit pull requests
- Improve documentation
MIT License - feel free to use this however you want.
Built with Swift and SwiftUI for macOS. This was a fun learning experience diving into Apple's ecosystem for the first time!
Note: This is a passion project created out of personal need. The code might not be perfect, but it works!