czl9707/gh-space-shooter

これは何？

主な機能

• 01コントリビューショングラフの各マスを、活動量に応じて強さが変わる敵として描画します。
• 02アニメーション付きのGIFまたはWebPファイルを出力します。
• 03列、行、ランダムの敵攻撃パターンを選べます。
• 04ファイルを毎日更新できる、スケジュール実行のGitHub Actionとして動作します。
• 05API呼び出しを減らすため、コントリビューションデータをJSONで保存・再読み込みできます。
• 06フレームレートとフレーム数の上限を調整できます。

ユースケース

• GitHubプロフィールのREADMEに、アニメーション付きのコントリビューショングラフを追加する。
• 毎日のスケジュール実行で、プロフィール用アニメーションを自動更新する。
• Webインターフェースを使い、インストール不要で共有可能なアニメーションをその場で生成する。
• 保存したJSONデータを使い、オフラインで描画設定を調整する。

クイックスタート

1. 1

   PyPIからインストールする

   pip install gh-space-shooter
2. 2

   read:userスコープを持つGitHubトークンを作成して、環境変数としてエクスポートする

   export GH_TOKEN=your_token_here
3. 3

   ユーザー名を指定してアニメーションを生成する

   gh-space-shooter <username>

使う前に知っておきたいこと

• !コントリビューションデータの取得にはGitHubの個人アクセストークンが必要です。

トピック

よくある質問

gh-space-shooter とは？

GitHubのコントリビューショングラフを、プロフィールに埋め込めるGalaga風のアニメーション付きシューティングGIFまたはWebPに変換します。 gh-space-shooterはGitHubユーザーのコントリビューションカレンダーを読み込み、アニメーション付きの宇宙シューティングゲームとして描画します。各コントリビューションのマスが敵になり、コントリビューション数が多いほど敵が強くなります。宇宙船は履歴をたどりながら敵と戦います。出力はGIFまたはWebPファイルで、プロフィールのREADMEや任意のMarkdownページに表示できます。

gh-space-shooter は無料で使えますか？ライセンスは？

gh-space-shooter は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

gh-space-shooter は今もメンテナンスされていますか？

活発にメンテナンス中。gh-space-shooter の最終コミットは 2026年10月10日 です。

gh-space-shooter は何に使えますか？

GitHubプロフィールのREADMEに、アニメーション付きのコントリビューショングラフを追加する。 毎日のスケジュール実行で、プロフィール用アニメーションを自動更新する。 Webインターフェースを使い、インストール不要で共有可能なアニメーションをその場で生成する。 保存したJSONデータを使い、オフラインで描画設定を調整する。

gh-space-shooter のインストール方法は？

PyPIからインストールする: pip install gh-space-shooter read:userスコープを持つGitHubトークンを作成して、環境変数としてエクスポートする: export GH_TOKEN=your_token_here ユーザー名を指定してアニメーションを生成する: gh-space-shooter <username>

gh-space-shooter はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/czl9707/gh-space-shooter