This is a mod which provides a data overlay for Zwift streaming. It is designed to work with OBS but may work with other software as well. It requires a paid subscription to Sauce for Zwift in order to work. It is set up to work at a resolution of 1920 x 1080.
- Create a folder titled SauceMods within your documents folder. For example:
C:\Users\Yourname\Documents\SauceMods - Unzip this mod into a subfolder within, the name is not important. For example
C:\Users\Yourname\Documents\SauceMods\obs-sauce
If you want to easily update the mod or try experimental features you can clone the git repository.
- Install a git client for your operating system
- Clone this repository into your SauceMods folder
- Update the mod by opening a command prompt, navigating to the mod folder, and typing
git pull origin main
This is the browser source for OBS, and cannot be added as a widget by itself. It is designed to be used at 1920 x 1080.
You can use the sidebar from the overlay by itself as a browser source. Suggested widths are between about 425px and 600px.
You can optionally filter the nearby riders list by a pre-configured list of riders. This is helpful if you race with multiple teams and don't want to mark / unmark everyone for each race. To set up a team open the server URL in a browser window, then click "Settings" under OBS. Click "Create team" and enter a team name followed by a list of comma delimited Zwift ID numbers (123, 1235, 6543, 1235); Then select that team from the dropdown menu. When TTT mode is selected in settings the roster will be filtered by this list.
This is a sauce widget you can use to display course notes along the route during events. You can set these up by editing pages/ds-notes.mjs. Each course is its own entry in the dsNotes constant. Use the route ID as the object key for the course notes.
"Play" the world's worst game while you Zwift!
These settings only affect the Sauce widget windows, not anything within OBS (which has its own settings instance).
- Start sauce
- Open Sauce's settings by clicking on the gear icon in the Sauce toolbar. Click on the "Windows" tab and scroll down until you see the mod. Click the checkbox to enable it. You may need to restart Sauce.
- Open the settings again and click on the URL of the server (most likely with a bunch of numbers in it). Click the link to open it in a new browser window. Scroll down and click on either "OBS Overlay", "Sidebar" or "Desert Bus." Copy the URL of the resulting page.
- Create a new Browser source in OBS. Enter the URL from the previous step.
- Set the width and height to 1920 and 1080, respectively.
- Once you start Zwift your data should show up on screen.
- Configure the mod options by clicking "Interact" in OBS and then right-clicking anywhere on the screen to bring up the toolbar. Click the gear icon to go to the settings page. Note: this will be visible on stream!
- Alternately, if yo have Source dock installed you can create a separate source for the settings panel and dock it to OBS
You will need to use a separate alert provider and create a browser source for each alert. KapChat is very easy to set up for chat. For more advanced options try Streamlabs' alert box.