Skip to content

LRBridge v0.5.0, Windows portable release

Choose a tag to compare

@ninoleto ninoleto released this 06 Jul 23:10

LRBridge v0.5.0, Windows portable release

This is the first stable Windows portable release of LRBridge.

LRBridge is a local bridge application for Adobe Lightroom Classic, designed to make Lightroom easier to control from external tools, web interfaces, button panels, encoders, Bitfocus Companion, browser devices, scripts, and automation systems.

This release builds on the earlier portable RC builds and includes updated documentation, Web Controller help, visible slider feedback, and improved behavior around Lightroom timing limitations.


Main purpose

LRBridge connects Lightroom Classic with external control workflows.

It is built for users who want to control Lightroom from:

  • Bitfocus Companion
  • Stream Deck-style controllers
  • Loupedeck / Razer Stream Controller setups
  • Custom web interfaces
  • Tablets, phones, touchscreens, and browser-capable devices
  • Local HTTP commands
  • PowerShell, curl, scripts, and automation tools
  • Button, knob, and encoder-based workflows

The purpose is to make Lightroom control faster, more flexible, and more suitable for real production workflows.


Included in this release

This portable package includes:

  • LRBridge.exe, main Windows portable application
  • Web Controller, browser-based controller interface available from localhost and LAN
  • Lightroom Classic plugin, Lightroom-side communication plugin
  • Local HTTP API for external control
  • Visible slider feedback in the Web Controller
  • Auto Tone and Auto White Balance cooldown after slider movement
  • config/settings.txt, editable polling-rate configuration
  • Bitfocus Companion HTTP Builder, helper for creating Companion HTTP actions
  • README documentation
  • Updated Web Controller Help page
  • Development context documentation for project continuation

Portable installation

No installer is required.

  1. Download the ZIP file.

  2. Extract it to a writable folder.

Recommended locations:

Documents\LRBridge

Desktop\LRBridge

Avoid extracting to:

C:\Program Files

  1. Run:

LRBridge.exe

  1. Open Adobe Lightroom Classic.

  2. Go to:

File > Plug-in Manager

  1. Click Add.

  2. Browse to the extracted LRBridge folder.

  3. Select the Lightroom plugin located inside the lightroom folder:

lightroom\LRBridge.lrplugin

  1. Enable the plugin.

After the plugin is added, LRBridge can communicate with Lightroom Classic while LRBridge.exe is running.


Web Controller

LRBridge includes a browser-based Web Controller.

After running LRBridge.exe, open the controller on the same computer:

http://127.0.0.1:17892/

The Web Controller can also be opened from another device on the same local network using the Windows computer's LAN IP address:

http://YOUR-COMPUTER-IP:17892/

Example:

http://192.168.1.50:17892/

Windows Firewall may ask for permission the first time LRBridge runs. Allow access if you want to use the Web Controller from other devices on the LAN.

The Web Controller can move Develop sliders, reset individual sliders, run supported Lightroom actions, and show polling-based feedback values for visible sliders.


Bitfocus Companion support

LRBridge can be used with Bitfocus Companion in two ways.

1. Companion Generic HTTP Requests

Generic HTTP control works with tools already integrated in Companion.

Use Companion's built-in HTTP request tools to map LRBridge commands to Companion buttons, pages, and supported hardware controllers.

The included Companion HTTP Builder provides copy-ready commands for slider adjustment, slider reset, and Lightroom actions:

http://127.0.0.1:17892/bitfocus-companion-cheatsheet

2. Native LRBridge Companion module

A native Bitfocus Companion module for LRBridge exists as a separate project:

https://github.com/ninoleto/companion-module-ninoleto-lrbridge

The native module gives Companion users ready-made LRBridge actions, so they do not need to manually create every command as a Generic HTTP request.

The native module is not bundled inside this LRBridge ZIP release. It is maintained separately, so LRBridge can stay focused on Lightroom control and the local HTTP API, while the Companion module can focus on clean Companion integration.

Both options can be used depending on the setup:

  • Use Companion Generic HTTP Requests for built-in Companion tools and manual control.
  • Use the native LRBridge Companion module for cleaner ready-made actions.

Lightroom feedback

The Web Controller can show current Lightroom slider values below supported sliders.

Feedback works for slider changes made from the Web Controller and for slider changes made directly inside Lightroom.

Feedback is polling-based, not true native realtime feedback. Small delays are normal, especially while moving sliders quickly.


Auto Tone and Auto White Balance cooldown

Lightroom Classic can ignore Auto Tone and Auto White Balance commands for a short time after Develop sliders are changed.

LRBridge now handles this in the Web Controller by temporarily disabling Auto Tone and Auto White Balance after slider movement. This avoids sending those commands while Lightroom is still internally processing recent slider changes.

This is a Web Controller usability workaround for Lightroom timing behavior, not a backend API change.


Support development

LRBridge is developed as an independent project.

If this tool is useful to you and you want to support further development, testing, and improvements, you can leave a donation here:

Support LRBridge development on Ko-fi: https://ko-fi.com/ninoleto

Support is optional, but greatly appreciated.


Notes

This is the first stable Windows portable release, but LRBridge is still a young project.

Current known limitations:

  • Lightroom plugin polling must be running.
  • Web Controller feedback is polling-based, not true realtime.
  • Auto Tone and Auto White Balance need a short cooldown after slider movement because of Lightroom timing behavior.
  • Native Companion module lives in a separate GitHub repo.
  • /get, /set, /last-result, and WebSocket input remain experimental.
  • Windows is the primary packaged and tested target.
  • No macOS package is currently provided.

This release is intended for users who want a practical local bridge between Lightroom Classic and external control workflows.

Feedback, testing reports, bug reports, and ideas are welcome.