Using antimicro on SteamOS

Bash wrapper

elmat0 has posted a neat bash wrapper script in issue #186. Using a script like that is an easy way to get antimicro to only be used for games that don't have controller support. For each game that you want to use antimicro for, you can edit the launch options of the game in the Steam BPM interface. antimicro will be closed once you exit the game so it will not interfere with normal navigation in Steam BPM.

#!/bin/bash
# Requires 2 arguments. First the profile to apply then the game executable.
PROFILEDIR="/etc/antimicro/profiles"

antimicro --hidden --profile $PROFILEDIR/$1.gamecontroller.amgp & $2; killall antimicro; wait;

The syntax for running the bash wrapper is similar to the following:

 /etc/antimicro/steamwrapper <profile> %command%

The %command% portion is required in the launch options so Steam will insert the proper command for launching the game when you select to play it.

In order to edit profiles, you will have to either launch antimicro in Desktop mode or use a Xephyr session. If you choose the Desktop mode route, make sure to have a profile located somewhere that the steam user can access it (by copying or permission edits) so that the steam user can utilize it when you launch a game. Going with the Xephyr method might be a tad more convenient depending on your set up. Here is a link to a page that has some tips on getting Xephyr running on SteamOS.

http://steamcommunity.com/groups/steamuniverse/discussions/1/620695877275390493/#c620695877306455248

Running via SSH

If you have a spare computer handy (ex. work laptop), you can utilize an SSH session with X tunnelling enabled in order to run antimicro. The main advantage of running it that way is that you can more easily edit profiles and be able to test those edits immediately.

You will have to have openssh-server installed on SteamOS. After getting the IP address of your Steam Box, you can log in to your Steam Box using an SSH session.

ssh -X <user>@<ip>

In order for antimicro to generate events on your Steam Box, you will have to either use uinput support or specify an alternative X display as a command line argument. Even when using uinput support, it is generally recommended to specify the X display of the SteamOS session so that antimicro will be able to disable mouse acceleration from the virtual mouse that is being used.

antimicro --eventgen uinput --display :0