New Builds

Linux ARM64 (aarch64)

Butler now builds natively for Linux ARM64, and those builds are published to broth.

macOS ARM64 (Apple Silicon) + Universal Binary

Butler now builds natively for macOS ARM64. A universal binary (x86_64 + arm64 via lipo) is also produced and code-signed. The ox dependency was updated to support ARM architecture detection.

Note: we may stop generated universal builds in the future, testing it out to see if it's useful to anyone

Breaking Changes

Linux minimum glibc raised from 2.28 to 2.31

Linux binaries are now built on Debian Bullseye, raising the minimum required glibc from 2.28 to 2.31. Users on older Linux distributions (e.g. Debian Buster) may need to upgrade.

Build & CI/CD

New GitHub Actions Build & Release Workflow

We have migrating building and releasing binaries of butler to GitHub actions. The new workflow includes all new job pipelines for signing and notarizing builds. Builds are published to broth directly from GitHub actions.

Windows executables are now signed with Azure Trusted Signing.

CI Modernization

• Go version: Upgraded from Go 1.14/1.23 to Go 1.24.0. All CI workflows now use go-version-file: 'go.mod' instead of hardcoding versions.

Helper Makefile

New Makefile with build, install, test, and clean targets for local development convenience.

Dependency Updates

Major dependency upgrades across the board. Many itchio dependencies were bumped to modern Go with enhancements and cleanups.

Documentation

Migrated from gitbook to honkit for documentation building. Docs deployed from master into GitHub pages.

Expanded Installation Guide

The docs/installing.md was completely rewritten with:

• Platform-specific step-by-step installation instructions (Windows, Linux, macOS)
• Verification steps for each platform
• Clarified broth URLs as permanent (vs expiring itch.io download links)
• New appendix: "Using butler from the itch app" with paths for each platform and how to find the current version

New Troubleshooting Page

Added docs/troubleshooting.md covering common issues: PATH errors, incorrect directory paths, spaces in file paths, invalid target errors, authentication problems, project page requirements, and firewall/antivirus issues.

butlerd

OAuth Login with PKCE Support

New Profile.LoginWithOAuthCode butlerd endpoint that allows the itch.io desktop app to authenticate users via OAuth authorization code exchange with PKCE. This accepts an authorization code, PKCE code verifier, redirect URI, and client ID — and returns the user profile along with a website cookie. The OAuth client ID is no longer hardcoded; it is provided as a parameter by the caller.

Unlike the existing LoginWithPassword and LoginWithAPIKey endpoints, the OAuth result also returns a Cookie map, enabling the desktop app to synchronize website login state after authentication.

butlerd NPM Package Rename

The butlerd npm package has moved to https://www.npmjs.com/package/@itchio/butlerd

The generous support path changed from butlerd/lib/support to @itchio/butlerd/lib/support.

butlerd Spec Updates

• Added Profile.LoginWithOAuthCode request to butlerd.json spec
• Added metadata field (type { [key: string]: any }) to Candidate type in spec