Resource icon

Pixel Match Switcher 0.25.1-alpha

Supported Bit Versions
64-bit
Source Code URL
https://github.com/HoneyHazard/PixelMatchSwitcher
Minimum OBS Studio Version
25.0.0
Supported Platforms
Windows, Mac OS X, Linux
Pixel Match Switcher

Pixel Match Switcher
allows switching scenes or changing scene item or filter visibility in response to pixels of video being matched against image templates.
  • 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.
  • Alternatively, individual scene items or filters can be shown or hidden by independent matching rules.
  • 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.
The following are some of the foreseeable use cases for the plugin:
  • 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 a scene transition.
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. Read more on the atomic-effects fork below.

Screenshot



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.
Author
HoneyHazard
Downloads
695
Views
5,121
First release
Last update
Rating
5.00 star(s) 1 ratings

Latest reviews

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.
Top