A native, theme-aware GitHub contribution calendar for the Noctalia v5 bar. See your activity at a glance without opening GitHub in a browser.
- Compact bar widget showing today's contribution count.
- Interactive annual heatmap with per-day activity on hover.
- Today, current streak, best streak, and annual contribution statistics.
- Automatic refresh every 30 minutes and manual refresh from the panel.
- Theme-aware colors that follow the active Noctalia palette.
- Offline-friendly cache that preserves the latest successful result.
- Noctalia v5 with plugin API 24 or newer.
- GitHub CLI (
gh), authenticated with the account whose activity you want to display. xdg-open(xdg-utilson Arch Linux) for the Open profile button.
Authenticate GitHub CLI before enabling the plugin:
gh auth login -h github.comEnable GitHub Activity in Noctalia's plugin manager, add the activity
widget to a bar, and click it to open the calendar. Right-click the widget or
use the refresh button in the panel to update immediately.
The panel can also be toggled through IPC:
noctalia msg panel-toggle alexmnrs/github-activity:calendarSee the plugin README for complete usage, troubleshooting, compatibility, and privacy information.
The plugin requests contribution data through gh api graphql. GitHub CLI
remains the sole owner of authentication: the plugin never reads, stores, or
displays a GitHub token.
The installable plugin lives in github-activity/.
catalog.toml indexes it as a Noctalia source, while tests and development
configuration remain at the repository root.
Add this checkout as a local source, enable the plugin, then add GitHub Activity from Noctalia's bar widget picker:
noctalia msg plugins source add github-activity-dev path "$(pwd)"
noctalia msg plugins enable alexmnrs/github-activityLuau source changes hot-reload. Manifest changes require a Noctalia config
reload. The optional standalone tests require the luau command:
luau tests/activity_spec.luau