czl9707/gh-space-shooter

O que é?

Recursos principais

• 01Renderiza as células do gráfico de contribuições como inimigos cuja força aumenta conforme a atividade.
• 02Exporta arquivos GIF ou WebP animados.
• 03Oferece estratégias de ataque dos inimigos por coluna, linha ou aleatórias.
• 04Funciona como uma GitHub Action agendada que pode atualizar o arquivo diariamente.
• 05Salva e carrega dados de contribuições em JSON para reduzir chamadas à API.
• 06Permite ajustar a taxa de quadros e o limite de quadros.

Casos de uso

• Adicionar um gráfico de contribuições animado ao README de perfil do GitHub.
• Atualizar automaticamente uma animação de perfil por meio de um workflow diário agendado.
• Gerar uma animação pontual para compartilhar, sem instalar nada, usando a interface web.
• Ajustar as configurações de renderização offline com dados salvos em JSON.

Início rápido

1. 1

   Instalar pelo PyPI

   pip install gh-space-shooter
2. 2

   Criar um token do GitHub com o escopo read:user e exportá-lo

   export GH_TOKEN=your_token_here
3. 3

   Gerar a animação para um nome de usuário

   gh-space-shooter <username>

Antes de usar

• !É necessário um token de acesso pessoal do GitHub para buscar dados de contribuições.

Tópicos

Perguntas frequentes

O que é gh-space-shooter?

Transforma o gráfico de contribuições do GitHub em um GIF ou WebP animado de nave espacial no estilo Galaga, pronto para incorporar ao seu perfil. gh-space-shooter lê o calendário de contribuições de um usuário do GitHub e o transforma em um jogo de nave espacial animado: cada célula de contribuição vira um inimigo, e quanto maior o número de contribuições, mais forte o inimigo, enquanto uma nave luta para avançar pelo histórico. O resultado é um arquivo GIF ou WebP que pode ser exibido em um README de perfil ou em qualquer página Markdown.

gh-space-shooter é gratuito? Qual é a licença?

gh-space-shooter é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

gh-space-shooter ainda é mantido?

Manutenção ativa. O último commit de gh-space-shooter foi em 10 de out. de 2026.

Para que posso usar gh-space-shooter?

Adicionar um gráfico de contribuições animado ao README de perfil do GitHub. Atualizar automaticamente uma animação de perfil por meio de um workflow diário agendado. Gerar uma animação pontual para compartilhar, sem instalar nada, usando a interface web. Ajustar as configurações de renderização offline com dados salvos em JSON.

Como instalar gh-space-shooter?

Instalar pelo PyPI: pip install gh-space-shooter Criar um token do GitHub com o escopo read:user e exportá-lo: export GH_TOKEN=your_token_here Gerar a animação para um nome de usuário: gh-space-shooter <username>

Onde consigo gh-space-shooter?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/czl9707/gh-space-shooter