メインコンテンツへ移動

GitHub README・PR 用に GIF を圧縮

GitHub の README や Pull Request の操作デモを軽量かつ鮮明にします。10MB の添付上限と 1MB のソーシャルプレビュー制限に対応します。

更新日:

GIF をドロップまたはファイルを選択

HTTPS 画像 URL を貼り付け

投稿先に合わせて準備

プラットフォームの条件は変更される場合があります。圧縮目標は投稿上限ではありません。実際の出力と現在の投稿先の条件を確認してください。

GitHub

GitHub は Issue/PR の添付ファイル上限とリポジトリのソーシャルプレビュー上限を分けています。

  • Issue・Pull Request・コメントに添付できる画像とGIFは最大 10MB です。
  • リポジトリのソーシャルプレビュー(PNG/JPG/GIF)は 1MB 未満(推奨 1280×640px)です。
  • 大きなGIFを Git 履歴に直接コミットせず、1–2MB に圧縮して Issue/PR 経由でホストしたリンクを README に貼りましょう。

確認日:

使い方

  1. 2MB プリセットで端末や UI のデモ GIF を読み込みます。
  2. ローカル圧縮後、コードやメニューの文字が読めるか確認します。
  3. 文字が潰れる場合は縮小ではなく不要な余白を切り抜いて再圧縮します。
  4. ダウンロードした GIF を GitHub の Issue/PR 欄へドラッグして URL を取得します。

GitHub の GIF 容量上限(PR・README・ソーシャルプレビュー)

GitHub では Issue・PR・コメントへの画像と GIF 添付が最大 10MB、リポジトリのソーシャルプレビューが 1MB 未満(推奨 1280×640px)と定められています。

1 — Issue/PR添付 10MB上限(README推奨1〜2MB) · 2 — ソーシャルプレビュー 1280×640・1MB未満
1 — Issue/PR 添付(上限10MB、README は 1–2MB 推奨) · 2 — ソーシャルプレビュー(1280×640px、1MB未満)
GitHub 箇所公式上限推奨運用
Issue / PR / コメント画像・GIF 最大 10MB1–3MB に抑えてレビューを高速化
README.md デモPR/Issue 経由ホストで 10MBGit 履歴へ直接コミットしない
ソーシャルプレビュー1MB 未満(1280×640px)PNG/JPG または 1MB 未満の軽量 GIF

実測した圧縮例

このツールと同じ圧縮エンジンで処理した自作のサンプルです。結果は元の内容によって変わり、お使いのファイルで同じ結果を保証するものではありません。

実測データ (JSON)
目標元のファイル実際のサイズ
目標: 1000 KB1,141,589 バイト903,284 バイト目標以内
切り抜き・短縮した操作説明 · 目標: 1000 KB560,904 バイト531,027 バイト目標以内

目標: 1000 KB

元のファイル · 1,141,589 バイト

目標: 1000 KB: 元のファイル

出力 · 903,284 バイト

目標: 1000 KB: 出力

画像サイズ: 640 × 360px
フレーム数: 40 · 再生時間: 4 秒

適用した設定: 256 最大色数 · 非可逆圧縮レベル 20

細部を比較

元のファイル

目標: 1000 KB: 元のファイル

出力

目標: 1000 KB: 出力

切り抜き・短縮した操作説明 · 目標: 1000 KB

編集後の素材 · 560,904 バイト

切り抜き・短縮した操作説明 · 目標: 1000 KB: 編集後の素材

出力 · 531,027 バイト

切り抜き・短縮した操作説明 · 目標: 1000 KB: 出力

画像サイズ: 420 × 182px
フレーム数: 20 · 再生時間: 2 秒

適用した設定: 256 最大色数 · 非可逆圧縮レベル 0

編集後の素材: 640 × 360px · 40 フレーム数 · 4 秒 → 420 × 182px · 20 フレーム数 · 2 秒

細部を比較

元のファイル

切り抜き・短縮した操作説明 · 目標: 1000 KB: 元のファイル

出力

切り抜き・短縮した操作説明 · 目標: 1000 KB: 出力

大きな GIF を Git に直接コミットしない理由

未圧縮の 8MB GIF をリポジトリへコミットすると、履歴から消しても packfile に残り続け、全開発者の git clone が遅くなります。Issue や下書き PR にドラッグして生成されるリンクを README に貼るか、REST API/MCP で CI 自動圧縮しましょう。

よくある質問

GitHub の PR や Issue に貼れる GIF の最大サイズは?

画像と GIF は最大 10MB です。

GitHub Actions から GIF を自動圧縮できますか?

はい。無料枠(月500クレジット・カード不要)の REST API と MCP サーバーを利用して自動化できます。

README では GIF と MP4 どちらが良いですか?

自動ループで再生バーを出したくない短い UI デモは GIF、10秒以上の長い操作録画は MP4 が軽量でおすすめです。