Be aware that the new releases of Lightroom have broken Keys functionality.
Keys was originally distributed by Visual Supply Company in order to give users a speed boost when editing images in Adobe Photoshop Lightroom. In August 2015, it was discontinued as a product for purchase, and is now open source and available for free download.
Before downloading Keys, remove any pre-existing versions of VSCO Keys.
Keys is released under the GPLv2 (or any later version). See full license in LICENSE.
Go to the Releases page, and download the .zip
file for the latest release.
Unzip the downloaded file and double-click the installer. Follow the prompts and it will be installed.
On Mac
After installing, please be sure to add the VSCOKeys.app
to have accessibility privileges.
System Preferences -> Security & Privacy -> Privacy -> Accessibility.
// Add VSCOKeys.app to that list
How to build Keys installers for OS X and Windows:
Instructions below are for use on a OS X machine.
Prerequisite: Download Bitrock InstallBuilder (http://installbuilder.bitrock.com/download.html)
Build/
directoryVSCOKeys.exe
, place .exe
file in Build/VSCOKeys/
directoryTools/BuildInstallerOnOSX.sh
, both OS X and Windows installer will be builtBuild/
, zip files and they are ready to distributeFor setting on installer, such as build directory and naming of installers, changes can be made to Tools/VSCOKeys.xml
.
Open the sampleLayout.keysjson
file in a text editor of your choice (you may edit this file directly or create a new file with the extension .keysjson
) to create your own layout.
To find the correct values for input, please use the Layout/keymap.json
and Layout/toolkitlistlr4.json
for reference. Change the key
value and the name of the adjustment in adj
(e.g. Saturation
). Use keymap.json
to find the imtxcode that maps to the desired key on your keyboard. Refer to toolkitlistlr4.json
for the adjustment names and values.
Layout/sampleLayout.keysjson Example:
Line 10 sets `Q` to the preset "C - Fuji 160C from Film 01"
Line 11 sets `W` to decrease saturation by 1
Line 12 sets `E` to increase saturation by 1
Line 13 sets Ctrl + `W` to decrease exposure by 1
Line 14 sets Ctrl + `E` to increase exposure by 1
Change the uuid
line and the name
line to what you prefer.
Save the file.
Launch Lightroom with VSCO Keys 2.0 enabled.
Double click the saved file to load the file into VSCO Keys 2.0. (make a backup of file if you want to update later)
Click on the VSCO Keys 2.0 Icon to change the layout.