Indie game storeFree gamesFun gamesHorror games
Game developmentAssetsComics

Meet the new and improved itch app!

In case you hadn't heard: our desktop client, is new, improved, and lightning fast! (And you can download it now by clicking here) Our engineer Amos has been working on this update for what feels like forever and the results are incredible. The app moves faster, the UI is sleeker, and you can load up your entire library before you can even blink. Fresh from his shift in the code mines, I caught up with Amos to talk about what's new in the app.

Hi Amos, you’re back on the blog! Last time you were here you talked about what was coming up for our desktop client, itch. What have you been working on since then?

Hey Spencer, I can't believe it's been over a year!

Looking back at that previous post, it seems what I've been up to is: more of the same, but better. butler has been doing great. We've recently reached 100'000 builds pushed with it. I remember when "32GiB" was a comically large upper bound we set for builds, now it's not unusual for games to flirt with that limit.

In 2017 I brought up patch optimization, for even faster game updates - but it was still an experimental feature, hidden behind an option. It's enabled by default in itch v25, and we've made it even faster since. The backend has seen a lot of changes as well: we've overhauled the entire API, I've rewritten build processing to be more parallel (thus faster!) and more reliable. For example, an 1.5GiB game takes about 40 seconds to process now.

The itch app and butler were originally custom-built for Finji, and remembering that always makes me smile. They've both come so far! I was checking the analytics around itch v25's release, and the total amount of downloads for the app (including updates) was around 2.5 million! That's crazy.

Last but not least, I've been enjoying working with Jesus more closely. He's been incredibly helpful in getting important updates shipped (including itch v25). A breath of fresh air!

So what has changed in v25?

Well... how deep do you want me to go? I have a five-part postmortem in draft, and it barely covers the first six months of development!

It'd be quicker to list what hasn't changed. It's still cross-platform (available on Linux, macOS and Windows). It's still open-source. It's still translated in over 20 languages (although, many of those are partial translations). It can still be used offline. And it's still definitely the best way to play games.

Apart from that, there's not much left untouched. When I took over the desktop app project in late 2015, I had never done this before. I had worked on web stuff, and audio stuff, and compiler stuff, and game stuff - but not "desktop app that can install almost anything" stuff. I've tried to clean up things gradually - fixing bugs as they appear, trying to prepare for the next feature, cleaning up the shortcuts I took for a particular release, etc.

But it got complicated. It took longer and longer to get anything done within the codebase. Making new builds was slow, testing them was slow, regressions starting popping up over and over - I was not a happy camper. It got to a point where I would groan any time someone suggested a change to the app.

So when we reached a point where no one was complaining too loudly about lack of features, I started switching out essential parts of the app with other, better parts. I knew it was risky, and I knew I wouldn't get it "right", even after years of learning more about the problem. So I focused on just a few angles:

  • It needs to be small
  • It needs to be fast
  • It needs to be reliable
  • And most importantly: it needs to be easy to develop and easy to update

That all falls in "easier said than done" territory. That's why I ended up replacing almost everything!

After 2 years of organic growth, the app's dependencies (third-party components) were all over the place. I've always had a hard time deciding whether to use someone else's work (and not reinvent the wheel), or to just roll our own. Starting that big overhaul meant re-evaluating all those decisions.

I went through all dependencies one by one and eliminated most of them. Then I took a closer look at packaged builds, identified unnecessary files, and wrote a cleanup tool to eliminate them.

I decided to adopt SQLite to store local data (all your games, collections, etc.), and then I rebuilt everything on top of it four times. This was a big win for startup time: v23 used to take over 10 seconds to start up for me because of the size of my library!

I evaluated multiple solutions for compiling and bundling TypeScript code - some of which came out during itch v25's development - and found a compromise that's both friendly in development and makes for small and fast production builds. For example, in itch v23, all the app's code was loaded on start-up. Now it loads only what's needed, when it's needed. It makes a noticeable difference.

I took all the "business logic" (querying the API, installing, updating, launching, sandboxing, uninstalling) and moved it to butler. Instead of shoving everything in one project like I used to, I separated each concern in its own separate project - with separate tests and roadmaps.

I got rid of more stuff. We were using a third-party solution to distribute and update the app on Windows and macOS. But why not use our own solution? butler is solid now, right? So now, everything is distributed directly via The app, its installer, butler, prerequisites like the DirectX runtime, the Linux sandboxing helper - everything. It's dog food all the way down.

The app was almost ready. But it didn't feel new - it just worked a lot better. So I started redoing parts of the user interface. In the process, I discovered and fixed more bugs, and added more features that were real easy to add now!

I'm omitting a lot here - it truly was a wild ride. And if you think I didn't get technical enough, well, you'll love the post-mortem :)

What do these changes mean for users?

First of all, please remove all traces of the previous version from your computer, grab v25 from and give it a shot. It should speak for itself.

But honestly? I hope nobody notices anything. The app should fade into the background, like a soundtrack. It'll take up less space on your disk, less of your RAM, and less of your CPU. It'll quietly do the work and let you experience all the wonderful stuff creators have been uploading to for the past five and a half years. If you encounter an issue, there's a much better chance we'll be able to track it down and fix it (did I mention v25 comes with a new feedback system?). Then again, there's a good chance you won't encounter it at all.

