butler とは｜itch.io へビルドを差分で送れる無料の公式ツール
butler は、itch.ioにゲームのビルドを差分で素早くアップロードできる公式のコマンドラインツールです。無料でオープンソースです。
- 分類
- ビルド・配信・ストア提出の補助
- 日本語対応
- 日本語非対応
- 費用
- 無料（MITライセンス）
- 公式サイト
- https://itch.io/docs/butler/確認日 2026-09-18
butler の概要
butler は、itch.ioが公式に提供するコマンドラインツールです。butler でできることは次の3つです。ゲームのビルドをitch.ioへ素早く確実にアップロードすること、Steam のビルドをitch.ioのチャンネルへ写すこと、パッチ（差分のファイル）を作ってオフラインで適用することです。
「itch.io のコマンドラインツール」と言うときに指しているのは butler です。
コマンドラインを使わない道も用意されています。itch アプリの v26.12.0 以降には、butler を使ってビルドを送る画面が入っており、横の並びの「Builds」のページからアップロード・変更の下見・ビルドの管理を行えます。
butler の特徴
butler が自動化すること
butler の中心にあるのは butler push です。覚える必要があるコマンドは、これ1つです。
butler push directory user/game:channel
| 書く場所 | 何を指すか |
|---|---|
| directory | 送るもの。フォルダのほか .zip ファイルも指定できます |
| user/game | 送り先のプロジェクト。すべて小文字で書きます |
| channel | どの枠へ入れるか。windows-beta・osx-bonus・linux-universal・soundtrack などの名前を付けます |
チャンネルの名前は、その枠に最初に付く札（タグ）を決めます。札はあとから直せます。新しいチャンネルへ送ると、ゲームのページにそのファイルが現れます。同じチャンネルへもう一度送ると、ビルドの処理が終わったところで、そのファイルが差し替わります。
butler の差分の送り方
同じフォルダを2回送ると、1回目はすべてのデータを上げるので時間がかかり、2回目以降は変わっていなければほぼ一瞬で終わります。実際にはその中間になることが多く、1回の送信で新しいデータは5%〜20%ほど、つまりデータ・時間・通信量の80%〜95%が節約されます。
1回目も差分として扱われます（空の状態から1つ目の版への差分）。butler は圧縮して送るため、300MB のビルドで実際に流れるのは120MB ということもあります。
パッチは2段階で作られます。
| 段階 | どこで作られるか | 作り方 |
|---|---|---|
| 既定のパッチ | 送る人の機械（push したとき） | 決まった大きさの塊を突き合わせる rsync 方式で前の版と比べ、Brotli の軽い設定で圧縮します |
| 最適化したパッチ | itch.io 側（アップロードのあと） | バイト単位で比べる bsdiff で前の版と比べ直し、Brotli の高い設定で圧縮し直します |
送信を速く保ち、butler が使うメモリを小さく保つために、塊ごとの比較と軽い圧縮を使います。送信が終わった時点でビルドは公開され、遊ぶ人は既定のパッチですぐ更新できます。
なお、現在は、圧縮を解いた大きさの合計が 30GB を超えるビルドは、itch.io 側が受け付けません。
butler が対応する環境
butler は Windows・Linux・macOS のそれぞれに入れられます。配布は itch.io のページから行われ、安定版と最新の試作版の両方を取得できます。
butler を自動のビルドに組み込むとき
butler は、自動のビルド・配信の流れに組み込めるように作られています。CI/CD（コードを置くたびに機械がビルドと配信を行う仕組み）では、itch.io のダウンロードページの代わりに「broth」から butler をダウンロードできます。broth の URL は変わらないので、そのまま自分の手順書に書き込めます。
butler は Wharf という公開された仕様に沿って作られています。公開されている手順とファイル形式だけを使っているため、同じ仕組みに合わせた別のツールを作れます。
butler の費用とライセンス
butler は無料で、itch.io の配信の仕組みの多くと同じく、MIT ライセンス（オープンソースのライセンスの1つ）で公開されています。
| 項目 | 費用 |
|---|---|
| 利用 | 無料 |
| ライセンス | MIT（オープンソース） |
butler は、itch.ioのページから無料でダウンロードできます。Windows・macOS・Linuxそれぞれの実行ファイルが配布されています。
- butler の公式サイトhttps://itch.io/docs/butler/
情報源
- The butler manual — Introduction（itch.io公式ドキュメント）https://itch.io/docs/butler/確認日 2026-10-08
- The butler manual — Pushing builds（itch.io公式ドキュメント）https://itch.io/docs/butler/pushing.html確認日 2026-10-08
- The butler manual — Installing butler（itch.io公式ドキュメント）https://itch.io/docs/butler/installing.html確認日 2026-10-08
- butler by itch.io — itch.io配布ページhttps://itchio.itch.io/butler確認日 2026-10-08