Skip to content
Michael T. DeGuzis edited this page Jul 2, 2017 · 17 revisions

Table of Contents generated with DocToc

About


Itch.io is a desktop application that you can download and run games from itch.io with. Additionally you should be able to update games and get notified when games are updated. The goal is not to replace the itch.io website.

The current implementation below uses Xephyr.

Native client logs

If you are interested in reviewing SteamoS logs regarding launching the original / native Itch.io client, I have attached them below. This is as of 20160203. Please be aware that several errors/warnings are typical to log output, such as "LD_PRELOAD" errors and "Slow image load" warnings.

Installing


Due to current issues building from scratch (uses newer Sid packages), a precompiled Debian package is available:

sudo apt-get install itch

Currently Itch.io functions in Desktop Mode, but not fully in BPM yet

sudo cp SteamOS-Tools/launchers/itchio-launcher /usr/bin/itchio-launcher

Create a desktop file:


Open the file as root

sudo vim /usr/share/applications/itch-launcher.desktop


Example:

[Desktop Entry] Encoding=UTF-8 Type=Application Name=Itch Launhcer Comment=Itch.io client Launcher Exec=itchio-launcher Icon=itch Terminal=false Categories=Applications;Games; Keywords=games;itchio;


Add "Itch.io" as a non-Steam game in Settings > Add Library Shortcut.

# Issues
***

## I get "Error on login: socket hang up"
This often happens with Network issues. Reboot SteamOS.

log:  http://slexy.org/view/s20Bbqig1m  
See: [this issues ticket](https://github.com/itchio/itch/issues/120) on the Itch.io github tracker.   

## I cannot add Itch.io from System > Add Library Shortcut

Note: These instructions are for the "vanilla" Itch install only.

Desktop files for SteamOS cannot have spaces in the Exec line (see [here](https://github.com/mdeguzis/SteamOS-Tools/wiki/Working-with-non-Steam-games)). You will need to edit the desktop file after installation:

Open the file as root

sudo vim /usr/share/applications/io.itch.itch.desktop


Change

Exec=itch %U


To

Exec=itch


Example:

[Desktop Entry] Encoding=UTF-8 Type=Application Name=Itch Comment=Itch.io client Exec=itch Icon=itch Terminal=false Categories=Applications;Games; Keywords=games;itchio;

Clone this wiki locally