If you want to contribute to the app, it should be easier than ever to get started. If you just have a suggestion, it might just ship in a matter of hours, not weeks.

Do you have a favorite feature that’s been updated?

Yes! I get really excited about fundamental stuff though, so it's going to be a niche answer.

Up until now, when installing a game, the app first downloaded an archive to disk, and then extracted it. It was fine for a while, but when you started installing games in the 10GiB club, it quickly became a problem. Worse, we kept the archive around, in case you wanted to do a clean re-install of the game.

But sometime in 2016, we figured out how to access remote files (that live on a server probably an ocean away from you) as if they were right here on your computer. That meant we could extract archives while downloading them.

But that wasn't good enough. What if the download got interrupted somehow? What if you just wanted to pause it for a while? Would you have to start over again? That gets old quick, especially if your internet speeds are on the potato end of the spectrum. So we tried something crazy. What if we could save the state of the decompressor on your disk, so that we can resume any time, no matter what happens (downloads paused, app quit, computer reboot, catastrophic electrical failure).

And it worked. For .zip files at first, and then we figured it out for .tar.gz. And for .tar.bz2. And for brotli (the compression algorithm we use for butler patch file). And then we managed to convince 7-zip to do almost the same thing for all other archive formats we support. It took a lot of work, but everything is resumable now. When I'm down, I just hit that pause & resume button, and remind myself of all the pieces working together to make that happen seamlessly.

By the way, that's how itch v25 determines how much disk you need to install a game! In that "Install" dialog, it opens the remote file, figures out what format it's in, gathers information, and provides an (often pretty accurate) estimate. That's why it takes a second or two - it's doing a lot of work behind the scenes.

The work never ends, so I have to ask: What’s next for the itch desktop client?

Well, we've had a bunch of folks complain that the interface of the app is powered by Electron. So I'm thinking of getting rid of the interface altogether. No pictures for you. Just text. No, you know what? Not even text.

In all seriousness, I'm not sure yet. I've been working on this overhaul for so long that I need to take a breather and evaluate which of the many directions we should take now. I'd like to improve Linux compatibility. I'd like to resume work on capsule. I'd like to finally ship collection editing in-app. And I'd like to improve integration between the website and the app - they've been developed pretty independently of each other, and it shows.

There's really no shortage of ideas. Time will tell!

Support this post

Did you like this post? Tell us

What is is an open marketplace for independent game creators. It's completely free to upload your content. Read more about what we're trying to accomplish and the features we provide.

Leave a comment

Log in with your account to leave a comment.

ive been trying to upgrade the itch app and everytime i download the setup, its the same one as the old one

it isnt upgrading, its just constantly making me download the old version and ive tried to download a game but it says there is no app for them to be downloaded (meaning it didnt get upgraded)

am i dumb or is it just not working

Hate to say it, but I find the new interface far less useful than the old one, at least for the developer community. Problems I am having with it (as a developer):

  1. It *seems* to check for updates (on the launch page it names the correct current version), but when I actually hit the Launch button, it *has not updated*. Why? This all used to happen automatically in the background. I would elevate this to a bug actually. When the app main page says "ver. y" is the latest, and instead (older) "ver. x" actually launches, this is a problem!
  2. So now in order to get the game to actually update, I have to hit the "Settings button" and dig down through  a couple more menus ("Manage" then "Check for Updates") to get it to actually *do anything* with the update! Very cumbersome. Those buttons used to be on the *main* program app page (bottom right corner). I'm not sure who thought it was a good idea to bury them 2 layers down.
  3. As a developer, the ability to get to the Local Files is essential. This too has been buried 2 layers deep, when it use to be a button on the main app page. Again, very cumbersome to get to when it used to be easy.

Overall, I cannot say this is an improvement, at least for those of us who are developers. Unless someone points out what I am missing, I'll be digging back through my archives to try and find an old desktop install file and see if I can get the original, more convenient version back.


It's not immediately obvious, but you can right click on game thumbnails to get a context menu that the actions you're looking for immediately available. Hope that helps!


Also, regarding updates. Can you tell us which game you're having the issue with? If a game isn't using our command line upload tool, butler, to push builds, then there's no clear update path. This might be what's causing the issue you're seeing.

So, let me get this straight here Amos. At the time of this post, you have a five-part postmortem draft of everything! that went into making this new and improved itch app and it doesn't even cover the whole first year of it? How long is the final draft going to be, then?


It is really impressive how awesome itch keep going!!!!!


Deleted 3 years ago
(2 edits) (+1)

Perhaps there are some people who don't  want javascript apps running on their computer instead of say a native C++ application or would prefer software that isn't running on an interpreter. Also not everyone wants to run a whole instance of the Chromium browser with every application... They'll just have to handle their game downloads themselves I guess. I'm not really sold on javascript for desktop applications, but here I'll take an application over none

Great work!

I don't like how the download dialog pops up. Is it possible to integrate with the main window?


Will the v23 app update itself to this eventually, or is uninstalling / reinstalling required?

Admin (1 edit) (+1)

Version 23 will not update automatically, we've replaced the updating system. For older app users we'll be putting an upgrade notification on their homepage when they start the app. You'll have to redownload the installer from

Your library and settings will copy over when you update to 25.


I've been waiting for the an app update, it's been awhile. Great work!


Great post, you can definitely hear the enthusiasm Amos has for the platform. Thanks for your hard work :)