Skip to content
rsjaffe edited this page Mar 8, 2022 · 85 revisions

On this Page

Prerequisites | Support | Installation | Instructions | Updating from a Previous Version | Faq/Known Issues


  1. Lightroom 6+ or Lightroom CC Classic. Version 4 requires Lightroom 10 Classic, version 5 Lightroom 11 Classic: use version 3 for earlier versions of Lightroom.
  2. A USB MIDI controller.
  3. Windows or MacOS.


Use the MIDI2LR discussion forum for support. If MIDI2LR appears to be functioning incorrectly, include the contents of the log file (MIDI2LR.log) in your message. This file is found by using the Lightroom menus: Help → Plug-in Extras MIDI2LR → Generate diagnostic report.


  1. Download the installer and run it. The default directory chosen by the installer should work for most users.
  2. In Lightroom, add the MIDI2LR plugin by going to File⇢Plugin-Manager⇢Add and navigating to and selecting the MIDI2LR.lrplugin folder. If you need more details, Jeffrey Friedl has extensive generic plugin installation instructions.
  3. The MIDI2LR application should automatically launch the next time you start Lightroom.
  4. Moving any controllers will populate the mapping table and allow you to set functions. You can also save/load mappings. See the list of commands for all the functions you can set and usage notes.
  5. If you want to stop sending messages to Lightroom while setting up the application, press the Halt sending to Lightroom button at the bottom of the application. The connection indicator will turn yellow while the connection is halted. Press the button again to restart communications.
  6. In MacOS Mojave or later there is an additional step to enable keystrokes to be sent from MIDI2LR to Lightroom. If you are using MIDI2LR Version 3 or later, you will see the following prompt the first time you attempt to send a key to Lightroom: Application permission request Open the Security & Privacy tab in System Preferences, and enable MIDI2LR: Application permission request


The rest of this wiki has details about the various software features. There are many instructional YouTube videos uploaded by users. And the MIDI2LR group is a great place for support.

Updating From a Previous Version

  1. Exit Lightroom (it hangs on to the old plugin if it's still running).
  2. Download and run the installer, installing the plugin into the same directory as your old version.
  3. Start Lightroom

FAQ/Known Issues

  1. After installation or update MIDI2LR doesn't work at all. The most common cause is installing MIDI2LR version 4 or 5 on an older version of Lightroom. Version 4 only works with Lightroom 10; version 5 with Lightroom 11. For earlier versions of Lightroom, use version 3 of MIDI2LR.
  2. After update, keyboard shortcuts don't work or crash application (MacOS only). This appears to be some weird MacOS issue. To fix, open the Security & Privacy tab in System Preferences, and delete MIDI2LR from the accessibility section. Then, next time running MIDI2LR, re-allow shortcuts as described above in the last step of Installation Instructions.
  3. Lightroom returns to basic adjustments when making other develop adjustments. This happens when you are editing a photo that is synced to Lightroom Mobile and you make the other adjustments before the tracking delay has expired. Tracking delay is adjustable in the Options Dialog under Other. In other situations, the only way to stop this is to turn off GPU acceleration in Lightroom. This is a Lightroom bug.
  4. Horizontal perspective control switched with vertical for portrait photos. This appears to be a Lightroom bug. See issue #107 for details.
  5. Lightroom sometimes responds very slowly to control changes. This may happen after starting/stopping Lightroom several times. The only fix I know is to reboot the computer. This appears to be a Lightroom bug.
  6. Pressing the Alt (Option) key doesn't change the display while moving a slider in MIDI2LR. The Alt (Option) key is used with several different sliders to show an optional display that highlights what is being changed. This key is ignored when moving the slider in MIDI2LR. This is a Lightroom bug.
  7. App can't connect to Lightroom. Before trying to debug this, check your Lightroom version. MIDI2LR only runs on Lightroom 6/CC or later. See FAQ #1 for more details. Then, check your firewall. MIDI2LR uses ports 58763 and 58764 on localhost ( to communicate between the application and the plugin.
  8. Motorized faders stop working after upgrading MIDI2LR. Closing the MIDI2LR app then restarting Lightroom should fix this. This is a Lightroom issue.
  9. Motorized faders move slightly when new picture selected. This appears to be due to the effect of rounding off the values, and so far I have been unable to stop that from happening.
  10. Error Assertion failed: err == noErr. This will occur in OSX if the app does not have execution privilege for the user. A quick fix is to, in Terminal do chmod +x "MIDI2LR.lrplugin/". If you encounter this, please open up an issue to notify me so I can fix the distribution files.
  11. Button needs to be pressed twice for the command to work. MIDI2LR expects buttons to be in "toggle off" mode, where the button sends a 127 when pressed and a 0 when released. If you need to press a button twice to get an action, you need to reprogram the MIDI controller to the proper mode.