GitHub Space Shooter

Key Features

• •Web interface: Generate a space shooter GIF from your GitHub contributions without installing anything. Perfect for quick, one-time use directly from your browser, requiring no local setup.
• •GitHub Action: Automate daily updates of your game file with a simple workflow. Customizable inputs like GitHub token, attack strategy (column, row, random), frame rate, and commit-amending to avoid repository bloat.
• •CLI tool: Install via PyPI or from source for advanced control. Supports custom output format (GIF or WebP), enemy attack strategies, frame rate adjustment, max frame limits, and saving/loading raw contribution data as JSON.
• •Multiple attack strategies: Choose from column, row, or random patterns defining how contribution-based enemies appear. Each strategy offers a different visual experience, adding replayability and excitement.
• •Adjustable animation settings: Control frames per second (default 40) and set a maximum frame limit. Lower fps reduces file size, while higher fps creates smoother animations, giving users flexibility based on their needs.
• •Automatic commit-amending: In GitHub Action mode, the tool amends previous commits if only the game file changed with the same message. This prevents repository bloat from daily commits, keeping history clean.

Use Cases

• •Embed in GitHub README: Generate a space shooter GIF from your contribution graph and display it in your profile README. This creates a dynamic, eye-catching visual that showcases your coding activity to visitors.
• •Daily automated update: Set up the GitHub Action to run daily, automatically updating the game file. Your README will always reflect the latest contributions without manual intervention, keeping your profile fresh.
• •Quick one-time share: Use the web interface to generate a GIF for a specific period or event, like a hackathon or month of strong contributions. No local installation required, perfect for social media sharing.
• •Advanced CLI customization: Developers can use the CLI to experiment with different strategies, frame rates, and output formats. For example, generate a slow-motion WebP with row attacks to highlight contribution density over time.
• •Data export for analysis: Save raw contribution data to JSON using the CLI's --raw-output option. This allows further analysis or integration with other tools, while also enabling offline game generation from saved data.

Who is this for?

GitHub developers, open-source contributors, tech enthusiasts, and individuals wanting to gamify their GitHub profile. This tool is ideal for developers who maintain a GitHub presence and wish to showcase their coding activity in a creative, engaging manner. It also appeals to data visualization fans and those looking to add a fun element to their contribution history. Recruiters and profile visitors benefit from a dynamic display that quickly communicates activity levels. The tool is suitable for anyone from casual coders to power users, offering options via web interface or CLI for different technical comfort levels.