Skip to content

About

Smart, dynamic screen zoom, cursor-following and stealth OSD suite for OBS Studio.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

Repository files navigation

FocusLens for OBS Studio

Platform OBS Studio License Release

FocusLens is a screen zoom, cursor-following, and on-screen display (OSD) suite for OBS Studio. It is built for content creators, tutorial makers, educators, and streamers who need to highlight details without complicated scene switching.


Overview

When presenting tutorials, code walkthroughs, webinars, or demonstrations in OBS Studio, viewers often struggle to read small text and user interface details.

FocusLens enables dynamic magnification directly inside OBS Studio. It features automated mouse tracking, cursor click halo effects, and an isolated stealth OSD indicator that informs you when zoom is active without appearing on your stream or recording output.


Visual Walkthrough

1. Opening the Plugin

Opening FocusLens

Access FocusLens from the Tools menu in OBS Studio.

2. Configuring Triggers

Trigger Settings

Configure hotkeys or mouse button combinations to trigger magnification.

3. Adjusting Zoom Behavior

Zoom Behavior

Configure zoom factor, follow speed, and toggle vs. hold mode.

4. Selecting Sources

Source Selection

Choose which sources are magnified (e.g., Desktop Capture) and leave overlays untouched.

5. OSD Alert Badge

OSD Badge

Stealth "ZOOM ACTIVE" indicator appears on screen, isolated from stream capture.

6. System Tray Companion

System Tray Menu

Manage alerts, sync zoom state, or exit via the system tray icon.


Features

  • Dynamic Screen Zoom: Zoom in and out with configurable transitions using hotkeys or mouse clicks (e.g., Ctrl + Left Click).
  • Cursor Tracking: The viewport follows mouse movements naturally while zoomed in.
  • Click Highlight Halo: Highlights mouse clicks with an animated halo for tutorial visibility.
  • Stealth OSD Indicator: Displays an on-screen alert so you know magnification is active. Protected with WDA_EXCLUDEFROMCAPTURE so it is excluded from your OBS video feed and recordings.
  • Background Sync: Automatically attaches when OBS Studio is running and stays idle when OBS is closed.
  • Self-Contained Installer: Packaged as a single standalone executable (FocusLensInstaller.exe) that configures the plugin and companion service automatically.

Installation

  1. Go to the Releases page.
  2. Download FocusLensInstaller.exe.
  3. Run the installer as Administrator. It will automatically detect your OBS Studio installation path, install the plugin binaries, and register the companion utility.
  4. Launch OBS Studio.

Usage Guide

1. Settings Menu

Open OBS Studio and select Tools -> FocusLens... from the top menu bar.

2. Setting Trigger Keys

In the Trigger tab:

  • Keyboard Trigger: Set a preferred hotkey (such as F10).
  • Mouse Button Trigger: Select Left, Right, or Middle mouse button.
  • Modifiers: Select Ctrl, Alt, or Shift.
    • Common recommendation: Ctrl + Left Click to zoom straight into cursor position.

3. Tuning Zoom Settings

In the Target / Advanced tab:

  • Mode:
    • Hold Mode: Zooms while holding down the trigger; resets on release.
    • Toggle Mode: Press once to zoom in, press again to zoom out.
  • Zoom Factor: Set magnification level (e.g., 2.0x).
  • Mouse Follow Sensitivity: Adjust cursor tracking smoothness and speed.

4. Source Filtering

In the Sources tab:

  • Enable zoom on display capture or window capture sources.
  • Keep webcams, alerts, and overlay borders unchecked to preserve their positioning.

5. Companion Status

  • A red tray icon indicates the companion alert system is running.
  • Right-click the icon to toggle alert visibility or force a state resync.

Building from Source

To compile the installer and companion app manually:

# Clone the repository
git clone https://github.com/saifulislammz/FocusLensInstaller.git
cd FocusLensInstaller

# Compile companion OSD service
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe /target:winexe /out:FocusLensOSD.exe /reference:System.Windows.Forms.dll /reference:System.Drawing.dll src/FocusLensOSD.cs

# Compile installer
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe /target:exe /win32manifest:src/app.manifest /reference:System.Windows.Forms.dll /reference:System.Drawing.dll /out:FocusLensInstaller.exe src/FocusLensInstaller.cs

System Requirements

  • OS: Windows 10 or Windows 11 (64-bit)
  • OBS Studio: Version 28.0 or newer (64-bit)
  • Runtime: .NET Framework 4.5 or higher (included by default on Windows 10/11)

License

Distributed under the MIT License. See LICENSE for details.


Author

Saiful Islam

About

Smart, dynamic screen zoom, cursor-following and stealth OSD suite for OBS Studio.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages