Repolode
czl9707

czl9707/gh-space-shooter

Превращает график активности GitHub в анимированный GIF или WebP в стиле Galaga, который можно встроить в профиль.

Звёзды
927
Форки
76
Открытые issues
1
Последний коммит
10 дней назад

Что это?

gh-space-shooter считывает календарь активности пользователя GitHub и превращает его в анимированный космический шутер: каждая ячейка активности становится врагом, а чем больше вкладов, тем сильнее враг. Тем временем космический корабль пробивается сквозь историю активности. Результат сохраняется в GIF или WebP — его можно добавить в README профиля или на любую страницу в Markdown.

Проект можно использовать несколькими способами. Веб-интерфейс позволяет создать анимацию прямо на сайте, ничего не устанавливая. Python CLI, доступный на PyPI, генерирует файлы локально, а GitHub Action пересоздаёт анимацию по расписанию и коммитит её в репозиторий. Для атак врагов можно выбрать стратегию по столбцам, строкам или случайным образом; также настраиваются частота кадров и их количество.

CLI умеет сохранять исходные данные об активности в JSON и загружать их позже. Это позволяет не обращаться к API повторно при подборе параметров рендеринга.

Ключевые возможности

  • 01Преобразует ячейки графика активности во врагов, сила которых зависит от количества вкладов.
  • 02Экспортирует анимацию в GIF или WebP.
  • 03Поддерживает стратегии атак врагов по столбцам, строкам и случайным образом.
  • 04Работает как GitHub Action по расписанию и может обновлять файл каждый день.
  • 05Сохраняет данные об активности в JSON и загружает их повторно, сокращая количество обращений к API.
  • 06Позволяет настраивать частоту кадров и их максимальное количество.

Сценарии использования

  • Добавить анимированный график активности в README профиля GitHub.
  • Автоматически обновлять анимацию профиля с помощью ежедневного workflow по расписанию.
  • Создать анимацию, которой можно поделиться, через веб-интерфейс, ничего не устанавливая.
  • Подбирать параметры рендеринга офлайн, используя сохранённые данные JSON.

Быстрый старт

  1. 1

    Установить из PyPI

    pip install gh-space-shooter
  2. 2

    Создать токен GitHub с областью read:user и экспортировать его

    export GH_TOKEN=your_token_here
  3. 3

    Создать анимацию для имени пользователя

    gh-space-shooter <username>

Что важно знать

  • Для получения данных о вкладах требуется персональный токен доступа GitHub.

Темы

Частые вопросы

Что такое gh-space-shooter?
Превращает график активности GitHub в анимированный GIF или WebP в стиле Galaga, который можно встроить в профиль. gh-space-shooter считывает календарь активности пользователя GitHub и превращает его в анимированный космический шутер: каждая ячейка активности становится врагом, а чем больше вкладов, тем сильнее враг. Тем временем космический корабль пробивается сквозь историю активности. Результат сохраняется в GIF или WebP — его можно добавить в README профиля или на любую страницу в Markdown.
gh-space-shooter можно использовать бесплатно? Какая у него лицензия?
gh-space-shooter распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
gh-space-shooter всё ещё поддерживается?
Активно поддерживается. Последний коммит в gh-space-shooter — 10 окт. 2026 г..
Для чего можно использовать gh-space-shooter?
Добавить анимированный график активности в README профиля GitHub. Автоматически обновлять анимацию профиля с помощью ежедневного workflow по расписанию. Создать анимацию, которой можно поделиться, через веб-интерфейс, ничего не устанавливая. Подбирать параметры рендеринга офлайн, используя сохранённые данные JSON.
Как установить gh-space-shooter?
Установить из PyPI: pip install gh-space-shooter Создать токен GitHub с областью read:user и экспортировать его: export GH_TOKEN=your_token_here Создать анимацию для имени пользователя: gh-space-shooter <username>
Где скачать gh-space-shooter?
Исходный код и инструкции по установке — на GitHub: https://github.com/czl9707/gh-space-shooter

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты