Displaying a second Overlay Instance

Displaying a second instance of your Overlay could be useful if you want to display a different overlay you can see when driving and compared to your overlay that your stream viewers can see.

Several overlays connected to the same room can now display components with instance specific settings (variables) as well as instance specific styles (style overrides).

You may have noticed already that all Variables you currently use begin with Overlay. and all Style Overrides being with .overlay Overlay is the name of your overlay when you have no second instance defined.

To display any information on a second instance we need to define a new name for it. In our example we will use Hud. If you want to use this second instance in the Live HUD App then you will simply enter Hud in the Instance Field, if you want to display this second instance in OBS then add &instance=Hud to the end of your url.

Now your new instance will display no overlay and your original instance will be unchanged. This is because we have yet to define any variables or styles in this new instance.

Tech Support & Community Discord

Setting up a second Instance is a reasonably advanced feature. You should be familiar with the processes in Remote Control Tab and Editing CSS Styles before trying to to create a second Instance. If you have any other questions make sure you join us in our Discord support server!

Define Variables

For our example let’s first just add a Track Map to our new instance. The easiest way to find the variable to show the Track Map is to press F4 in iRacing Live Timing to open the remote control tab and then press F2. You have now entered Edit Mode. Click on the button that displays the Track Map view you want (in this example Position).

You will see in the F2 Edit Panel a field labelled Left mouse button click has now populated. This is the variable name for the button you have selected. You can now do one of 2 things:

  • If you don’t want to make any adjustments to the Track Map when you are using the overlay, then click into the variable field, copy the variable and paste into Initial Variable Values. Once pasted then replace Overlay with Hud. The track map will now be displayed in your new instance.
  • If you do want to be able to make adjustments to the track map (such as Hide or change the data displayed) then we will need to create a new button. With the button selected and the F2 Edit Panel open, click Copy and then Paste. The button has now been duplicated. Drag the button to a free space, click into the variable field and replace Overlay with Hud. You will need to complete the same steps for the Hide button or other data options you want. Now when you click the button, your second instance will respond.

Define Styles

Depending on the Component you are working on, you have may have noticed the Track Map (for our example) is displaying in a different size and/or position. This is because we have not defined any Styles for our new instance.

Find the Component Class in Style Overrides (if you can’t find the correct class, then visit the specific Component Manual Here for the CSS code you can copy), copy the code and paste at the bottom of the page. Replace .overlay with .hud (no capitalisation), click Apply and you will see the Component resize/reposition. You can now make any normal CSS adjustments to this new code.

Rinse and Repeat

So hopefully you now get the idea, for every component you want to display in this new instance you need to define both the variable and the style.

If you are working from a replay file you will need to ensure you create the Hud.ReplayFromFileIsLive = "True"; variable just as you already do for your standard overlay.

This is an advanced feature and so will take some time to setup and understand. Be sure to jump into Discord for any help you need!

14 Day Free Trial

£ 0

14 Days

  • New Customers Only
  • iRacing Live Timing
  • iRacing Live HUD
  • iRacing Live Streamer
  • Discord Customer Support

Try now!

Choose Your Rolling SubscriptionMost Popular

£ ?

£8.33 per Month Ex-Vat
or £83.33 per Year Ex-Vat

  • iRacing Live Timing
  • iRacing Live HUD
  • iRacing Live Streamer
  • Discord Customer Support

Sign up now!

30 Day Access

£ 8.33

Per Month Ex-Vat

  • iRacing Live Timing
  • iRacing Live HUD
  • iRacing Live Streamer
  • Discord Customer Support

Sign up now!

1 Year Access

£ 83.33

Per Year Ex-Vat

  • iRacing Live Timing
  • iRacing Live HUD
  • iRacing Live Streamer
  • Discord Customer Support

Sign up now!

© 2019 SDK Gaming. All Rights Reserved