Download and install
Download Bitfocus Buttons USB-Relay file from bitfocus.io and double click it in the downloads folder
Answer Yes on the dialog box that pops up.
You also have to agree to the EULA
If you want the USB-Relay to be run as a service on windows,
always starting up in the background and making any Stream Deck connected to the PC as a network device, just click Next to continue.
If you want to control when the USB-Relay should be run, uncheck the Install and start as a Windows service box and click Next.
To let Windows install to the default location Click on Install.
When the install process is done, just click on Close.
Run the Application
If you selected to run as a Windows service your job is done and the USB-Relay has started and have made any Stream Deck available as a network device. If you selected just to install the USB Relay, you can navigate to C:\Program Files\Bitfocus Buttons USB-Relay if you selected to use the default location and just double click on the application.
A command line window will start up, showing you that the application has started.
You can also create a shortcut on the desktop, we have included a Icon to make it recognizable
When your USB-Relay is up an running, and announcing it self on the network.
Your Buttons installation will be able to discover it, Click on the USB-Relay and Adopt it in to Buttons.
The Config window will show the details for the USB-Relay, and also show you the Stream Decks related to the USB-Relay You can adopt them either in the config window or back in the Surface window.
You are now ready to use the remotely Connected USB Stream Deck surfaces in your Buttons installation.
If you want to shut down the USB-relay, you can click in the Command Line window and Pres CTRL+C or just close the window.
Running as a service
If you are running the USB-Relay as a service and want to stop it you need to use the services.msc
press win+r which will bring up the run dialog and type in services.msc This will bring up the services management console.
from here you can stop and start the service if needed. If you want to stop the service from automatically start on startup/reboot, right click on the Bitfocus buttons USB-relay line and select properties.
This will bring up the properties for the service and you can set the startup type from the dropdown menu.
Command line switches
-help
Show the help text
-accept-cert-change
Accept and permanently trust a changed server certificate. Use when the server certificate has been intentionally replaced.
-buttonsAddress string (-buttonsAddress xxx.xxx.xxx.xxx:port)
If running usb-relay in client mode, specify the address of the Buttons installation to connection to. If not specified, runs in server mode.