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 on the site if you have not 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. Open Alfae
2. 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 the only option is Log in, please log in first
3. Type a search query in the search bar and click Search
4. Press the Download button to temporarily add the game to your library.
   • The orange link opens the corresponding web page of the game in your default browser
5. Follow Installing a paid game from step 5 onwards

Installing a paid game

1. Open Alfae
2. Log in if you have not already
3. 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
4. Click on a game you wish to install, then press Install
5. 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 are found, the display name is displayed normally, and the file name is put between brackets ()
6. Wait until the game is downloaded
7. Launch the game by selecting the game, then pressing Launch.
   • This may bring up the configuration menu. Refer to Configuring a game, specifically the Boot entry section for more info

Configuring a game

The configuration menu allows you to see where a game is installed, add additional commandline arguments and set the boot entry of a game

1. Open Alfae
2. Click on an installed game, then click on More, then click on Config/Info
3. Make edits to the configuration of the game
   • Install location: Shows where the game is installed. Can be clicked to navigate to that folder
   • Commandline args: Supply commandline arguments to be passed along to the game
   • Boot entry: The executable that should be launched when the game is launched. On install, the game gets scanned for all executables, and put into this boot entry list. When multiple executables are found, the user is forced to select a specific executable.
4. Press Save to save your changes

Uninstalling a game

1. Open Alfae
2. Click on an installed game, then click on More, then click on Uninstall
3. Press Uninstall on the popup that pops up

Adding installed games to Steam

You can add all installed itch.io games, including (cropped) cover art to steam

1. Open Alfae
2. Click on Plugins in the top right, click on Steam Exporter in the dropdown menu that appears, then click on Add games to steam
3. Restart steam to see the changes