Skip to content

Getting Started

github-actions[bot] edited this page Oct 15, 2026 · 12 revisions

Getting Started

Install

Desktop app. Download an installer from Releases:

  • Windows: the -x64.exe for most PCs (Intel and AMD), the -arm64.exe for ARM PCs (such as Snapdragon). It installs into Program Files.
  • macOS: the -arm64.dmg for Apple Silicon, the -x64.dmg for Intel. The app is not code signed: right-click it and choose Open the first time.
  • Linux: the .deb for Debian and Ubuntu (sudo apt install ./ILLUMinator-*.deb), or the .AppImage for other distributions (chmod +x it, then run it).

Or run it from source (Node.js 20 or newer):

git clone https://github.com/AbstractPolygon/ILLUMinator.git
cd ILLUMinator
npm install
npm start

npm run dist builds an installer for your system (Windows, macOS, Linux).

Browser. Each release also has the web version, ILLUMinator-<version>-web.zip: unzip it and upload what is inside to any web server (served over HTTPS). Or serve the app folder of the source; nothing to install for the people who use it.

npm run web            # http://localhost:8080
npm run build:web      # a static copy in dist/web, for any web server

ILLUMinator needs a browser with WebGL 2 for fast rendering (any current Chrome, Edge, Firefox or Safari). Without it, everything still works on the CPU, more slowly.

Open a photo

  • Drag .LFR / .LFP files anywhere onto the window.
  • Settings Settings → Import Lytro Desktop library… for your old Lytro Desktop library.

Every photo you open is added to your library, so it is there next time (Library and Albums).

The window

  • Left sidebar: the library: All photos, your albums and the photos in the selected album. Choosing an album shows its photos as a grid of thumbnails in the middle; click a photo to open it.
  • Middle: the picture. Click to focus on that spot; drag to move the viewpoint. Above it, Camera and Lenslets switch between the picture and the raw microlens image, with the zoom controls on the right; below it, the animation controls.
  • Right sidebar: the editing panels (Editing). Click a title to open or close it.
  • Top bar, right:

Full screen Full screen (click again or press Esc to leave)

About About

Settings Settings

Your edits are saved

Every change is saved with the photo as you make it; there is no Save button. Open the photo again and it looks as you left it. Reset buttons and double-clicking a slider put things back.

Clone this wiki locally