Skip to content

OBS Lua Script to sound an alarm if you start dropping frames

Notifications You must be signed in to change notification settings

ThatGirlSlays/obs-script-dropped-frames

 
 

Repository files navigation

OBS Dropped Frame Alarm

OBS Lua Script which plays a audio alarm (media source) when OBS Studio rendering, encoding or network lag is detected, and draws a graph of recent dropped frames.

Requirements

Incompatabilites

OBS-Websockets connections will be disrupted when the alarm activates.

Usage

Add a media source for the alarm. A suitable sound file is provided with the script. Open Advanced Audio Properties for the source and change Audio Monitoring to Monitor Only (mute output).

Add a copy of the alarm source to every scene where you want to hear it.

You may configure the sample window for alarms, as well as the percent of dropped frames to alarm at.

A custom source is available for drawing a dropped frame graph in the sample period. It can be added to the source panel. You may want to hide it and use a windowed projector to view the graph yourself.

Source has settings for color of each layer - Rendering Lag (default purple), Encoding Lag (default orange), Dropped Frames (default yellow), and Congestion (default green).

Credits

Alert sounds: pup_alert.mp3 by willy_ineedthatapp_com Default Colors: (?"?) by sugar!

About

OBS Lua Script to sound an alarm if you start dropping frames

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Lua 100.0%