Step by step tutorial

So you have discovered LioranBoard… I can only say: Welcome to the world of endless possibilities!

We will walk you through a step by step tutorial on how to set up LioranBoard, and connect it to OBS and your Twitch account. You will also learn how to create your first button, add a command and trigger it via Twitch chat.

1. Install all dependencies #

  • Download and install OBS Studio. As of now, LioranBoard does not support other streaming software.
  • Download and install OBS Websocket (4.X) This is how LioranBoard communicates with OBS Studio. LioranBoard will be compatible with OBSWS 5.0 and up once a stable version is released.

2. Download LioranBoard #

We recommend selecting 64bits release.

Unpack the zip file and place the folder anywhere in your computer, preferably in your non windows drive.

3. Launch LioranBoard #

Navigate to the unpacked folder and launch LioranBoard 2.exe.
Allow the app through the firewall if there’s a prompt and you’re ready to start!

4. Connect LioranBoard to your OBS #

  1. In your OBS go to Tools-Websocket Server Settings. Uncheck ‘Enable authorization’ (for easy setup, you can change it later) and press OK.

    OBS Websocket Settings
    OBS Websocket Settings
  1. In your LioranBoard click on OBS Connections at the bottom menu. Unless you changed your port in OBS-Tools-Websocket Server Settings or set up a password, you can leave everything at default and press Connect.
    You should see a yellow notification message OBS [Main Connected] and the status indicator for Main OBS in the left bottom corner should change from red to green.

    OBS is connected
    OBS is connected

5. Add Transmitter to your OBS Dock #

In your OBS menu navigate to View - Docks - Custom Browser Docks. Your new dock name can be Transmitter and the URL will be the path to the transmitter.html file located in your lioranboard/transmitter folder.

OBS Dock Settings
OBS Dock Settings

Press apply and you should see your new dock. If it does not pop up for some reason, you can always go to View - Docks - Transmitter.
Fit your new dock somewhere in your OBS screen as you see fit.

Transmitter in a dock in OBS
Transmitter in a dock in OBS

6. Connect Transmitter to LioranBoard #

In your LioranBoard-Settings menu, check Allow Stream Deck and Transmitter to allow Transmitter to connect.
In your Transmitter-status tab (in our OBS dock), you can now modify your connection settings.
Default IP address for Lioranboard is always and port is always 9425. Unless you changed port in your LioranBoard-Settings, you can leave it at its default value.
You must fill out the password if you decided to use one in LioranBoard-Settings menu.
Note that you only need to do this once, as your Transmitter will remember the previous settings and will attempt to auto connect next time.

Transmitter Connection Settings
Transmitter Connection Settings

In your Transmitter you should now see Connected or svg image next to LioranBoard. This means it is connected to your LioranBoard and listening for messages.

7. Link your Twitch account #

Linking your Twitch account to LioranBoard is a necessary step if you want to be able to listen to alerts and control your Twitch via LioranBoard.
You can link multiple Twitch accounts, however in this tutorial we will focus on connecting your main account.

  1. In your LioranBoard click on Twitch Connections button.
  2. Click on Open URL which should open a new browser window and redirect you to Twitch to authorize LioranBoard.
  3. Press Authorize and wait to be redirected again to see All good, you can go back to LioranBoard now message in your browser.
  4. Back in LioranBoard you should now see your Twitch account in the list!
  5. You can now optionally check which events to listen for and whether you want to Join Chat Channel for this particular Twitch channel. You want to also check Auto connect to Twitch Chat, else you will need to always press the Connect Twitch Chat button when you open LioranBoard to be able to receive and send chat messages from LioranBoard.
  6. Press Connect Twitch Chat to connect to Twitch chat.

    Active Twitch Connection
    Active Twitch Connection
  1. Now that your Twitch account is linked in LioranBoard, Pubsub status in your Transmitter should change to Connected or svg image.
    Remember you Transmitter must be running at all times to be able to listen to Twitch events.

    Pubsub connected
    Pubsub connected

8. Create your first button #

In this part of the tutorial we will learn how to create a button with a simple command and add a Twitch chat trigger to it.
You can follow the text instructions or click on to watch a short video.

  1. In your LioranBoard click on Add New Deck button. You should see a newly created blank deck named Deck 1. Double click on it.

  2. You will see an empty grid. This is your deck where you can create new buttons. Right click anywhere in the empty area and select Create Button or simply double click. A new empty button will be created. You can optionally add some text to it as well by right clicking on the button and selecting Edit Appearance.

  3. Right click on the empty button - Add Commands or double click on it.

  4. Click on the + symbol. A dropdown menu will appear. Click on Twitch Commands and select Twitch: Send Message (you can also just start typing message in the search box).

  5. Populate the fields:
    1. Message - Put a random text in there. For example Hello World!.
    2. Channel Name - Leave empty
    Press Save once you're finished.

  6. Back at our main deck view, right click on the new button - Edit Triggers. This is where you can assign a Twitch event (such as new subscriber or chat message) to automatically trigger your button.
    1. Click on the + sign and selected Twitch Chat from the dropdown menu.
    2. Remove the * in the Message field and populate it with !test.
    3. Press Save.

  7. Once you're back at your main deck view, press Save.
  8. We have now created a button that will send a chat message Hello World anytime it's triggered. We have also created a Twitch chat trigger which will execute the button any time someone types !test in your Twitch chat.

    Trigger the button manually from Stream Deck #
    1. Back in your main LioranBoard menu, press Stream Deck to open it. This is your Stream Deck where you can manually press buttons you create in your LioranBoard.

      Once launched, you will see connection settings. As we are just keeping everything at default in this tutorial, you can press Connect. Selected deck should be Deck 1. Press Load Deck and you should see your newly created button that we named Send message.

    2. While looking at your Twitch chat, click on the button in your Stream Deck. It should send a Hello World message to your chat!
      Important: Your LioranBoard must be running and connected to Twitch Chat (LioranBoard-Twitch Connections-Connect Twitch Chat).

    Trigger the button via your Twitch chat #

    Do you still remember the Twitch chat trigger you configured for your button? If you followed the tutorial, it should be !test.

    1. Try typing !test (or anything else you chose to be your trigger) in your Twitch chat while looking both at your chat and Stream Deck.
      Two things should happen:
      • You will see the button in your Stream Deck blink, just like when you manually pressed it with your mouse.
      • LioranBoard will respond back with Hello World in your Twitch chat.

Now you have learned how to create a button, add a command and trigger it via Twitch chat! You can find more information about the individual components, commands and triggers in the next sections of the documentation.