Skip to content

pedrofuentes/github-saver

Repository files navigation

GithubSaver

A Windows screensaver (.scr) that displays your GitHub activity as beautiful D3.js visualizations. Built with C# .NET 8 and WebView2.

Screensaver Modules

Module Description
Heatmap Multidata 4 stacked contribution grids — Commits, PRs, Issues, Reviews — each with its own color scheme
Heatmap Years 7 years of contribution history stacked vertically with a sweeping light wave
Rain Days 365 columns representing each day of the year, with rain intensity showing commit activity
Rain Repos Each column represents a repository — busier repos rain faster and brighter
Rain Weeks Matrix-style falling contribution squares with real week data highlights

All modules feature pure black backgrounds for OLED burn-in prevention, and all text elements are ephemeral (fade in/out with position drift).

Installation

Prerequisites

Build from source

dotnet publish src/GithubSaver/GithubSaver.csproj -c Release -r win-x64 --self-contained -o dist
copy dist\GithubSaver.exe dist\GithubSaver.scr

Install

  1. Copy the entire dist\ folder to a permanent location (e.g. C:\Program Files\GithubSaver\)
  2. Copy GithubSaver.scr to C:\Windows\System32\
  3. Open Screen Saver Settings → select GithubSaver
  4. Click Settings to configure your GitHub username and choose a module

Configuration

Click Settings in the Screen Saver Settings dialog to:

  • Select which visualization module to display
  • Enter your GitHub username and Personal Access Token
  • Configure GitHub Enterprise base URL (optional)
  • Adjust cache TTL

GitHub data is cached locally — the screensaver works offline after the first fetch. Without a GitHub connection, demo data is displayed.

Tech Stack

  • C# .NET 8 — Windows Forms app with WebView2 for rendering
  • D3.js v7 — Data visualization library (bundled, no CDN dependency)
  • WebView2 — Chromium-based web rendering in a native Windows app
  • Windows Credential Manager — Secure storage for GitHub PAT

License

MIT

About

A Windows screensaver (.scr) that displays your GitHub activity as beautiful D3.js visualizations. Built with C# .NET 8 and WebView2.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors