Platane/snk
Snk
Snk is a GitHub profile readme widget that generates an animated snake visualization from a user's contribution graph data. It transforms the familiar contribution grid into a sequence where a snake moves across the cells, consuming them in order, and outputs the result as an animated SVG or GIF file.
The project automates the entire workflow through a daily cron-triggered job, fetching contribution data via the GitHub GraphQL API, constructing the snake animation frame by frame, and exporting the final image. Users can customize the color palette of both the snake and the grid cells to match their profile theme, and the generated image is designed to be embedded directly in a GitHub profile readme with scheduled updates.
The system handles the full pipeline from data retrieval to image generation, including SVG path construction for the snake body, canvas-based animation, and GIF frame compositing for animated exports. The documentation covers setup through GitHub Actions, enabling users to configure the workflow and color scheme for their own profiles.
Features
- Contribution Graph Animators - Animates a user's contribution graph as a snake eating cells in sequence, outputting as SVG or GIF.
- Dynamic Snake - A dynamic widget that displays a snake animation of contribution activity for GitHub profile pages.
- Contribution Graph Game Animators - Transforms a GitHub contribution grid into a playable snake game animation.
- Contribution Graph SVG Renderers - Converts GitHub contribution data into an SVG grid by mapping each cell's color and position.
- Contribution Visualization Tools - Animates a user's GitHub contribution graph as a snake eating cells, outputting as SVG or GIF for profile readmes.
- Snake Contribution Animators - An animated snake that eats contribution cells from a GitHub user's graph, exported as SVG or GIF.
- Profile Readme Image Automators - Generates daily animated images from GitHub data to embed in profile readmes with scheduled updates.
- GitHub API Clients - Retrieves user contribution graph data via the GitHub GraphQL API for animation generation.
- Contribution Graph GIF Creators - Creates animated SVG or GIF files from a sequence of contribution graph states with customizable colors.
- Contribution Data SVG Generators - Creates animated SVG files from GitHub contribution data for use in profile readmes.
- Canvas Frame Animations - Animates the snake by clearing and redrawing SVG paths frame by frame in a timer-driven loop.
- Animated SVG GIF Exports - Outputs the snake animation as an SVG or GIF with customizable colors and background.
- Grid Traversal Path Builders - Constructs the snake body as connected SVG path segments based on a grid traversal algorithm.
- Daily Profile Image Generators - Generates a fresh snake animation each day for profile readmes using an automated schedule.
- SVG Frame GIF Compositors - Assembles individual SVG frames into an animated GIF by rasterizing and encoding them sequentially.
- Contribution Grid Color Mappings - Maps user-defined colors to contribution grid cells and snake segments for visual customization.
- Contribution Graph Color Workflows - Changes the color palette of the snake and grid cells to match a profile or theme.
- Snake Grid Color Customizations - Changes the color palette of the snake and grid cells to match a profile theme.
- Profile Widgets - Generates a snake game from contribution graph data.
