feat: Add zoom-to-mouse functionality guide for OBS Studio

Author: jestsee

src/content/blog/zoom-to-mouse-functionality-in-obs.mdx

@@ -0,0 +1,101 @@
+---
+title: Level Up OBS Recordings with Zoom-to-Mouse
+description: Enhance your recordings and presentations with dynamic zoom effects.
+heroImage: https://images.unsplash.com/photo-1532518171289-5e46a269e127?q=80&w=2952&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D
+pubDate: 2025-01-03
+tags:
+  - other
+---
+
+import Video from '@/components/Video'
+
+## Introduction
+
+Want to make your recordings more dynamic and engaging? Check out the video below to see the zoom-to-mouse effect in action
+
+<Video
+  src='https://res.cloudinary.com/dj1jdtddj/video/upload/v1735908341/Video_ekj6op.mp4'
+  poster='https://res.cloudinary.com/dj1jdtddj/image/upload/v1735906741/4ea8c3d8-7cf9-4c03-9d9e-bb39627a94e3.png'
+  client:only='react'
+/>
+
+While paid tools like [Screen Studio](https://screen.studio/) offer this capability, what if you could achieve the same effect for free? The good news is that you can, using OBS Studio!
+
+In this guide, I'll walk you through the steps to set up zoom-to-mouse functionality. These instructions have been tested on Windows and Mac, and the process should be quite similar for Linux users.
+
+## 1. Download the Magical Script
+
+To get started, you’ll need to download the script that enables the zoom-to-mouse functionality in OBS Studio
+
+- Open this [link](https://github.com/BlankSourceCode/obs-zoom-to-mouse/releases/tag/v1.0.1).
+- In the _Assets_ section, click to download the `obs-zoom-to-mouse.lua` file.
+
+![Download the zoom-to-mouse script from github](https://res.cloudinary.com/dj1jdtddj/image/upload/v1735877527/1_yqel5r.png)
+
+## 2. Set Up Your OBS Screen
+
+Now that you have the script, let’s set up your OBS scene:
+
+- Launch OBS.
+- Add a **New Scene** by clicking the **+** button under the _Scenes_ section.
+- Next, add a **New Source**:
+  - On **Mac**, select `macOS Screen Capture` as the source.
+  - On **Windows**, choose `Display Capture` as the source.
+
+Important: Not all sources work with this script, so ensure you pick the right one.
+
+![OBS screen setup](https://res.cloudinary.com/dj1jdtddj/image/upload/v1735877526/2_dfh1kg.webp)
+
+## 3. Setup the zoom to mouse script
+
+Now let’s connect the script to your scene:
+
+- Click **Tools** in the top menu bar.
+- Select **Scripts** from the dropdown.
+- In the _Scripts_ tab, click the plus icon (+) to add the `obs-zoom-to-mouse.lua` script.
+- On the right side, you’ll see configuration options. Choose the **Zoom Source** you created earlier (if you can’t find it, click _Refresh zoom sources_).
+
+You can adjust the configuration to your liking, but to match the result from my video, here’s the setup:
+
+![Zoom to mouse script configuration](https://res.cloudinary.com/dj1jdtddj/image/upload/v1735877527/3_karcfa.webp)
+
+**Tip for Mac Retina Displays**: If you're on a Mac with a retina display, you might experience some weird behavior with zoom-to-mouse. To fix this, check the option for **Set Manual Source Position** and refer to the [issue discussion](https://github.com/BlankSourceCode/obs-zoom-to-mouse/issues/24) for more details.
+
+For a smoother experience on Retina displays, you can adjust the `Scale X` and `Scale Y` to `2`, and make sure to set the `Monitor Width` and `Monitor Height` based on your screen resolution. Here's my configuration for reference:
+
+![Additional configuration for Mac Retina Dipslay](https://res.cloudinary.com/dj1jdtddj/image/upload/v1735877527/4_lpiocl.webp)
+
+## 4. Setup OBS Hotkey
+
+To control the zoom-to-mouse functionality, you’ll need to configure some hotkeys:
+
+- Go to **Settings** in OBS.
+- Navigate to the **Hotkeys** section in the left sidebar.
+- Search for **Toggle zoom to mouse** and **Toggle follow mouse during zoom**.
+- Assign your preferred hotkeys (I recommend `1` and `2` for easy access).
+
+![Hotkey setup](https://res.cloudinary.com/dj1jdtddj/image/upload/v1735877527/5_vzyepk.png)
+
+### Setup Global Hotkeys (Mac Only)
+
+For now the hotkeys are only active when OBS is in focus. If you want to use the hotkeys while working in other applications, you need to set up global hotkeys:
+
+- Enable Accessibility Permissions
+
+  - Open **System Settings**.
+  - Navigate to **Privacy & Security** in the sidebar.
+  - Click on **Accessibility**.
+  - Add OBS to the list of apps that can control your computer.
+  - Toggle the switch to enable the app.
+
+- Allow Input Monitoring
+
+  - Back in the **Privacy & Security** tab, select **Input Monitoring**.
+  - Add OBS to the list of apps that can monitor input.
+  - Toggle the switch to enable the app.
+
+**Please note**: There is a known issue where this configuration may only work for a few hours. If you encounter this, try restarting your computer to restore functionality. You can read more about this issue [here](https://github.com/obsproject/obs-studio/issues/4126#issuecomment-1960956749).
+
+## And That’s It!
+
+Now you're ready to use the zoom-to-mouse functionality in OBS Studio. Simply press '1' to zoom in and out, and '2' to toggle the zoom following your mouse. This feature can help make your tutorials, presentations, or streams more engaging.