Itch.io integration plugin

Itch.io Integration Plugin

This wiki page contains some how-to's on common actions performed in relation to the itch.io integration plugin

Logging in

1. Open Alfae
2. Click on Plugins in the top right, click on Itch.io Integration in the dropdown menu that appears, then click on Log in
3. Press on the Take me to the api page link. This will open a browser and take you to the itch.io api keys page
   • Log in if you haven't already
4. Press Generate new API key on the itch.io page. The page will refresh
5. Press View on this newly generated key, then copy the key. Paste it into Alfae, and press Login

Installing a free game

Free games are not tied to your account, so they won't show up in the application by default.

1. Click on Plugins in the top right, click on Itch.io Integration in the dropdown menu that appears, then press Search free games/demos
   • If only the Log in option show, please log in first
2. Type a search query in the search bar and click Search
3. Press the Download button to temporairly add the game to your library.
   • The orange link opens the corresponding web page of the game in your default browser
4. Follow Installing a paid game from step 4 onwards

Installing a paid game

1. Log in if you have not already
2. Search for the game you want to install either by the search bar, or by scrolling trough all your games
   • Tip: Typing itch.io in the search bar will only show itch.io games
3. Click on a game you wish to install, then press Install
4. A menu will pop up asking you what to download. Download the game that's right for your platform
   • If a game provides build information, the version of the game is shown like [Version x.x.x]
   • If both a display name and a file name was found, the display name is displayed normally, and the file name is put between brackets ()
5. Wait until the game is downloaded
6. Launch the game by selecting the game, then pressing Launch
   • If launching brings you to a menu telling you that your Current preferred boot entry is invalid, select what executable you want to launch using the dropdown menu, then Save.
   • If you are on linux and are launching a windows game, you can configure what runner you are using to launch the windows game by selecting Set Boot Configuration in the More menu
     • If the Estimated platform is unknown, set a valid boot entry first