Skip to content

itchio/butler

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
March 11, 2022 13:52
art
December 30, 2016 11:56
February 18, 2020 10:26
August 28, 2020 23:09
February 18, 2020 10:30
March 30, 2022 15:11
March 1, 2020 17:51
June 2, 2020 22:30

butler

Build Status codecov Go Report Card MIT licensed

butler is the itch.io command-line tools - all by itself.

It is used by:

  • Content creators on itch.io to push builds quickly & reliably
  • the itch app for some network, filesystem and patching operations

Documentation

Documentation for butler is available as a Gitbook:

Questions about butler are welcome on its Issue tracker, or, if the matter is private, itch.io support.

Integrations

The following projects integrate butler as part of their workflow:

  • itchy-electron lets you package your Electron games for itch.io and upload them there
  • gradle-butler-plugin is a Gradle plugin for automatically installing, updating, and running butler as part of your build.

Authors

butler was mostly written by Amos Wenger, but wouldn't have been possible without the work of many before him.

Amos would like to thank in particular Leaf Corcoran, Jesús Higueras and Tomáš Duda.

License

butler is released under the MIT License. See the LICENSE file for details.

Additional licenses

While butler built from source is fully MIT-licensed, some components it can use at runtime (if present) have other licenses:

  • The 7-zip decompression engine (the github.com/itchio/boar/szextractor package) opens dynamic libraries for libc7zip, and 7-zip, which have components licensed under the LGPL 2.1 license and the MPL 2.0 license, along with specific terms for the RAR extraction code.