🌐 Networked usage
SISR can be used over the network to forward controllers, Keyboard/Mouse for game streaming scenarios
This also allows you to use a Steam Deck (or similar devices) as dedicated controllers without the need to stream the entire game
SISR also forwards any keyboard/mouse inputs (if --kbm=true is passed as launch argument)
This includes inputs from physical keyboards/mice connected to the hosting machine,
as well as Steam Input keyboard/mouse bindings and the Steam on-screen keyboard
No direct Deck passthrough
SISR does not directly passthrough the Decks built-in controller hardware
(or any direct controller passthrough, for that matter)
Instead, SISR forwards Steams Virtual Controllers created from the Decks inputs
as Xbox360 controllers and a dedicated Keyboard/Mouse device.
While still not perfect, this approach circumvents many issues present in direct USBIP/VirtualHere passthrough solutions.
An explanation on why this can be preferable over other solutions can be found in the FAQ
Installation
Installation for networked scenarios differs slightly, but is explained in this guide
Receiving Machine (e.g. Gaming PC)
On the machine that will receive the forwarded controllers/Keyboard/Mouse (e.g. your Gaming PC) you will not need to install SISR itself, only it's dependencies, USBIP and VIIPER
USBIP
Refer to the USBIP setup guide
SISR previously setup
If you have previously installed SISR on the receiving machine, USBIP should already be setup correctly and you can skip this step
VIIPER
SISR previously setup
If you have previously installed SISR on the receiving machine, VIIPER should already be setup correctly and you can skip this step
For networked scenarios you will have to install VIIPER as a background "service".
(VIIPER is used by SISR to emulate controllers!)
VIIPER provides easy to use installation scripts for both Windows and Linux.
In a PowerShell run
This will
- Install VIIPER to
%LOCALAPPDATA%\VIIPER\viiper.exe - Set the VIIPER server to start automatically with Windows
- Start the VIIPER server immediately
USBIP not included
The VIIPER install script does not install/setup USBIP. Make sure a USBIP-client is installed and configured before installing VIIPER.
The SISR install script should include everything you need, though
In a terminal run
This will
- install VIIPER to
/usr/local/bin/viiper - Creates systemd service:
/etc/systemd/system/viiper.service - Enables and starts the VIIPER service immediately
USBIP not included
The VIIPER install script does not install/setup USBIP. Make sure a USBIP-client is installed and configured before installing VIIPER.
The SISR install script should include everything you need, though
Refer to the VIIPER documentation for more details and information
Authentication/Password
VIIPER requires a password to connect (from non-localhost) for security reasons.
You can find or change the password (on the machine running VIIPER) in:
- Windows:
%APPDATA%\\VIIPER\\viiper.key.txt - Linux (user):
~/.config/github.com/Alia5/viiper/viiper.key.txt - Linux (root/systemd):
/etc/viiper/viiper.key.txt
You can also set a custom password by creating/modifying the file above and restarting the VIIPER service
Controller hosting machine (e.g. Steam Deck)
On the machine that will host the physical controllers/Keyboard/Mouse (e.g. your Steam Deck) USBIP and VIIPER are not required, only SISR itself
Marker shortcut
You should not re-use the "SISR Marker" shortcut or add the --marker launch option here!
- Add SISR as a non-Steam game in your Steam library
Provide the following flags as launch options-w -f --wcd true --kbm true --viiper-address <RECEIVING_MACHINE_IP>:3242 --viiper-password <VIIPER_PASSWORD>
show-window, fullscreen, continuous drawing, keyboard/mouse emulation, other machine address
Click to reveal screenshot
Example Steam shortcut for using a Steam Deck as a dedicated controller
Multiple Configurations
You can add SISR multiple times as non-Steam game to have multiple different Steam Input configurations available!
- Launch the newly created shortcut from Steam
This will start SISR and create virtual controllers, as well as forward Keyboard/Mouse inputs to the receiving machine
Multiple device forwarding
SISR will not only forward the Steam Decks built-in controller,
but any other controller that is connected to the Deck (or other PC) as well!
(As long as the controller is picked up by Steam)
SISR overlay
If you want to stop/start forwarding or change settings while in-game,
you can toggle the SISR overlay by using the keyboard-shortcut or controller-chord
(CTRL+SHIFT+ALT+S, LB+RB+BACK+A ("A" button needs to be pressed last))