This Stream Deck plugin allows you to visualize your GitHub contribution graph directly on your Stream Deck. Keep track of your coding activity with a quick glance at your Stream Deck!
- Real-time GitHub Contributions: Display your GitHub contributions graph updated in real-time.
- Multiple Time Frames: View your contributions for the day, week, month, or actual year.
- Extended Year View: Utilize 5 buttons to display a detailed, full-year contribution graph.
- Theme Support: Choose between light and dark themes to match your preference or setup.
- Customizable: Enter your GitHub username and personal access token for secure, personalized data retrieval.
- Auto-refresh: Automatically updates every 30 minutes to keep your data current.
For a hassle-free installation and to support the development of this plugin, you can purchase the compiled version for just €2.
Once purchased, follow the installation instructions provided with the download.
As this plugin is not yet available on the Elgato Stream Deck Marketplace, you can install it locally by following these steps:
- Download the source code from this GitHub repository.
- Unzip the downloaded file if necessary.
- Open Finder and go to the following directory:
~/Library/Application\ Support/com.elgato.StreamDeck/Plugins/ - Copy the entire folder named
com.artcc.github-contributions-stream-deck-plugin.sdPluginfrom the unzipped download into this Plugins directory. - Restart the Stream Deck application.
- Download the source code from this GitHub repository.
- Unzip the downloaded file if necessary.
- Open File Explorer and go to the following directory:
%appdata%\Elgato\StreamDeck\Plugins\ - Copy the entire folder named
com.artcc.github-contributions-stream-deck-plugin.sdPluginfrom the unzipped download into this Plugins directory. - Restart the Stream Deck application.
After installation, the GitHub Contributions plugin should appear in your Stream Deck application.
- Drag the GitHub Contributions action onto your Stream Deck.
- Click on the action to open the Property Inspector.
- Enter your GitHub username.
- Create a personal access token on GitHub with the proper permissions (read:user) and enter it in the token field.
- Choose your preferred time frame (day, week, month, year, or year with 5 buttons horizontally).
- If using the 5-button year view, configure each button with its corresponding number (1-5).
- Select your preferred theme (light or dark).
- Click 'Save Settings'.
Once configured, the plugin will display your GitHub contributions graph on the Stream Deck button(s). The graph updates automatically every 30 minutes, or you can press the button to refresh manually.
To use the extended year view:
- Set up 5 adjacent buttons on your Stream Deck.
- Configure each button with the same settings, but assign each a unique button number (1-5).
- This will create a large, detailed view of your entire year's contributions spread across 5 buttons.
Here are some screenshots demonstrating the plugin in action:
Your personal access token is stored locally on your machine and is never sent to any server other than GitHub's API.
Contributions are welcome! Please feel free to submit a Pull Request.
If you find this plugin useful and would like to support its development, consider making a donation or purchasing the compiled version. Your support helps me continue to improve and maintain this project.
Thank you for your support!
- Thanks to the Elgato Stream Deck SDK for making this plugin possible.
- GitHub for providing the API to retrieve contribution data.
If you encounter any problems or have any questions, please open an issue on this GitHub repository.
Enjoy keeping track of your GitHub contributions right from your Stream Deck!
Arturo Carretero Calvo - 2024
