Table of Contents

Installing An OBS Plugin

When you download an OBS plugin you will either get an installer which will auto install the plugin or you will download a bunch of files to place into the correct directory/directories. This page tries to set out the steps required for manual installation.

Windows Install – Older Plugin Versions Note

From version 2.0.12 onwards, the plugin no longer provides a Windows installer. This is because the OBS plugin template code (used by this plugin) was removed by the OBS team.

If you are installing a newer version of the plugin into the ProgramData folder and have an older version already installed, you will need to manually remove those older files once. After this clean up, future plugin updates will simply overwrite the existing plugin folder in C:\ProgramData\obs-studio\plugins.

Older versions of the plugin installed files directly into C:\Program Files\obs-studio. You will need to delete these files, as they may interfere with the new installation.

Delete the following files/folders if they exist:

Windows - Standard Install

Plugin Files

You should have a zip file that extracts into a folder that contains the plugin folder inside. This should be named obs-plugin-countdown. It will contain two sub folders:

Plugins are usually built for either 64-bit or 32-bit OBS. From v28+ OBS is only available in 64-bit on Windows.

Install Steps

OBS plugin files should be located in the following folder:

C:\ProgramData\obs-studio\plugins
Note: The ProgramData folder is a hidden folder on Windows. To see hidden files and folders:
- Open File Explorer from the taskbar.
- Select View > Show.
- Select Hidden items to view hidden files and folders.

Step 1 - Main Plugin Files

Copy the plugin folder, in this case named obs-plugin-countdown to the following folder location:

C:\ProgramData\obs-studio\plugins

Step 2 - Restart

Restart OBS to detect the new plugin.

Windows - Install Into OBS Folder

If you want to install the plugin for portable stand alone installs of OBS you can copy the files/folders into the OBS folder itself following these instructions.

Plugin Files

You should have a zip file that extracts into a folder that contains the plugin folder inside. This should be named obs-plugin-countdown. It will contain two sub folders:

Plugins are usually built for either 64-bit or 32-bit OBS. From v28+ OBS is only available in 64-bit on Windows.

Install Steps

Locate the folder where you have the portable version of OBS installed. The instructions below use the placeholder OBS_Portable for the location of OBS. For example, if OBS is extracted to:

D:\obs

Step 1 - Main Plugin Files

Copy the .dll and .pdb files from the plugin ZIP (located under obs-plugins\64bit or obs-plugins\32bit) to:

{{OBS_Portable}}\obs-plugins\64bit\

(or 32bit if it’s a 32-bit plugin)

Example:

D:\obs\obs-plugins\64bit\

Step 2 - Data Folder

If the plugin includes a data folder, locate it inside the plugin ZIP:

{{main-plugin-folder}}\data

Go to the following folder location:

{{OBS_Portable}}\data\obs-plugins

Inside this location create a new folder called the plugin name (same as the unzipped plugin folder name i.e. obs-plugin-countdown)

Example:

D:\obs-studio\data\obs-plugins\<plugin-name>\

Copy the files and folders inside the unzipped data folder into this new location. There should at least be a folder called locale inside the data folder.

Step 3 - Restart

Restart OBS to detect the new plugin.

Mac OS

Plugin Files

Generally, you should have the following types of files for the plugin:

Install Steps

Step 1 - Plugin Folder

Copy the .plugin file into the following folder on your Mac:

~/Library/Application Support/obs-studio/plugins

Note: The Library folder is a hidden folder on MacOS. Use the following command to toggle the view of hidden files and folders.

CMD + SHFT + .

Step 2 - Restart OBS

Restart OBS to detect the new plugin.