🤑 Indie game store🙌 Free games😂 Fun games😨 Horror games
👷 Game development🎨 Assets📚 Comics
🎉 Sales🎁 Bundles


A member registered Jun 26, 2014 · View creator page →

Creator of

Recent community posts


I think the data is actually duplicated (in the OP's zip) - instead of making a new zip, it just appends the new files to the end. When extracting, whichever entry occurs last should be used.

It wouldn't matter once it's uploaded with butler though, because a fresh .zip is made on the backend  (that never has duplicates).


You can pick any upload to be played in the browser, regardless of the channel's name.

Channel names only matter for the first push - since it determines what platforms the new upload is going to be tagged with. That can always be changed in the Edit game page, though!


That's a good point! Although, I really would rather people not use RAR even now :)


ClickTeam's Install Creator is not supported (and won't be) because it doesn't allow silent installs.

I heavily recommend using butler to upload your game - the itch docs have everything you need to get started:


Hey Truth,

BitDefender is known to interfere with itch app operation - this page describes how you can set it up so it leaves itch alone: https://itch.io/docs/itch/installing/windows.html#antivirus-software

In the future we're planning on working more closely with AV vendors to avoid this kind of issues. Thanks for your patience!


Joseph, that's probably why :)


Hi everyone,

The issue has been resolved - launching the app again will work as usual.

Thanks for posting a workaround, more details on the underlying issue can be read here for the curious.

Admin (Edited 1 time)

Hey there!

There's a bunch of things happening at once here:

  • There's issues with Zero-K.sh (see this comment https://github.com/itchio/itch/issues/1608#issuecomment-384237076 )
  • There's a bug in v23 that causes it to ignore the manifest if it cannot find executables
    • That's what you're seeing: v23 ignoring your manifest
  • If I fix the script (convert CRLF endings to LF and add a she-bang), it still won't work, for two reasons:
    • The script calls sudo, which is not going to work since there is no way for the user to input their password
    • v23 doesn't implement the "os" key, as you noticed! So it gets confused and launches Zero-K.exe anyway (since they're both named launch).

Here's how things are looking for the future:

  • The "manifest ignored if no executables" bug is not present in v25
  • Scripts without shebangs are opened as a text file though, I'm not entirely decided yet but I may make it accept shebang-less ".sh" files and default to bash. Although that means the game build will be a bad experience for non-app users :(
  • The "os" filter is supported (even if it wasn't, it wouldn't confuse both manifest actions anyway).
  • Aaron Franke requested a Mono prerequisite (which means no need to call sudo from your script), and I'm thinking pretty hard about adding it: https://github.com/itchio/itch/issues/1606

Hey, that's a Minotaur-specific issue, I looped in the devs here: https://itch.io/post/316404


Hey there, I took a look at the issue and it seems v23 of the app isn't able to extract the .rar (for the Windows build) as it is currently.

The good news is that the next version of the app (v25) installs it correctly. If you wait long enough, the problem will resolve itself ;) However I'd recommend using butler to push the windows build of the game instead, you can find more information here: https://itch.io/docs/itch/integrating/quickstart.html


Hey there, I've responded to your support ticket - it's all resolved :)


It looks like https://github.com/LPGhatguy/luajit-request might be an option as well!

Re new API, if you're not into blog posts, this issue is a good one to subscribe to: https://github.com/itchio/go-itchio/issues/2


Very cool! We're about to release a new API version, so be prepared to release an update :)

I'm curious why the proxy is needed? Is it because luasec is a hassle to ship with Love2D games ?


Gave it a spin, and it seems the reason it's buggy has nothing to do with the protocol it's loaded over :)

It appears the `navigator.languages` array is empty in electron's browser window context.

Apparently it's a known issue, that we can work around: https://github.com/electron/electron/issues/11053

It'll have to wait for itch v25 though (the next big release). I've opened an issue here to track our progress: https://github.com/itchio/itch/issues/1758


Hey, thanks for the feedback!

We're in the process of adding this feature directly to the website, so I probably won't upload that userscript anymore :)


Hey there,

Can you link to a game that isn't working?

The app doesn't "just open the directory" using the file: protocol - it registers a custom protocol that serves the game's files, see:

If you link me to a game I can investigate further :)


I replied to the equivalent support ticket.

butler wasn't freezing, it was waiting for an URL (not just the API key) or an HTTP request from the in-browser Authentication flow, but WarpZone has NoScript installed so the automatic method wasn't allowed to work :)


Any antivirus software installed?


The new version of the app (which handles this cleanly) is being released soon. It includes a lot of underlying changes, so it took a long while to prepare. It also includes a notification that lets you know you can clean up your downloads folders to free up disk space (that was used by previous versions of the app).

