【插件教程】Ulanzi D100H Dial 控制 Lightroom Classic 教程：修图效率翻倍指南

kelvin208

### 📖 USER GUIDE & HIGHLIGHTED FEATURES

🌟 **Fully Compatible:** Works flawlessly on both **Windows** and **macOS** (all OS-specific shortcut scripts have been removed).
*Note: Some pre-configured Actions that use macOS-specific hotkeys (like Cmd, Option) will not work on Windows. You must manually remap them to their Windows equivalents (e.g., Ctrl, Alt).*

⚠️ **IMPORTANT NOTE:** All the smart features listed below (Library & Crop recognition, Custom StepSize, Dial Mode Toggle) **only work when you assign the "Basic Dial" action to your knobs**.

**1. Custom StepSize Per Parameter:**
- **Feature:** Gives you 100% control over the rotation sensitivity. You can set individual increments for each specific tool (e.g., Exposure steps by 0.1, Temperature steps by 50).
- **How to Use (In Ulanzi Studio):** Drag and drop a dial action. Look at the Inspector panel on the right, find the **StepSize** input field, and enter your desired number. Leave it blank to use the default speed.

**2. Smart Library Module Recognition:**
- **Feature:** The plugin automatically detects when you are in the Library module and transforms your dial into a lightning-fast photo browser.
- **How to Use:** While in Library mode, simply rotate the *Basic Dial* to instantly skip to the Next or Previous photo. No extra configuration needed!

**3. Crop & Straighten Recognition:**
- **Feature:** When you activate the Crop tool in Lightroom, the dial automatically adapts and becomes an Angle/Straighten tool.
- **How to Use:** Open the Crop tool in Lightroom. Rotate the dial to perfectly level your horizon. Once satisfied, simply **Press** the dial to apply (Enter) and exit Crop mode automatically.

**4. "Dial Mode Toggle" Button:**
- **Feature:** A "magic" button that triples the power of a single dial by introducing secondary modes (Modifiers).
- **How to Use (In Ulanzi Studio):** Drag and drop the **Dial Mode Toggle** action onto a physical button. This button will now act like a Shift/Alt modifier key for your dials.

**5. Functions Inside "Dial Mode Toggle":**
- **Feature:** Allows your dial to perform entirely different tasks depending on how you interact with the Toggle button.
- **How to Use:**
  - **Method 1 (Hold & Rotate):** Press and hold the *Dial Mode Toggle* button while rotating the dial to trigger a secondary function (e.g., changing Brush size). Release the button to return to normal.
  - **Method 2 (Click to Toggle):** Press the *Dial Mode Toggle* button once to "lock" the dial into its secondary mode. Press it again to unlock. Perfect for when you need the secondary function for an extended period!

### 📖 INSTALLATION GUIDE
- **1. Install Lightroom Plugin:** Unzip `ulanziplus.lrplugin.zip` and move the `.lrplugin` folder to a safe location (e.g., your Documents folder). Open Lightroom Classic -> go to **File -> Plug-in Manager -> Add** -> Select the unzipped folder.
- **2. Install Ulanzi Plugin:**
  - Close Ulanzi Studio completely.
  - Copy the `com.ulanzi.AdobeLightroomClassicPlus.ulanziPlugin` file into:
    - *Windows:* `%APPDATA%\\Ulanzi\\UlanziDeck\\Plugins`
    - *Mac:* `~/Library/Application Support/Ulanzi/UlanziDeck/Plugins`
  - Restart Ulanzi Studio.

---

## 🇨🇳 中文 (Chinese)

### 📖 使用说明与核心功能 (USER GUIDE)

🌟 **全面兼容:** 在 **Windows** 和 **macOS** 上均可完美运行（已移除所有会导致错误的专属系统快捷键代码）。
*注意：部分预设了 macOS 专属快捷键（如 Cmd、Option）的操作在 Windows 上将无法运行，您需要手动将其重新映射为对应的 Windows 快捷键（如 Ctrl、Alt）。*

⚠️ **重要提示:** 以下所有智能功能（Library 与 Crop 识别、自定义步长、旋钮模式切换）**仅在您分配 "Basic Dial (基础旋钮)" 操作时生效**。

**1. 独立自定义步长 (Custom StepSize):**
- **功能:** 100% 掌控旋钮灵敏度！您可以为每一个工具单独设置调节幅度（例如：曝光步长设为 0.1，色温步长设为 50）。
- **使用方法 (Ulanzi Studio 内):** 拖拽并分配一个旋钮操作。在右侧的设置面板 (Inspector) 中找到 **StepSize** 输入框，填入您想要的数值。如果留空，则使用默认速度。

**2. 智能识别 Library (图库) 模块:**
- **功能:** 插件会自动识别您是否处于图库模块，并将旋钮瞬间化身为极速阅片神器。
- **使用方法:** 在图库 (Library) 模式下，只需旋转 *Basic Dial* 即可快速切换上一张/下一张照片，无需任何额外配置！

