Develop for Lightroom CC and Develop XL for Lightroom CC — Setup guide
This guide covers the two products: Develop for Lightroom CC, for the Stream Deck +, and Develop XL for Lightroom CC, for the Stream Deck + XL. They are set up the same way; where something differs, it says which one it is about.
What you need
- A Stream Deck + (for Develop for Lightroom CC) or a Stream Deck + XL (for Develop XL for Lightroom CC), and the Stream Deck app 6.9 or later (for the + XL, a version that supports it).
- macOS 13 or later, or Windows 10 or 11.
- Adobe Lightroom (cloud), installed from Creative Cloud (on a Mac, also from the Mac App Store). Lightroom Classic is a different application and is not supported.
1 · Enable external controllers in Lightroom
- Open Lightroom and go to its preferences: Lightroom › Preferences › Interface on a Mac, Edit › Preferences › Interface on Windows.
- Turn on Enable external controllers.
- Quit and reopen Lightroom. Lightroom only opens the controller connection when it starts.
2 · Install the plugin and allow the connection
- Install the plugin from the Elgato Marketplace (or double-click the
.streamDeckPluginfile). - Lightroom shows a Pairing request dialog with the plugin's name: "Develop for Lightroom CC" (or "Develop XL for Lightroom CC") would like to control Lightroom. Click Pair. It asks once. If you have both products, it asks once for each.
- On a Mac, the first time a key sends a keystroke (see below), macOS asks to let Stream Deck control System Events. Allow it. Depending on your macOS version it may also ask for Accessibility for Stream Deck; allow that too. If you declined by mistake, turn Stream Deck on again in System Settings › Privacy & Security › Automation (and Accessibility). On Windows there are no system permissions to grant.
The pairing is kept in a small file, so Lightroom does not ask again. To pair from scratch, quit the Stream Deck app, delete that file and open the app again:
| Develop for Lightroom CC | Develop XL for Lightroom CC | |
|---|---|---|
| Mac | ~/Library/Application Support/com.enfoke.deck/lightroom.json | ~/Library/Application Support/com.enfoke.develop-xl/lightroom.json |
| Windows | %APPDATA%\com.enfoke.deck\lightroom.json | %APPDATA%\com.enfoke.develop-xl\lightroom.json |
3 · Put the profiles on the deck
Each product comes with its ready-made profiles:
| Product | Profile | Name in the Stream Deck app |
|---|---|---|
| Develop for Lightroom CC (Stream Deck +) | Develop console, 17 pages | Enfoke · Develop |
| Develop for Lightroom CC (Stream Deck +) | Culling | Enfoke · Culling |
| Develop XL for Lightroom CC (Stream Deck + XL) | Develop console, 8 pages | Enfoke · Develop XL |
The same profiles speak four languages: their keys and the touch strip come in English, Spanish, German or French, whichever the plugin picks (see Language below). When the plugin is installed, Stream Deck asks whether to install its profiles: click Install Profile(s). They appear in the profile menu of the Stream Deck app. On the Stream Deck +, the Culling key of the Develop profile and the Develop key of the Culling profile jump from one to the other. On the + XL, the top row holds the seven develop phases as tabs, with the loupe and export at the end.
Once you are on them, the deck follows Lightroom: pick the crop, masking or remove tool in Lightroom and the deck jumps to that tool's page of the develop console, and back when you leave the tool — unless you used the deck on that page: then it stays where you are. It only does so while the deck shows one of these profiles: on any other profile it stays where you put it. It works the same on the + XL. If the deck moved by itself, or with one of the profile's page keys, and you then switch to another app, it lets go: the Stream Deck app goes back to the profile it was showing, and, unless following is off, the develop page comes back when you return to Lightroom. That automatic following can be turned off from the settings of the plugin's keys and dials (Follow the Lightroom tool).
If you used the plugin before this version, read Coming from an earlier version below.
Language
The plugin speaks English, Spanish, German and French, and picks one by itself. In the settings of any of its keys or dials (all but the photo dial), next to Follow the Lightroom tool, the Language list has Automatic and the four languages. Pick one and the deck, the touch strip and the settings change to it at once, with no restart. The choice is shared by all the plugin's keys and dials. If you have both products, each keeps its own choice.
On Automatic, the plugin takes the first of these that is English, Spanish, German or French:
- The language Lightroom runs in. The plugin learns it when it connects to Lightroom and remembers it, so it holds while Lightroom is closed.
- The language of the Stream Deck app, unless it is English: the Stream Deck app comes in only a few languages, so its English may just mean it does not have yours.
- Your computer's languages, in their order: on a Mac, your preferred languages (System Settings › General › Language & Region); on Windows, its display language.
- English.
So with Lightroom in German the deck speaks German, even if your computer is in English; pick a language in the list to change that. A language the plugin does not speak yet is skipped: with Lightroom in Italian, it goes on down the list.
What follows that language: the keys of the Develop, Culling and Develop XL profiles, the touch strip (dial names, the messages below, the decimal comma or point) and the settings of the plugin's keys and dials. What does not:
- The action list of the Stream Deck app (action names and their descriptions) follows the language of the Stream Deck app: English, Spanish, German or French, and English in any other.
- The names of the profiles and of their pages, in the Stream Deck app, are in English.
- Names that come from Lightroom itself, like the parameters in a develop dial's list while Lightroom is open, are in Lightroom's language.
- The keys of the profiles from earlier versions keep the language they were made in.
Coming from an earlier version
Updating the plugin does not change the profiles you already installed, and the Stream Deck app does not add new profiles by itself. The new Develop, Culling and Develop XL profiles keep the names of the English ones from before, so the Stream Deck app keeps showing the one you have until you delete it. To move to the new ones:
- In the Stream Deck app, delete your Enfoke · Develop profile (and Enfoke · Culling), or Enfoke · Develop XL on the + XL.
- Open the settings of one of the plugin's keys in a profile you still have from before (they start with a note that says so). If you have none left, drag any of the plugin's actions onto a free key of your Stream Deck + (or + XL) and open its settings: they show Deck profiles. You can delete that key afterwards.
- Press the button with the profile's name. The Stream Deck app offers to install it: accept. Do the same for each profile; once the new Develop is in, its Culling key (page Home 2) also opens Culling and the app offers to install it.
If you press the button without deleting the profile from before, it just opens that one.
The Spanish profiles of earlier versions, Enfoke · Mesa, Enfoke · Selección and Enfoke · Mesa XL, keep working, in Spanish, but new installations no longer get them. Once you are on the new profiles you can delete them too.
Portrait and skin
- Stream Deck + (Develop for Lightroom CC): the Skin page sits between Retouch and Output (Retouch › Skin).
- Stream Deck + XL (Develop XL for Lightroom CC): the Portrait page, from Masking › Portrait.
What the keys do:
- People opens Lightroom's people mask: choose the person and the parts (face, body skin, eyes…) on screen, in Lightroom.
- Face Skin, and on the + XL Eyes, Teeth, Brows, Beard, Hair, Sleek Hair, Clothes, Portrait and Polish, apply one of Lightroom's adaptive portrait presets to the selected photos. Lightroom finds the face or the feature by itself. The key puts masking in front and selects the new mask, so the dials adjust it right away.
- Soft Skin sets Texture −30 and Clarity −15 on the mask that is selected, wherever it came from. With no mask selected, it flashes a warning and changes nothing.
- Hide (+ XL) hides or shows the selected mask, to compare.
- The dials of these pages are the mask's own sliders: texture, clarity and sharpening; exposure, shadows and saturation; temperature, tint and hue.
If a preset key flashes a warning, your Lightroom has that preset under another identifier. Open the key's settings in the Stream Deck app and pick it from the Preset list, which comes from your own Lightroom.
What the strip tells you
When something is missing, the first row of a develop dial says so, in the plugin's language (here, in English):
| Strip says | Meaning |
|---|---|
| No LR | Lightroom is not running. |
| Ctrl. off | Lightroom runs but external controllers are off (step 1), or it was not restarted after enabling them. For a few seconds while Lightroom starts, or after the connection drops with Lightroom open, this is normal; if it does not go away, quit and reopen Lightroom. |
| Allow LR | Lightroom is showing its pairing request (step 2): click Pair there. If Lightroom shows no request, quit and reopen Lightroom. |
| Denied | The pairing request was declined in Lightroom. The plugin does not ask again on its own: press any of the plugin's keys or dials, or tap the touch strip (turning a dial is not enough), or reopen Lightroom, and Lightroom asks again. In the profiles from earlier versions the page keys don't count: they belong to the Stream Deck app. |
| Offline | Only for a moment while the plugin starts, before its first try. |
(The messages are short because they share the strip with the dial's own label.) The settings of the plugin's keys and dials say the same in full, under Lightroom: Lightroom 9.6 connected (with your version), or what is missing and what to do.
Building your own keys
The action list of the Stream Deck app has ready-made actions, one per job (Light, White Balance, Presence, Mask Adjustments, Zoom, Undo & Redo, New Mask, Crop Ratio, Export…). Drag one to a key or a dial and pick what it does from its What it does list. The three generic actions come at the end, as Advanced, for any Lightroom command; the Photo dial sits with the dials:
- Develop dial — up to three Lightroom parameters per dial, picked from a list that comes from your own Lightroom. Turn to adjust, turn while pressed for fine steps, press to reset.
- Lightroom command — a key that sends one Lightroom command (crop, a mask, export…) and, optionally, reads a Lightroom state to show on/off.
- Lightroom dial — a dial that sends one command when turned left, one when turned right and one when pressed (zoom, undo/redo, flags…).
- Photo dial — moves between photos and shows the photo on the strip.
A note on keyboard shortcuts
Almost everything goes through Lightroom's controller interface, so it does not depend on your keyboard layout. A handful of Lightroom commands have no controller equivalent (show original, paste settings to all selected, panels, targeted adjustment tools). Those keys press Lightroom's own shortcut instead, typed by character. Lightroom uses the same shortcuts for them in every language it ships in, except show original, which differs in German and French: the plugin asks Lightroom which language it runs in and sends the right one, whatever the Language list says. These keys were tested with Lightroom in Spanish on a Spanish keyboard, on a Mac and on Windows; they send the same characters whatever language the deck shows. A few newer ones (next screen mode, the panel keys, HDR and panorama without the dialog, open in Photoshop as a smart object) are offered on the Mac only for now. They bring Lightroom to the front first, so the keystroke always goes to it. On a Mac, a warning triangle on one of them means macOS has not given Stream Deck the permission of step 2. On Windows it means Windows did not let the plugin bring Lightroom to the front: the key sends nothing then.
Support
Questions or problems: [email protected].