setup-butler

A Github Action to setup the butler command line tools for itch.io content authoring.

How to use

workflow

jobs:
  validate:
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [macos-latest, windows-latest, ubuntu-latest]
    steps:
      # download and setup butler
      - uses: buildalon/setup-butler@v1
        with:
          api-key: ${{ secrets.BUTLER_API_KEY }}
      # run butler commands
      - name: Upload to itch.io
        # https://itch.io/docs/butler/pushing.html
        run: butler push directory user/game:channel
        env:
          BUTLER_API_KEY: ${{ secrets.BUTLER_API_KEY }}

inputs

name description required
api-key An api key for your itch.io account true
version The version of butler to install. Defaults to latest. false
self-update Update butler to the latest version. Defaults to true. false

outputs

environment variables

  • BUTLER_PATH: The butler directory location.
  • BUTLER_DIR: The directory where butler is installed.

© 2024 Virtual Maker Corporation