The following guide will help you get up and running with LES. The install process differs on each platform. Please check for your desired OS.


  1. Download LES for Windows from the downloads page on the main website.
  2. Extract the files & copy the program to any empty folder.
  3. Run the bundled .exe file, LES will self-extract any required resources.


All of the files belonging to LES are in the folder its being run from, so deleting the folder is all you need to do to uninstall LES.


To update LES, simply replace the .exe with the new one downloaded from the website. You're now running the new version of LES!

Resource location

All of the LES resources are extracted into the folder LES is being run from.

Outside of the resources in the folder, there are a few registry keys that LES might add depending on usage, I feel like I should list them here just for transparacy's sake. The removal of these keys is COMPLETELY UNNESCESARY and for the uninstallation process as these registry keys do nothing on their own.

  1. HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Layers (to prevent scaling on high-DPI monitors)

  2. HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run\Live Enhancement Suite (if you enable addtostartup, this key will add LES to the startup tab in task manager)


The installation process for mac is slightly different from windows.

  1. Download LES for macOS from the from the downloads page on the main website.
  2. Extract the files (if they are not already extracted) and run double click on Install LES.


untrusted developer

If you are presented window like this, simply right light on the installer and click open

open installer

  1. Once the installer has opened, click just click Install to begin the install process.
  2. Once the installation has finished, feel free to close the installer. You can now launch the Live Enhancement file from spotlight or your dock.

If something doesn't work properly, first check if you've given LES full access at "Accessibility" and "Automations" under "Privacy" in the system preferences. If you don't give hammerspoon access to these things, it won't be able to properly automate user input, causing the shortcuts to malfunction.


The uninstall process of MacOS is pretty straight forward. Just reopen the installer from the website and click "Uninstall". The automated process will remove all of the content related to LES from your computer.


The update process is also pretty straight forward. Just re-open the installer (or redownload it from the website), and the button should now say "update" instead of "uninstall". Hit the button and everything should sort itself out automatically.

If the LES installer doesn't recognize the new version automatically, don't hit "uninstall". Make sure to backup your configuration, as hitting the uninstall button will remove your configuration permanently. Reinstalling will always bring you up to date.

Resource location

During usage, the resources for LES are unpacked and stored in /users/[your username here]/.hammerspoon/

This includes settings.ini, menuconfig.ini, and the project time storage.

The .hammerspoon folder is invisible. To access it, either set enabledebug to 1 in the settings, reload, and then choose "open hammerspoon folder" from the LES menubar. Alternatively, you can press Cmd + Shift + G in any Finder window and enter the filepath of the folder: ~/.hammerspoon/.

That's it for now! Make sure to check other documentation for a more in depth look and the functionality of LES.

Last Updated: 6/4/2019, 5:15:54 PM