Skip to content
This repository has been archived by the owner on Feb 15, 2024. It is now read-only.

tryptech/obs-zoom-and-follow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This script is not being actively maintained. Please contact me if you want to take over maintenance.

I no longer stream regularly and do not find myself with the free time to do the necessary refactor to address existing issues. Please use BlankSourceCode's lua script to achieve similar functionality. It only supports desktop capture, but works cross-platform, has basic dual machine support, and does not require you to setup Python or any dependencies.


Zoom and Follow

Have you ever needed to zoom in on your screen to show some fine detail work, or to make your large 4k/ultrawide monitor appear less daunting on stream? Zoom and Follow for OBS Studio does exactly that, zooms in on your mouse and follows it around. Configurable and low-impact, you can now do old school Camtasia zoom live!

Maintained for the current release version of OBS

Built using Python 3.10

Inspired by caharkness's Magic Window

Last updated: 2023 September 14

Dependencies

Install

  • Install Python 3

    Make sure that you configure the correct version of Python within OBS in the "Scripts" window > "Python Settings" tab

  • Install requirements

    python -m pip install -r requirements.txt

    or

    python3 -m pip install -r requirements.txt

  • Add zoom_and_follow_mouse.py as an OBS script

Note: I will not provide support on how to install Python or any dependencies as each system and platform is different. I am only set up to test on the current versions of Windows 11 and Apple Silicon-based macOS and can only guarantee compatibility with the latest version of OBS on the latest version of each OS.

How to Use

  1. In the "Tools > Scripts" Menu of OBS
    • Select a source to zoom into as part of the script settings
    • Configure the size of the zoom window
    • Change any of the other settings to adjust the zoom and follow behavior (Optional)
  2. In the "Settings > Hotkeys" Menu of OBS
    • Setup a hotkey for Enable/Disable Mouse Zoom
    • Setup a hotkey for Enable/Disable Mouse Follow
  3. Use Zoom hotkey to zoom in and out of the source
    • Optionally, use the Follow hotkey to toggle mouse tracking
  4. Adjust Source Bounding Box Type, Alignment, and Size to preference

Setting up zoom control for multiple sources

Duplicate and rename zoom_and_follow_mouse.py, and repeat the Install and How to Use sections with the duplicate copy.

To Do

  • Only track windows/games when they are the active window
  • Re-implement window tracking on macOS
  • Proper testing on Linux (X11/Wayland/etc.) Looking for Linux maintainers

About

Dynamic zoom and mouse tracking script for OBS Studio

Topics

Resources

License

Stars

Watchers

Forks

Languages