OBS 脚本进阶：Zoom 缩放与源切换自动化案例

除了插件，OBS 还能靠脚本扩展。脚本干的多是自动化的活：按热键放大鼠标周围的画面、让一组来源互相排斥只显示一个、OBS 启动时顺带把别的软件也拉起来。

脚本和插件有什么区别

插件是编译好的二进制文件，要用安装包写进 OBS 目录，升级或重装 OBS 后往往得重装一遍，详见「3. 实用插件增强」。脚本只是一个 .lua 或 .py 源码文件，放在硬盘任意位置，在「工具」>「脚本」里点一下就加载，不用了从列表移除就行。

功能上两者有重叠，脚本也能提供滤镜，下文的 DeBlemish、UnFish 就是滤镜脚本。但脚本更擅长改的是 OBS 的行为，而不是画面的渲染方式。所以你会发现，滤镜类扩展基本都是插件，自动化类扩展基本都是脚本。

如何启用和管理 OBS 脚本

1. 打开 OBS，从主菜单中选择「工具」>「脚本」。
2. 在脚本窗口中，你可以看到已经加载的脚本列表，以及添加和删除脚本的选项。
3. 要添加新脚本，点击「+」按钮，浏览并选择你想要添加的脚本文件。

Lua 脚本加载完就能用。Python 脚本还要多一步：切到脚本窗口的「Python 设置」标签页，在「Python 安装路径 (64位)」里指定本机 Python 的安装目录。这里选的是文件夹，不是 python.exe，装的也必须是 64 位的 Python。没设这一步时，.py 加载进去不会报错，只是右侧的设置区一片空白，看起来像脚本坏了。OBS 支持的 Python 版本一直落后官方几个身位，如果路径没填错还是加载不上，换低一两个版本的 Python 再试。

改完脚本文件或改完参数后没生效，点脚本窗口下方的「重新载入脚本」。

💡 避坑指南：下载来的脚本别放进 OBS 安装目录（C:\Program Files\obs-studio\data\obs-plugins\frontend-tools\scripts\）。升级倒是不会动它，OBS 的内置更新器只删更新清单里点名的文件，覆盖安装也只是把新文件写进去。出事的是卸载，卸载程序会把整个 data 目录递归删掉，这一步还是必选的、取消不了，放在里面的脚本跟着一起没。同名文件也会被安装包直接覆盖，自己改过的版本就白改了。

建议放到 %APPDATA%\obs-studio\scripts\，这是 OBS 的用户配置目录，卸载时清理它的那一项默认不勾选，脚本能留下来。也可以在自己的素材目录下建一个 OBS脚本 文件夹统一存放。

💡 避坑指南：脚本列表是跟着场景集合保存的，记录写在场景集合的 json 里。切换到另一套场景集合时，脚本列表是空的，得重新添加，参数也要重设。反过来说，横屏和竖屏两套集合可以各配各的脚本，互不干扰。

OBS 自带的示例脚本

上面那个安装目录里躺着几个 OBS 官方脚本，装完就有，不用去论坛下载，直接从脚本窗口点「+」选进来即可：

• countdown.lua：把一个文本源变成倒计时，适合开播前的等待画面。
• instant-replay.lua：按热键即时回放，脚本会用重播缓存存一段，然后自动丢进媒体源播放。需要先开启重播缓存。
• pause-scene.lua：切换到指定场景时暂停录制，中途处理杂事不会录进去。
• clock-source.lua：添加一个「Lua Clock」来源，画一个动态的模拟时钟。
• url-text.py：按设定的间隔抓取某个 URL 的内容，写进文本源。这是唯一一个 Python 脚本，正好拿来验证上面的 Python 路径配好了没有。

Zoom to Mouse

Zoom to Mouse 脚本能在直播或录制时放大鼠标所在的位置，讲代码、演示菜单栏这类细节时很好用。主要功能如下：

• 鼠标焦点缩放：按下指定热键后，脚本自动对显示器捕获源进行缩放，聚焦于鼠标所在位置，便于观众清晰地看到感兴趣的部分。
• 自动跟随功能：推荐勾选 Auto follow mouse，放大后的视图会随鼠标移动，光标始终保持在视图中心，演示更流畅。
• 扩展源支持：默认只支持显示器捕获源。若需对其他类型的源使用，勾选 Allow any zoom source。

为了高效地配置 Zoom to Mouse，建议按照以下步骤设置快捷键：

1. 进入 OBS 的「文件」>「设置」>「快捷键」。
2. 为 Toggle zoom to mouse 设置快捷键，如数字键 1，用于开启或关闭放大效果。
3. 为 Toggle follow mouse during zoom 设置快捷键，如数字键 2，以控制放大视图是否随鼠标移动。

论坛上的原版脚本已不支持 OBS 32，需要手动修改，或者直接用我的修改版。

另外要注意，Zoom to Mouse 针对的是单个来源，每当更换素材时，也需相应地更换 Zoom Source。它默认只作用于主画布，配合 Aitum Vertical 做竖屏时的处理方式，见「3. 实用插件增强」的竖屏场景一节。更详细的用法推荐看 Zoom to Mouse 的 Youtube 教程。

Source toggler

Source toggler 脚本让指定场景或组里的来源互相排斥：你把其中一个显示出来，同一场景或组内的其他来源会自动隐藏，最多只留一个可见。

多机位切换、多张演示图轮换时用得上，省得手动点掉上一个眼睛图标。操作方法是在 Scenes and Groups 里填入你希望配置的场景或组的名称。若后续调整了设置，记得点脚本窗口下方的「重新载入脚本」，否则旧配置会继续生效。

其他实用脚本

• DeBlemish Filter：添加一个新的效果滤镜，替换指定颜色，让画面更顺滑。
• UnFish Lens：效果滤镜，用于校正摄像机鱼眼镜头的畸变。
• Autostarter：OBS 启动时自动拉起外部程序，OBS 退出时自动关闭它们。

更多

想找别的脚本，去 OBS 论坛的 Scripts 分类翻，那里和插件资源库是分开的两个入口。