{"id":13585126,"url":"https://github.com/tryptech/obs-zoom-and-follow","last_synced_at":"2025-04-07T06:32:40.209Z","repository":{"id":42499275,"uuid":"285050105","full_name":"tryptech/obs-zoom-and-follow","owner":"tryptech","description":"Dynamic zoom and mouse tracking script for OBS Studio","archived":true,"fork":false,"pushed_at":"2024-02-15T22:33:48.000Z","size":290,"stargazers_count":374,"open_issues_count":22,"forks_count":62,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-11-06T02:38:42.833Z","etag":null,"topics":["obs","obs-studio","obs-studio-script","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tryptech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-04T17:22:34.000Z","updated_at":"2024-11-05T15:43:50.000Z","dependencies_parsed_at":"2024-02-15T23:46:58.169Z","dependency_job_id":null,"html_url":"https://github.com/tryptech/obs-zoom-and-follow","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryptech%2Fobs-zoom-and-follow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryptech%2Fobs-zoom-and-follow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryptech%2Fobs-zoom-and-follow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryptech%2Fobs-zoom-and-follow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tryptech","download_url":"https://codeload.github.com/tryptech/obs-zoom-and-follow/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247607545,"owners_count":20965942,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["obs","obs-studio","obs-studio-script","python"],"created_at":"2024-08-01T15:04:45.285Z","updated_at":"2025-04-07T06:32:40.203Z","avatar_url":"https://github.com/tryptech.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"***This script is not being actively maintained. Please contact me if you want to take over maintenance.***\n\nI 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](https://github.com/BlankSourceCode/obs-zoom-to-mouse) 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.\n\n---------------\n\nZoom and Follow\n---------------\nHave 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***!\n\n*Maintained for the [current release version of OBS](https://github.com/obsproject/obs-studio/releases/latest)*\n\n*Built using Python 3.10*\n\n*Inspired by [caharkness](https://obsproject.com/forum/members/caharkness.153928/)'s [Magic Window](https://obsproject.com/forum/threads/magic-window.107614/)*\n\n*Last updated: 2023 September 14*\n\nDependencies\n------------\n- [PyWinCtl](https://github.com/Kalmat/PyWinCtl/) by [Kalmat](https://github.com/Kalmat)\n- [PyMonCtl](https://github.com/Kalmat/PyMonCtl/) by [Kalmat](https://github.com/Kalmat)\n\nInstall\n-------\n- Install Python 3\n\n  Make sure that you configure the correct version of Python within OBS in the \"Scripts\" window \u003e \"Python Settings\" tab\n\n- Install requirements\n\n  ```python -m pip install -r requirements.txt```\n\n  or\n\n  ```python3 -m pip install -r requirements.txt```\n\n- Add `zoom_and_follow_mouse.py` as an OBS script\n\n*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.*\n\nHow to Use\n----------\n1. In the \"Tools \u003e Scripts\" Menu of OBS\n   - Select a source to zoom into as part of the script settings\n   - Configure the size of the zoom window\n   - Change any of the other settings to adjust the zoom and follow behavior (Optional)\n2. In the \"Settings \u003e Hotkeys\" Menu of OBS\n   - Setup a hotkey for ***Enable/Disable Mouse Zoom***\n   - Setup a hotkey for ***Enable/Disable Mouse Follow***\n3. Use ***Zoom*** hotkey to zoom in and out of the source\n   - Optionally, use the ***Follow*** hotkey to toggle mouse tracking\n4. Adjust Source Bounding Box Type, Alignment, and Size to preference\n\nSetting up zoom control for multiple sources\n---\nDuplicate and rename `zoom_and_follow_mouse.py`, and repeat the **Install** and **How to Use** sections with the duplicate copy.\n\nTo Do\n-----\n- Only track windows/games when they are the active window\n- Re-implement window tracking on macOS\n- Proper testing on Linux (X11/Wayland/etc.) *Looking for Linux maintainers*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftryptech%2Fobs-zoom-and-follow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftryptech%2Fobs-zoom-and-follow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftryptech%2Fobs-zoom-and-follow/lists"}