Resource icon

Pixel Match Switcher 0.31.8-alpha

Supported Bit Versions
  1. 64-bit
Source Code URL
Minimum OBS Studio Version
Supported Platforms
  1. Windows
  2. Mac OS X
  3. Linux
Pixel Match Switcher

Pixel Match Switcher
can trigger switching scenes, changing visibility of scene items and filters, and other actions in response to pixels of video being matched against image templates.
  • Considerable amount of options is available for customizing the matching rules and the switching behavior.
  • Significant effort has been made towards a quick and user-friendly creation of match rules.
  • An individual matching image triggers transition to a specific scene, and several match entries (each with their own scene target) can be arranged in a priority-ordered list.
  • Other actions can be triggered independently of each other:
    • scene item on/off
    • filter on/off
    • audio source mute/unmute
    • simulated hotkeys (must be assigned)
    • write to file (append or truncate)
    • frontend actions
      • streaming start/stop/pause
      • reacording start/stop/pause/unpause
      • replay buffer start/save/stop
      • take screenshot
      • virtual cam start/stop
Foreseeable Use Cases
  • Streamers often like to have displays with a bigger streamer-cam and/or ads when they are in a game menu, or some other “non gameplay” area of the game.
  • Streamers often need to hide certain elements of game content, so they don’t get stream-sniped by people who want to gain an advantage by watching their stream while playing against them. Currently, streamers handle these cases manually, by manually switching scenes everytime, either with the OBS UI or by assigning hotkeys.
  • Tournament broadcasters may wish to provide video overlays to identify participants and their team, or to show the game score. These could be activated or hidden automatically, in reaction to specific in-game graphics.
  • Generally speaking, any use case where a region of a video frame will contain predictable pixels that should trigger one of the supported actions

Requires Features Implemented in the OBS Fork

Presently, the plugin requires a special atomic-effects fork of OBS to function. We provide installers of the forked OBS with the plugin included to make everything easier to try out.



User Resources
Atomic Effects Fork of OBS

Pixel Match Switcher plugin requires effect results and atomic counters to work. These precursor features are not present in the mainline of OBS Studio at the moment of writing. We provide the atomic-effects fork to introduce these key features into OBS and make our plugin possible. Effort is being made to keep the fork up-to-date with the latest OBS commits.

We hope to see the changes of the atomic-effects fork eventually integrated into OBS mainline. Perhaps, the Pixel Match Switcher itself could one day be bundled with OBS; part of the starter arsenal to make the awesome tool even more awesome. Our hearts would be filled with joy when the gift of pixel match switching becomes easily accessible to the community.

Thought-About Expansion Features
  • Advanced matching logic: AND, OR, etc
  • Try to match an image anywhere in the video frame (not just at a fixed position) and allow show/hide of an image/mask source at the location where the match image would be found
  • More advanced image processing could be made available for identifying elements in the video, so long as it is fast. This could broaden possible uses of the plugin.

Special Thank You

Special Thank You goes out to Exceldro for letting obs-move-transition plugin be included with our installer builds.
First release
Last update
5.00 star(s) 3 ratings

Latest updates

  1. 0.31.8-alpha

    - OpenGL shader fixes (OSX, Linux, flatpak builds should now work!) - reaction for each match...

Latest reviews

This is Best Plugins
0.31.8-alpha make OBS STUDIO crash
Hope to have an update
This is so useful. I'm using it to give entire presentations from PowerPoint where an icon on the slide is replaced with my face. I switch slides, the part of the slide is detected, and the scene automatically switches. This means that I can use the same set of OBS scenes with many different PowerPoint presentations. I do wish that the build included had the OBS Virtual Camera, but it is no big deal to use the plug-in version.

This should absolutely be included in the main OBS source.