Resource icon

OBS Lua Whiteboard Source (Windows only) 1.3a

Whiteboard Source for OBS Studio (Windows only)

This script adds a new whiteboard source to OBS Studio that allows users to display live drawings on top of their scenes.

Each scene can have its own whiteboard, though the tool settings (color, size, etc.) are shared.

  • Download the .7z file and extract it somewhere.
  • Open OBS Studio, click the 'Tools' dropdown option, and then click 'Scripts'.
  • Hit the '+' button at the bottom left of the Scripts window, and add 'whiteboard.lua' from the extracted files.

  1. Add the whiteboard script to OBS (whiteboard.lua).
  2. Place a whiteboard source at the top of a scene. (Note: you may have to toggle the visibility of the whiteboard on/off once to activate it)
  3. Project your scene with either Windowed or Fullscreen Projector.
  4. Draw on your projected screen by left-clicking!
You can add hotkeys for the following actions in the OBS settings:

  • Cycle colors (Yellow, Red, Green, Blue, White, Custom)
  • Cycle sizes (this cycles through all the even pixel sizes, e.g. 2, 4, 6, etc.)
  • Toggle eraser on/off
  • Clear canvas
These settings are also exposed in the script properties, visible in OBS Studio's script menu when selecting the whiteboard plugin. Users can set more precise sizes and define the custom color, here.

Known Issues
  • Script settings windows does not update when hotkeys are used.
    • This is due to two limitations with the OBS script library:
      1. There does not appear to be a safe way to access and update the settings object outside of particular functions.
      2. The script settings in the script window do not refresh themselves in the UI when changed (notably, per-source properties don't have this problem).
  • Whiteboard source doesn't accept inputs after being added to a scene, or after the script is refreshed.
    • This is because the source is only interactable when it's active. There's unfortunately no way to check whether a source is currently active, so we rely on the triggers on transition between active and deactive to determine when to enable interaction. Certain situations do not trigger this transition (e.g. adding a new source, refreshing the script, etc.), hence the source never knows it's active.
  • Whiteboard source starts minimized sometimes.
    • Some users have reported that newly added whiteboard sources show up minimized. Setting its size to 'Fit to Screen' seems to resolve this.
mwelsh (TILT forums)
  • Like
Reactions: H4ndy and l33
First release
Last update
0.00 star(s) 0 ratings