czl9707/gh-space-shooter

¿Qué es?

Funciones clave

• 01Representa las celdas del gráfico de contribuciones como enemigos cuya fuerza aumenta con la actividad.
• 02Exporta archivos GIF o WebP animados.
• 03Ofrece estrategias de ataque de los enemigos por columna, por fila o aleatorias.
• 04Se ejecuta como una GitHub Action programada que puede actualizar el archivo a diario.
• 05Guarda y vuelve a cargar los datos de contribuciones en formato JSON para reducir las llamadas a la API.
• 06Permite ajustar la frecuencia y el límite de fotogramas.

Casos de uso

• Añadir un gráfico de contribuciones animado al README del perfil de GitHub.
• Actualizar automáticamente una animación del perfil mediante un workflow diario programado.
• Generar una animación puntual para compartir sin instalar nada, mediante la interfaz web.
• Probar distintos ajustes de renderizado sin conexión usando datos JSON guardados.

Inicio rápido

1. 1

   Instalar desde PyPI

   pip install gh-space-shooter
2. 2

   Crear un token de GitHub con el ámbito read:user y exportarlo

   export GH_TOKEN=your_token_here
3. 3

   Generar la animación para un nombre de usuario

   gh-space-shooter <username>

Antes de usarlo

• !Se necesita un token de acceso personal de GitHub para obtener los datos de contribuciones.

Temas

Preguntas frecuentes

¿Qué es gh-space-shooter?

Convierte el gráfico de contribuciones de GitHub en un GIF o WebP animado de un juego espacial al estilo de Galaga, listo para insertar en tu perfil. gh-space-shooter lee el calendario de contribuciones de un usuario de GitHub y lo convierte en un juego espacial animado: cada celda de contribuciones se transforma en un enemigo, cuya fuerza aumenta con el número de contribuciones, mientras una nave espacial se abre paso por el historial. El resultado es un archivo GIF o WebP que se puede mostrar en el README del perfil o en cualquier página Markdown.

¿gh-space-shooter es gratuito? ¿Qué licencia tiene?

gh-space-shooter es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿gh-space-shooter sigue mantenido?

Mantenimiento activo. El último commit de gh-space-shooter fue el 10 oct 2026.

¿Para qué puedo usar gh-space-shooter?

Añadir un gráfico de contribuciones animado al README del perfil de GitHub. Actualizar automáticamente una animación del perfil mediante un workflow diario programado. Generar una animación puntual para compartir sin instalar nada, mediante la interfaz web. Probar distintos ajustes de renderizado sin conexión usando datos JSON guardados.

¿Cómo se instala gh-space-shooter?

Instalar desde PyPI: pip install gh-space-shooter Crear un token de GitHub con el ámbito read:user y exportarlo: export GH_TOKEN=your_token_here Generar la animación para un nombre de usuario: gh-space-shooter <username>

¿Dónde consigo gh-space-shooter?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/czl9707/gh-space-shooter