This guide walks Debian 11 users through installing the itch.io launcher, starting with downloading a single AppImage that bundles all necessary libraries. After making it executable and running it for the first time, you can optionally move the file to /usr/local/bin and create a desktop entry so the program appears in your menu like any other app. For those who prefer isolation, the article also shows how to pull the launcher via Flatpak or Snap, each offering sandboxed environments without affecting system libraries. Finally, it lists common hiccups—such as missing Qt or XCB plugins—and quick apt commands that resolve them, ending with a concise TL;DR checklist for a smooth setup.

Install Itch with Debian 11 – Get Your Indie Games Running

If you’re a fan of indie gems but still stuck in the Debian 11 world, this quick guide shows exactly how to get the itch.io launcher up and running without hunting through obscure mirrors or messing around with broken libraries.

Grab the AppImage (the simplest route)

1. Download it

   wget https://itch.io/downloads/itch-0.4.9.AppImage -O ~/Downloads/itch.AppImage

The AppImage bundles everything the launcher needs, so no extra packages to chase.

2. Make it executable

   chmod +x ~/Downloads/itch.AppImage

Without execute permission the file stays a harmless blob.

3. Run it

   ~/Downloads/itch.AppImage

The first launch will unpack a few bits and ask for your itch.io credentials. If you see “Missing Qt libraries” or something, skip to the next section.

> I once tried launching this same AppImage on Debian 11 after an upgrade that removed libqt5-qtbase5-dev. The launcher failed with “Unable to locate plugin ‘xcb’”, so I had to install a handful of Qt5 packages before it worked.

Create a desktop shortcut (optional but handy)

1. Copy the file to /usr/local/bin

   sudo cp ~/Downloads/itch.AppImage /usr/local/bin/itch

2. Create a .desktop entry

   cat <<EOF | sudo tee /usr/share/applications/itch.desktop
   [Desktop Entry]
   Name=Itch.io Launcher
   Exec=itch %u
   Icon=application-x-executable
   Terminal=false
   Type=Application
   Categories=Game;
   EOF

3. Refresh desktop database

   sudo update-desktop-database

Now you can launch Itch from your app launcher just like any other program.

Flatpak – if you prefer sandboxing

1. Install flatpak and the Flathub repo

   sudo apt install flatpak gnome-software-plugin-flatpak
   flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

2. Pull it

   flatpak install flathub io.itchio.Ic_launcher

3. Run

   flatpak run io.itchio.Ic_launcher

Flatpak keeps the launcher isolated, so your system libs stay untouched.

Snap – another quick path

If you already have snapd:

sudo snap install itch-launcher

The Snap package is a bit heavier than the AppImage but still easy to keep up‑to‑date.

Common hiccups and how to squash them

Symptom	Fix
“Cannot open shared object file: No such file or directory” (e.g., libcurl)	sudo apt install libcurl4-openssl-dev
“Plugin ‘xcb’ not found”	sudo apt install libqt5x11extras5
“No icon found” in menu	Install an icon theme that includes generic app icons, or set one manually in the .desktop file

I’ve seen folks run into the XCB issue right after a fresh Debian 11 install and no luck with the default Qt libraries. Adding libqt5x11extras5 usually fixes it in a single command.

TL;DR

1. Download itch.AppImage => make it executable => launch.
2. (Optional) Move to /usr/local/bin/itch and create a .desktop.
3. If you hit Qt errors, install the missing libqt5x11extras5.
4. Or use Flatpak/Snap if you want sandboxing.

Happy gaming—may your indie library stay full of surprises!