In the meantime, I still recommend just wiping the `downloads` folder yourself if you find that it gets too big.

For the curious: v25 of the app uses https://github.com/itchio/butler for all install tasks, and download folders are tracked more closely:

  • Most archives are not even stored on disk, they're directly decompressed
  • Same goes for patches - only windows installers need to be downloaded first to disk, then executed
  • The folder for a download is wiped as soon as an install succeeds, or after it fails, if it's discarded (instead of retried).

My apologies for the amount of time it has taken - I'm really excited to release it so everyone can benefit from the improved overall reliability and performance!


Hey there, there were some server issues earlier, but they've been fixed since. This should not normally happen, the notification is just there for you to know to ping support if the situation doesn't resolve itself quickly enough :)


Hey there, there were some server issues earlier, but they've been fixed and all failed builds have now been processed correctly.


So, you always have to specify a channel when pushing with butler, like so:

butler push folder user/game:channel

If your game was previously uploaded via the website, you'll just need to upload it once with butler with a channel name of your choice (that contains 'html5'), delete the old one, and mark the new one as "This file will be played in the browser", and you're all good to go!

The next time you want to upload an upgrade, use the same channel name you just created, and it will update the embed, and distribute patches to itch.io app users. Hope that clarifies things!


Do you have Avast installed by any chance? Or another antivirus product ?


Do you have any antivirus installed? Avast, AVG, Avira, something else?


Re your antivirus: did you mean BullGuard ? I'm not able to find any software by the name "Windows Guard"


Thanks for the response! This is consistent with my tests: Avast blocks access to butler until it can run its cloud scan (which can take several hours). They have a whitelisting program, so I'll get in touch with them.


There's still a fair amount of activity going on over at the itch issue tracker: https://github.com/itchio/itch/issues - ideally we'd progressively move more and more to itch.io facilities so that having a GitHub account is not required!

I don't have anything in particular to ask you to do right now, but thanks for reaching out! We're nearing quite a big release, with lots of changes, so we want to finish that properly before we start looking again at various reports. I've also been looking at other issues like a half-dozen reports of folks who just aren't able to run the app due to bad antivirus interactions, those will probably be handled first!

Admin (Edited 1 time)

On a fresh Windows 10.0.16299.19 install, 64-bit butler v11.0.0 runs without problems for me:

Additional research:

  • With BitDefender Free edition, downloading and running butler.exe (even scanning it explicitly) is no problem either.

Hey, sorry for the late response and thanks for the info!

Do you have any antivirus software installed?


I've seen a few other reports of this, but haven't been able to reproduce yet.

Any antivirus software running?

zipped the game files for use on PC

Using the Windows Send to => Compressed folder feature? (see this) or something like Winzip, WinRar, 7-zip ?


Also, here's what I recommend for the game:

  • Always push folders, not .zips
  • Push them to osx-universal and delete any other channels you've created when trying to work around that bug (so everyone gets delta updates)
  • If you encounter any problems pushing in the future, post here instead of creating another channel!

After a day of investigation, I'm very convinced that this .zip file is invalid: there's details over at https://github.com/itchio/butler/issues/142

However, in the process, I discovered that butler was rejecting other files that are valid, so I fixed that :)

I've added the `butler auditzip file.zip` command to make it easier to investigate those cases in the future.

For now, I'm really curious though - what software produced this file? What was your exact process? Because it's not even just a "rare variant", it's just plain wrong :)


Thanks a ton! I'm able to reproduce the issue just by extracting the zip:

I'm feeling extremely relieved because this means it's just a simple issue with the zip format, and not with the push command itself :)


Now I really want to take a look at that .zip file :)

Can you use web upload to put i on the test4butler page, so I can download it as-is and test pushing it myself? Thanks!

Replied to TetraStudios in Feedback

(This may happen if the app bundle is unsigned: macOS Gatekeeper refuses to open such apps. Using https://itch.io/app to install and run the game works around this)


Note: if you do upload the .zip to an itch.io page, use the regular web upload, not butler - I need the exact same file you used to reproduce the issue.


Wait, so the first time it failed for you, you were pushing a .zip? Can you upload that exact .zip somewhere and link me to it? (A draft itch.io page works for me, just give me the URL once it's up)


Quick update: I'm not able to reproduce the error right now, pushing (what you pushed to osx-new) to (an equivalent of the osx-universal) channel from linux with the latest butler works just fine:

I'm going to try it all again from macOS with the exact version you mentioned.


Thanks for all the additional info!

I see you're pushing to new channels in the meantime: I would recommend not doing that, as users who installed the older channel will have to redownload the full version instead of just applying the patch. I'll let you know as soon as I'm able to reproduce the issue, find out what caused it, and push a butler update for you.