OBS plugin providing a filter for automatically refreshing a browser source in a configurable interval.
- OBS 33+ 64 bit on Windows, OBS 32+ 64 bit on Linux and macOS (find older releases on GitHub for 29+ support)
- Windows 11
- Linux
- occasionally tested, but not regularly
- binary build created on Ubuntu 22.04 WSL environment, therefore linked against glibc 2.35
- macOS Monterey 12.0+
- both x64 (Intel) and arm64 (Apple Silicon) supported
Before installing make sure that OBS is not running.
The folder structure of the Windows .7z file already matches the plugin location introduced in OBS Studio 33.0, so it can be extracted either into C:\ProgramData\obs-studio or - when using portable mode - into the root directory of the portable installation. For the other operating systems see the instructions below.
🟦 Windows
For automatic installation just run the provided installer, then restart OBS. It installs the plugin into C:\ProgramData\obs-studio and needs admin permissions.
For manual installation extract the downloaded .7z file (= copy the contained plugins folder) into C:\ProgramData\obs-studio, or into the root directory of your portable OBS Studio installation.
OBS Studio 33.0 unified the plugin locations. Third party plugins are loaded from a single shared folder of the machine (or from the root folder of a portable installation), no matter where OBS Studio itself is installed:
Module <location>\plugins\xObsBrowserAutoRefresh\xObsBrowserAutoRefresh.dll
Data <location>\plugins\xObsBrowserAutoRefresh\data\*
<location> is either C:\ProgramData\obs-studio or the root directory of the portable OBS Studio installation. Note that portable launches ignore the ProgramData folder.
Legacy install locations (pre 33.0+)
Previous versions of this plugin were installed into the OBS Studio program folder. OBS Studio still loads plugins from these locations, but flags them as Legacy and will not load them from OBS Studio 34.0 onwards:
Program Files:
Module C:\Program Files\obs-studio\obs-plugins\64bit\xObsBrowserAutoRefresh.dll
Data C:\Program Files\obs-studio\data\obs-plugins\xObsBrowserAutoRefresh\*
ProgramData:
Module C:\ProgramData\obs-studio\plugins\xObsBrowserAutoRefresh\bin\64bit\xObsBrowserAutoRefresh.dll
Data C:\ProgramData\obs-studio\plugins\xObsBrowserAutoRefresh\data\*
The installer cleans these up automatically. When installing manually, move the DLL and the PDB file out of the 64bit folder into the plugin folder next to data and delete the old copies.
🐧 Linux
The folder structure in the downloaded .7z file is prepared so that you can extract the file (= copy the contained files) into your user home and on many systems this will just work already.
However, depending on the distribution and OBS installation method (manual, distro repo, snap, flatpak...) the location of this folder can vary, so if it doesn't work from the user home you might have to look around a bit.
Example locations for the plugin .so (and .so.dbg) file are:
~/.config/obs-studio/plugins/(The structure the .7z is prepared for)/usr/lib/obs-plugins//usr/lib/x86_64-linux-gnu/obs-plugins//usr/share/obs/obs-plugins/~/.local/share/flatpak/app/com.obsproject.Studio/x86_64/stable/active/files/lib/obs-plugins//var/lib/flatpak/app/com.obsproject.Studio/x86_64/stable/active/files/lib/obs-plugins/
Unfortunately the expected location of the locale, which can be found in the data folder, can vary also.
If you get missing locale errors from the plugin you can try to copy the "locale" folder found inside the data folder to:
/usr/share/obs/obs-plugins/<plugin name>/locale~/.local/share/flatpak/app/com.obsproject.Studio/x86_64/stable/active/files/share/obs/obs-plugins/<plugin name>/locale/var/lib/flatpak/app/com.obsproject.Studio/x86_64/stable/active/files/share/obs/obs-plugins/<plugin name>/locale
If in doubt, please check where other "en-US.ini" files are located on your system.
🍎 macOS
For automatic installation just run the provided installer, then restart OBS.
For manual installation extract the downloaded .tar.xz file (= copy the contained .plugin folder) into the OBS Studio library data directory. The default location for this is
~/Library/Application Support/obs-studio/plugins
To uninstall, remove the manually installed files or run the separately provided uninstaller package - don't get confused when it's acting like an installation process, all it does is uninstall the files and unregister the original package from the system.
The steps to update an older version of the plugin to a newer version are the same, except that during file extraction you need to confirm overwriting existing files in addition. On Windows, an update of a version that was installed to one of the legacy locations is best done with the installer, because it removes the old files automatically - otherwise OBS Studio keeps flagging the plugin as Legacy.
After installation open the filter settings for a browser source and add the "Browser Auto-refresh" filter, then configure the refresh interval to your liking. Find more detailed instructions on how to use the filter in this post.
Note that the filter will be active and browser refreshes will be triggered even if the eye icon next to the filter is disabled. Only when the browser source it was added to is hidden the filter will no longer trigger auto-refreshes on it.
-
Q: Will there be a 32 bit version of this plugin?
- A: No. Feel free to try and compile it for x86 targets yourself, last time I checked it wasn't fully supported in NativeAOT.
-
Q: What happens if I accidentally add this filter to a source that is not a browser source?
- A: Don't worry, nothing will explode. The plugin doesn't explicitly check for the source it's added to to be a browser source, but it searches for refresh button of the plugin and "clicks on it". If it doesn't find that button with the internal ID "refreshnocache" it will simply not do the refresh and instead write an error message about this to the OBS log. It was made that way so that the plugin would also work on modified/similar browser sources as long as they provide a button with internal "refreshnocache" ID.
OBS Classic still had a CLR Host Plugin, but with OBS Studio writing plugins in C# wasn't possible anymore. This has changed as of recently. The catch about this plugin is that at its day of release (January 12, 2023) to my knowledge it's the first OBS Studio plugin ever written in C# that has some real-world use. The very first without real-world use was this example plugin demonstrating the basic concept of writing an OBS Studio plugin using .NET 7 and NativeAOT.
Refer to the building instructions for my example plugin, they will also apply here.
Many thanks to kostya9 for laying the groundwork of C# OBS Studio plugin creation, without him this plugin (and hopefully many more C# plugins following in the future) wouldn't exist. Read about his ventures into this area in his blog posts here and here.