**3. Crop & Straighten (裁剪与校正) 智能识别:**
- **功能:** 当您在 Lightroom 中开启裁剪工具时，旋钮会自动变身为水平校正 (Angle/Straighten) 工具。
- **使用方法:** 打开 Lightroom 裁剪工具。旋转旋钮即可调整画面倾斜度。调整满意后，直接 **按下** 旋钮即可应用更改 (Enter) 并自动退出裁剪模式。

**4. "Dial Mode Toggle" (旋钮模式切换) 按钮:**
- **功能:** 这是一个赋予旋钮“三重分身”的魔法按钮，通过添加辅助模式 (Modifiers) 让一个旋钮发挥多重作用。
- **使用方法 (Ulanzi Studio 内):** 将 **Dial Mode Toggle** 操作拖拽到一个按键 (Button) 上。该按键现在就如同键盘上的 Shift/Alt 键一样，可与旋钮配合使用。

**5. "Dial Mode Toggle" 内部功能详解:**
- **功能:** 根据您按压切换键的方式，旋钮将执行完全不同的任务。
- **使用方法:**
  - **方式一 (按住并旋转):** 按住 *Dial Mode Toggle* 按钮的同时旋转旋钮，即可触发次级功能（例如：调节画笔大小）。松开按钮，旋钮立刻恢复默认功能。
  - **方式二 (点击锁定):** 单击 *Dial Mode Toggle* 按钮，即可将旋钮“锁定”在次级模式。再次单击即可解锁恢复。当您需要长时间使用次级功能时，这种方式非常完美！

### 📖 安装指南 (INSTALLATION GUIDE)
- **1. 安装 Lightroom 插件:** 解压 `ulanziplus.lrplugin.zip`，将 `.lrplugin` 文件夹移动到一个安全的路径（如文档文件夹）。打开 Lightroom Classic -> 选择 **文件 (File) -> 插件管理器 (Plug-in Manager) -> 添加 (Add)** -> 选择刚才解压的文件夹。
- **2. 安装 Ulanzi 插件:**
  - 完全退出 Ulanzi Studio 软件。
  - 将 `com.ulanzi.AdobeLightroomClassicPlus.ulanziPlugin` 文件手动复制到以下路径:
    - *Windows:* `%APPDATA%\\Ulanzi\\UlanziDeck\\Plugins`
    - *Mac:* `~/Library/Application Support/Ulanzi/UlanziDeck/Plugins`
  - 重新启动 Ulanzi Studio。

Ulanzi

phil01 发表于 2026-7-24 12:11
非常感谢，后续如果更新完成后能否回复我一下，谢谢。

你好，应用市场中插件有更新1.1.4版本，可以下载体验，不满足的地方，还会持续更新。

Ulanzi

kelvin208 发表于 2026-8-6 20:39
Do you treat me like an absolute novice? What I actually need from you is real product improvement,  ...

Hello, we appreciate your feedback and acknowledge it; we will continue to update this plugin.

Eythor

kelvin208 发表于 2026-8-6 23:23
### 📖 USER GUIDE & HIGHLIGHTED FEATURES

🌟 **Fully Compatible:** Works flawlessly on both **Window ...

Well done!! You fixed the issues I had noticed and added great other features!

But for some reason I cant get this to work.
The lightroom plugin is enabled and looks like it is working
The lightrrom Classic+ plug in is showing up but looks like it cant connect to Lightroom!
Any sugetions how I can fix this! (i tried chatgpt but it didnt help)

st3

Installed 1.1.4 form the market, lightroom sees 1.0.4. Any update on this?
The plugin package in this forum contains ulanzi plus 1.1.3, but it doesn't work for me.

Ulanzi

st3 发表于 2026-9-30 09:03
Installed 1.1.4 form the market, lightroom sees 1.0.4. Any update on this?
The plugin package in thi ...

The Lightroom Classic plugin is only applicable to the Lightroom Classic App version and not to Lightroom.
The version we downloaded is V1.1.4.

hacobee

I am experiencing the same problem.
I copied "com.ulanzi.AdobeLightroomClassicPlus" to "C:\Users\Windows\AppData\Roaming\Ulanzi\UlanziDeck\Plugins".
Restarted ulanzi app but I can't seem to activate or see the new "MODE SELECT + ADJUST"

Ulanzi

hacobee 发表于 2026-10-1 11:36
I am experiencing the same problem.
I copied "com.ulanzi.AdobeLightroomClassicPlus" to "C:%users\Wi ...

Hello, Lightroom Classic Plus was developed by a user and shared on the forum. We will contact the developer and ask them to look into this issue. @kelvin208

Additionally, the official plugin will allow for individual slider settings for each parameter; we will roll this out to everyone once it’s available.

If you have any other feedback, please feel free to leave a comment.

phil01

管理员你好，好像弄错了
是否能够更新一下这个选项的旋钮单位，不要让他滚动一格 调整5个单位。滚动一格调整一格单位才是需要的哦。
或者是按下旋转一格调整5个单位，不按下 直接滚一格调整一格单位。谢谢

界面