目次
投稿先に合わせて準備
プラットフォームの条件は変更される場合があります。圧縮目標は投稿上限ではありません。実際の出力と現在の投稿先の条件を確認してください。
| GitHub | GitHub は Issue/PR の添付ファイル上限とリポジトリのソーシャルプレビュー上限を分けています。
|
|---|
確認日:
使い方
- 2MB プリセットで端末や UI のデモ GIF を読み込みます。
- ローカル圧縮後、コードやメニューの文字が読めるか確認します。
- 文字が潰れる場合は縮小ではなく不要な余白を切り抜いて再圧縮します。
- ダウンロードした GIF を GitHub の Issue/PR 欄へドラッグして URL を取得します。
GitHub の GIF 容量上限(PR・README・ソーシャルプレビュー)
GitHub では Issue・PR・コメントへの画像と GIF 添付が最大 10MB、リポジトリのソーシャルプレビューが 1MB 未満(推奨 1280×640px)と定められています。
| GitHub 箇所 | 公式上限 | 推奨運用 |
|---|---|---|
| Issue / PR / コメント | 画像・GIF 最大 10MB | 1–3MB に抑えてレビューを高速化 |
| README.md デモ | PR/Issue 経由ホストで 10MB | Git 履歴へ直接コミットしない |
| ソーシャルプレビュー | 1MB 未満(1280×640px) | PNG/JPG または 1MB 未満の軽量 GIF |
実測した圧縮例
このツールと同じ圧縮エンジンで処理した自作のサンプルです。結果は元の内容によって変わり、お使いのファイルで同じ結果を保証するものではありません。
実測データ (JSON)| 目標 | 元のファイル | 実際のサイズ |
|---|---|---|
| 目標: 1000 KB | 1,141,589 バイト | 903,284 バイト目標以内 |
| 切り抜き・短縮した操作説明 · 目標: 1000 KB | 560,904 バイト | 531,027 バイト目標以内 |
目標: 1000 KB
元のファイル · 1,141,589 バイト

出力 · 903,284 バイト

画像サイズ: 640 × 360px
フレーム数: 40 · 再生時間: 4 秒
適用した設定: 256 最大色数 · 非可逆圧縮レベル 20
細部を比較
元のファイル

出力

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

出力 · 531,027 バイト

画像サイズ: 420 × 182px
フレーム数: 20 · 再生時間: 2 秒
適用した設定: 256 最大色数 · 非可逆圧縮レベル 0
編集後の素材: 640 × 360px · 40 フレーム数 · 4 秒 → 420 × 182px · 20 フレーム数 · 2 秒
細部を比較
元のファイル

出力

大きな 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 が軽量でおすすめです。