Resource icon

OBS Lua Automatically Mute Audio Monitoring When a Source Is Muted 2.0

Download
Overview Updates (1) Reviews (1) History Discussion

Automatically Mute Audio Monitoring When a Source Is Muted - Python Version

Mute / Audio Monitoring Sync for OBS Studio​

Automatically synchronize Audio Monitoring with the Mute state of your OBS audio sources.

After recent OBS Studio updates, audio monitoring no longer automatically follows the Mute button for some audio sources.

This script restores that behavior: when a source is muted, its monitoring is disabled. When the source is unmuted, its previous monitoring mode is automatically restored.

What's New in Version 2.0​

Now rewritten in Python​

Version 2.0 has been completely rewritten in Python, providing better configuration handling and persistence between OBS sessions.

Configure Once — OBS Remembers It​

You no longer need to select your audio sources again every time you restart OBS Studio.

Simply configure the script once.

Your selected sources are automatically saved and restored the next time OBS starts.

Configure once. Restart OBS. Everything stays configured.

Features​

  • Automatically detects all audio sources available in OBS.
  • Simple checkbox selection for choosing which sources should follow the Mute state.
  • Automatically disables audio monitoring when a selected source is muted.
  • Automatically restores monitoring when the source is unmuted.
  • Preserves the source's original monitoring mode:
    • Monitor Only (mute output)
    • Monitor and Output
  • Automatically saves your selected sources.
  • Automatically restores your configuration after restarting OBS Studio.
  • No need to reconfigure the script every time OBS starts.
  • Works with virtually any OBS source that outputs audio, including:
    • Microphones
    • Browser Sources
    • Media Sources
    • Desktop Audio
    • Application Audio Capture
    • Video Capture Devices
    • Capture Cards
    • Other audio-enabled OBS sources
  • Does not modify volume levels.
  • Does not modify audio filters.
  • Does not modify audio tracks.
  • Does not change any other source settings.
  • Lightweight polling with minimal CPU usage.

How It Works​

  1. Add the Python script to OBS Studio.
  2. Select the audio sources you want to synchronize.
  3. That's it.
When a selected source is muted, the script temporarily disables its audio monitoring.

When the source is unmuted, the script restores the monitoring mode it was using before being muted.

Your source selection is saved automatically, so you don't have to configure everything again after restarting OBS Studio.

Example​

If your microphone is configured as:

Audio Monitoring → Monitor and Output

When you press Mute:

Monitoring → Off

When you press Unmute:

Monitoring → Monitor and Output

The same applies if the source was originally configured as Monitor Only.

Ideal For​

This script is especially useful for:

  • Live streaming
  • Sports broadcasting
  • Live event production
  • Podcasting
  • Remote productions
  • Multi-source audio setups
  • OBS installations with multiple microphones or capture devices
If your workflow relies on OBS audio monitoring and you expect monitoring to follow the source's Mute / Unmute state, this script restores that behavior automatically.

Version 2.0 Highlights​

Python version • Persistent configuration • Automatic source restoration • Configure once and forget it
Back
Top