{"id":23828546,"url":"https://github.com/artcc/github-contributions-stream-deck-plugin","last_synced_at":"2026-05-14T00:30:21.427Z","repository":{"id":270086050,"uuid":"862189627","full_name":"ArtCC/github-contributions-stream-deck-plugin","owner":"ArtCC","description":"Plugin for Stream Deck to display your GitHub contributions on one or more buttons.","archived":false,"fork":false,"pushed_at":"2025-02-11T13:45:05.000Z","size":2042,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-11T14:40:04.442Z","etag":null,"topics":["github-api","streamdeck","streamdeck-plugin","streamdeck-sdk"],"latest_commit_sha":null,"homepage":"https://www.arturocarreterocalvo.com","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ArtCC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["ArtCC"]}},"created_at":"2024-09-24T07:30:29.000Z","updated_at":"2025-02-11T13:45:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"35699353-34a8-43d8-9d6f-f2ee87c4b961","html_url":"https://github.com/ArtCC/github-contributions-stream-deck-plugin","commit_stats":null,"previous_names":["artcc/github-contributions-stream-deck-plugin"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtCC%2Fgithub-contributions-stream-deck-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtCC%2Fgithub-contributions-stream-deck-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtCC%2Fgithub-contributions-stream-deck-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtCC%2Fgithub-contributions-stream-deck-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArtCC","download_url":"https://codeload.github.com/ArtCC/github-contributions-stream-deck-plugin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240115788,"owners_count":19750082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github-api","streamdeck","streamdeck-plugin","streamdeck-sdk"],"created_at":"2025-01-02T13:18:06.831Z","updated_at":"2026-05-14T00:30:21.354Z","avatar_url":"https://github.com/ArtCC.png","language":"CSS","funding_links":["https://github.com/sponsors/ArtCC"],"categories":[],"sub_categories":[],"readme":"# GitHub Contributions Stream Deck Plugin\n\n\u003cimg src=\"https://github.com/ArtCC/github-contributions-stream-deck-plugin/blob/main/market-icon.png\" height=\"256\"\u003e\n\n## Overview\n\nThis 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!\n\n## Features\n\n- **Real-time GitHub Contributions**: Display your GitHub contributions graph updated in real-time.\n- **Multiple Time Frames**: View your contributions for the day, week, month, or actual year.\n- **Extended Year View**: Utilize 5 buttons to display a detailed, full-year contribution graph.\n- **Theme Support**: Choose between light and dark themes to match your preference or setup.\n- **Customizable**: Enter your GitHub username and personal access token for secure, personalized data retrieval.\n- **Auto-refresh**: Automatically updates every 30 minutes to keep your data current.\n\n## Installation\n\n### Option 1: Purchase the compiled plugin\n\nFor a hassle-free installation and to support the development of this plugin, you can purchase the compiled version for just 0.99 €.\n\n\u003ca href=\"https://marketplace.elgato.com/product/github-contributions-e44e9f6c-e85a-4889-acc5-d666133671e4\" target=\"_blank\"\u003eElgato market place\u003c/a\u003e\n\n### Option 2: Install from source\n\nYou can install it locally by following these steps:\n\n### For macOS:\n\n1. Download the source code from this GitHub repository.\n2. Unzip the downloaded file if necessary.\n3. Open Finder and go to the following directory:\n   ```\n   ~/Library/Application\\ Support/com.elgato.StreamDeck/Plugins/\n   ```\n4. Copy the entire folder named `com.artcc.github-contributions-stream-deck-plugin.sdPlugin` from the unzipped download into this Plugins directory.\n5. Restart the Stream Deck application.\n\n### For Windows:\n\n1. Download the source code from this GitHub repository.\n2. Unzip the downloaded file if necessary.\n3. Open File Explorer and go to the following directory:\n   ```\n   %appdata%\\Elgato\\StreamDeck\\Plugins\\\n   ```\n4. Copy the entire folder named `com.artcc.github-contributions-stream-deck-plugin.sdPlugin` from the unzipped download into this Plugins directory.\n5. Restart the Stream Deck application.\n\nAfter installation, the GitHub Contributions plugin should appear in your Stream Deck application.\n\n## Configuration\n\n1. Drag the GitHub Contributions action onto your Stream Deck.\n2. Click on the action to open the Property Inspector.\n3. Enter your GitHub username.\n4. [Create a personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) on GitHub with the proper permissions (read:user) and enter it in the token field.\n5. Choose your preferred time frame (day, week, month, year, or year with 5 buttons horizontally).\n6. If using the 5-button year view, configure each button with its corresponding number (1-5).\n7. Select your preferred theme (light or dark).\n8. Click 'Save Settings'.\n\n## Usage\n\nOnce 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.\n\n### 5-Button Year View\nTo use the extended year view:\n1. Set up 5 adjacent buttons on your Stream Deck.\n2. Configure each button with the same settings, but assign each a unique button number (1-5).\n3. This will create a large, detailed view of your entire year's contributions spread across 5 buttons.\n\n## Screenshots\n\nHere are some screenshots demonstrating the plugin in action:\n\n![Settings](https://github.com/ArtCC/github-contributions-stream-deck-plugin/blob/main/resources/settings.jpeg)\n\n![Dark theme](https://github.com/ArtCC/github-contributions-stream-deck-plugin/blob/main/resources/dark.jpeg)\n\n![Light theme](https://github.com/ArtCC/github-contributions-stream-deck-plugin/blob/main/resources/light.jpeg)\n\n## Privacy and Security\n\nYour personal access token is stored locally on your machine and is never sent to any server other than GitHub's API.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Support the Project\n\nIf 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.\n\n\u003ca href=\"https://donate.stripe.com/fZe9DK9Fz2cK1PO8ww\" target=\"_blank\"\u003eDonate via Stripe\u003c/a\u003e\n\nThank you for your support!\n\n## License\n\n[Apache License](LICENSE)\n\n## Acknowledgements\n\n- Thanks to the Elgato Stream Deck SDK for making this plugin possible.\n- GitHub for providing the API to retrieve contribution data.\n\n## Support\n\nIf you encounter any problems or have any questions, please open an issue on this GitHub repository.\n\n---\n\nEnjoy keeping track of your GitHub contributions right from your Stream Deck!\n\n**Arturo Carretero Calvo - 2024**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartcc%2Fgithub-contributions-stream-deck-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fartcc%2Fgithub-contributions-stream-deck-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartcc%2Fgithub-contributions-stream-deck-plugin/lists"}