itch.io

The itch.io (butler) destination pushes your staged build to an itch.io channel using butler, itch.io’s official command line upload tool.

Setup

  1. Install butler (see itch.io’s guide). It also ships with the itch desktop app — Build & Ship auto-detects that location and your PATH, so you usually do not have to set a path at all.
  2. Log in once from a terminal: butler login.
  3. In the destination, enter your target as User/Game (e.g. sparrow/mygame) and a Channel (e.g. windows-beta). Butler derives the platform from the channel name.

Settings

  • Butler Path: leave empty for automatic lookup (configured path → PATH → the itch app’s install locations), or point it at your butler executable.
  • User/Game: the itch.io target in user/game form.
  • Channel: the itch channel to push to, e.g. windows-beta.
  • Send Version: when on, the bundle version is passed to itch.io via --userversion. Turn it off to let itch.io assign its own build number.

Under the hood the destination runs butler push <stagedBuild> user/game:channel (adding --userversion when enabled). On success the log links to your game’s itch.io page.

Was this page helpful?
Yes No