Distributing macOS builds
macOS might just be the ideal platform to distribute third-party, proprietary apps.
Just push your .app bundle with butler.
If you need an app manifest, put your .app and the manifest in a folder, and push that one with butler.
If you really really want to do something else, read the Compatibility policy page.
...but I don't have an app bundle
App bundles are directories with a standardized structure and some metadata in an
Here's a good stackoverflow thread on how they're created. Good luck!
Please don't push naked macOS binaries.
Support for them is disappearing a little more every macOS release.
Symbolic links and permissions
App bundles typically have symbolic links (for frameworks) and need some file permissions to be set properly.
We've taken several measures to ensure this works properly:
- At upload time
- butler handles symlinks, and fixes file permissions if they're wrong
- At launch time
- the itch.io app fixes permissions if they're wrong.
If you don't use butler and upload an archive with wrong permissions, when players download and play your game without using the itch.io app, they'll encouter Error -10810.
Gatekeeper & other security measures
For players that are not using the itch.io app, you might get reports of your app being "Damaged and can't be opened" and that it should "be moved to the trash".
Player who do use the itch.io app do not encounter these issues, so you may want to encourage them to use it.