Skip to content

Automate muting when switching into specific scenes, and display mute status on stream

License

Notifications You must be signed in to change notification settings

mvaldesdeleon/obs-mute-automator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 

Repository files navigation

OBS Mute Automator

OBS Mute Automator is a python-based OBS script that provides a couple of automations around muting your main microphone Audio source.

Mute Indicator

Enable and disable a Video source depending on the mute status of the main microphone Audio source.

Automatic push-to-talk

Enable and disable Push-to-talk on your main microphone Audio source depending on the current scene.

Installation

Clone this repository, or just download the mute-automator.py file, and add it into OBS via the Script dialogue found under the Tools menu.

Python scripts require Python to be installed on your computer. Due to limitations with OBS, at the moment Windows users must install Python 3.6.x. The official download links for the Windows installers for Python 3.6.8 are available here.

Configuration

Configuration screen

Main microphone: Audio source to be used as the main microphone.
Mute indicator: Video source to be used as the mute indicator.
Reverse behavior/On-Air indicator: Treat the mute indicator as an On-Air indicator instead. It will be enabled when the main microphone is unmuted, and disabled when its muted. Header decorator: Used to identify your Scenes structure. If you use Separator scenes named ### My Separator ###, then you would use ### as the decorator.
List of characters used in the decorator: Used to strip down the decorators from the Separator scenes' names. Be sure to include whitespace characters if needed. For the above example, you would use # as the list of characters.
Header key to enable Push-to-talk: Used to enable Push-to-talk when Scenes from this Header are enabled. Separator scenes' names are stripped from separators, lowercased, and spaces are replaced by hyphens. For my current configuration, I use title-scenes.
Reload scenes: Click to refresh when updating adding/removing/renaming scenes, or changing the Separator naming convention.
Print debug messages: Log debugging information into the Script Log provided by OBS.

For reference, this is how my current Separator scenes look like:

Separator scenes

Caveats

The push-to-talk capability of OBS does not interact with its mute capability. What this means is that enabling push-to-talk will not trigger the mute indicator.

Roadmap

  • Increase configurability.
    • Expose header key for enabling push-to-talk.
    • Offer to toggle the behaviour of the mute indicator so that the Video source is enabled when the main microhone Audio source is unmuted.
  • Allow enabling/disabling each of the main features.
  • Clean-up code.

References

License

BSD-3-Clause

About

Automate muting when switching into specific scenes, and display mute status on stream

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages