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

How to get your game running in the itch app Sticky

A topic by Amos created 1 year ago Views: 4,994 Replies: 34
Viewing posts 1 to 19
Admin (Edited 4 times) (+5)

The app lets you test your own games — grab it here and test them now: https://itch.io/app

First, don't use RAR.

Second, tag your uploads by checking those boxes in the game edit page:

If you only see an earth icon next to your games, that's because there's no download tagged for your platform.

Use shift-click to explore an installed directory, and alt-click to view a download/install log.

Platform-specific advice


  • zipped directory with .exe / .bat + resources with all required .DLLs
  • or: InnoSetup / NSIS / MSI installer / InstallShield self-extracting archive (not recommended)


  • zipped .app bundle
  • or: shell script / binary (not recommended)


  • read this thread: https://github.com/itchio/itch/issues/86
  • MojoSetup is supported as of v0.12.1
  • chroots are your friends until we put up a base runtime
  • build on an old-ish ubuntu (12.04 LTS?) so you don't run into GLIBC version problems
  • when in doubt, hire Ethan to do your port for you, he does good work.

When launching, the shortest path usually wins (until we get manifest support) — there's no 32/64-bit preference.

If you still have questions after reading all the above, don't hesitate to report stuff on GitHub issues — it's by far the most efficient way for me to fix it. Thanks!


All of my games are working! Great job on the itch app, it works wonderfully.

Will we eventually be able to search for (and install) any of the 20,000+ games on itch.io with just the app? Or will it always just be purchased games, games in a playlist, or staff picked games?

I'm guessing that it'll have a in-itch browser.


Sure. Just leave me the time to do it right :)

In the meantime, collections are the easiest way — shop on site, play in app.


Yup! all my games work beautifully! Good going itch.io! :D

wait how do i change which exe it opens? construct 2 exported all my games with a direct x installer, and that's what itch always launches :(

Admin (Edited 1 time) (+1)

Until manifest support is in, there's no way to override it.

That said, for known installers like DirectX, there's easy ways to detect that, I'll push that in a version soon — https://github.com/itchio/itch/issues/186

Can you link me to your game? If it's a rather typical Construct 2 export, I can make sure it runs well :)

thanks for responding!

the games that are affected are http://mortimer.itch.io/gith, http://mortimer.itch.io/eggs and http://mortimer.itch.io/prose-couplet

also, that last one is a bundle of more than one game... so is there any way i can have itch show multiple launch buttons for the multiple executables? doesn't really matter since the games are shit, but it would be a cool feature anyway


Edited first reply to include link to manifest issue, which I think answers that question — sorry, I meant to include it in the first place :)

okay thanks for the help!

one last thing, what about browser games? itch tries to download them but just says they're 'broken'


Web games are also planned — https://github.com/itchio/itch/issues/47

Supporting them is a lot easier than native games, so I left that as a goodie for later :) But it's coming, no worries.


thanks again

also great work with itch. it's already looking really promising, and when it does work (which is most of the time) it's a hell of a lot more convenient and easy than manual downloads :)

Well... i have a few games on Itch.io and i want to test it out, but turns out Windows XP is not supported so i can't install the app.. *sad*
so i guess the Itch app can't be run in windows XP anytime soon?

P.S don't ask why i'm still using Windows XP!


Oh don't worry, I'm not going to ask :) But no, the app requires Windows 7 or higher, because it's based on electron, which doesn't support anything older.

Appears my game iGrow Game came up as broken once trying to download and install.

My game has separate packages for 32-bit and 64-bit Linux distributions. Currently Itch app always installs the 32-bit version, even on 64-bit Linux.

Does the Itch app simply install the first Linux package it sees or is there some logic to determine the correct one?


There is no special 32/64-bit logic for now, I opted against adding heuristics for that and rather, wait for backend support instead to properly tag builds.


I made a package for Linux according to itch guidelines, i.e. two versions of executable (x64, x86) and a `launch` bash script which selects a version and sets appropriate LD_LIBRARY_PATH and things. However it's not easy for some users to run it: the problem is that they don't use itch app, they download & unpack .zip manually, and they don't or cannot use command line. So they cannot run the script in Ubuntu: double click just opens it in text editor, despite that it has executable permission. And I don't even see any way to run a bash script in Ubuntu's graphical shell, without touching command line. There's no 'run' context menu command or something like this. I don't want to force users to use command line, what else I can do? :)


Yep, that's the way most Linux distributions behave and it's been annoying third-party developers for years now :(

The only option that I know of is to provide a .desktop file, which will appear as a shortcut and is double-clickable to launch the game. Absolute/relative paths may be an issue there though :(

(Edited 1 time)

Thanks for reminding me about .desktop files! Indeed relative paths seem to be not working at all, but there's a workaround (thanks to this SO answer), use %k in Exec line of .desktop file to get path to .desktop file itself, and than extract directory name:

Exec=bash -c "$(dirname %k)/launch"

.desktop file is also better than bare bash script because it may be displayed with custom icon, and even localized name.

UPDATE about icon: looks like relative-path icon is not possible. This time really :(

(Edited 1 time)

I have a simple prototype game using luxe engine, html export (https://jonathanhirz.itch.io/prototype-top-down-sh...) that won't launch in the itch app. It says WebGL is required to run. Game runs fine in Safari (I'm on macOS 10.12.1), so it looks like the browser the app uses doesn't have WebGL yet? Any ideas on how to fix this?

//edit - I realized this is because WebGL doesn't work on Chrome on my computer, and I think the itch app uses Chrome somehow. I guess it's up to the end user to get WebGL working on their computer then?


That's right, the itch app uses the same engine as Chrome/Chromium - which is usually pretty good at getting WebGL running, at least on Windows/macOS, I'm surprised it doesn't seem to work with your system, maybe it's a bug on their end?

We keep in sync with Electron, which keeps in sync with Chromium, regularly, so if it gets fixed upstream, itch will get the fix as well!

how can i open a file game

I have a WebGL game made with Unity that run on a Chrome browser - but not on itch.io app.


Can you post a link to your game?



Is the issue that it doesn't install? Games in draft are not yet supported by the itch app, see https://github.com/itchio/itch/issues/1080 - the problem will go away as soon as you publish the game.


Actually, I didn't bothered hitting the install button. Since it's a WebGL game, I thought that it would run on the app in the same fashion as the browser by displaying a rectangle with the game. =P

Now that the game is installed, it's working normally.

How do I select more than one file for download on the app?

Currently I have a demo and full price version (in draft). The app gives me a choice but it doesn't allow me to select both and / or I don't know how to select both. Then after installing the one there is no way I can get back to a place where I can select the other again - I have to uninstall whichever one I chose to be given the choice again.

Since my demo is different to my main game I foresee people will want both - the demo is a 1 hour game in itself. And I want to tell them how to do that in my download instructions, but I can't figure out if that's possible or how to do that myself. Is it possible?

Deleted post

I guess that you will have to speak to the dev and it's not an issue on the platform app.

(Edited 1 time)

how do i do that?

(Edited 1 time)

Hi. It seems .exe files which require admin rights dont work. I always get an error when I try to launch it (reported on github already a while ago for app "Antares"). Is it possible to change/fix this? Other .exe files work fine, it seems its the admin thing (exe has a shield icon). :-/



I replied on the github issue directly.

Thanks! :)