GitCorner

Code

ossartcraftlightcraft🌐
5a24289898fd
# What's new in LightCraft

## Unreleased

### Flatpak updates
- Help ▸ Check for Updates can now reach the release service and update standalone Flatpak bundles.
  This permissions repair must first arrive through your existing host-side update method. Flatpaks
  managed by a software repository continue to use its package manager, and launcher-pinned versions
  keep their selected version.

### Export Effect Presets leaves your originals alone
- Export Effect Presets… (`mask.exportEffects`) now refuses a path that is a photo's original or its XMP sidecar, as
  the other exports do, and writes the file atomically. It used to write the presets over whatever file it was given,
  and a failed write (a full disk) could leave a cut-off file where an earlier export was.

### Film grain that looks like film (process V7)
- Grain now comes from a simulated emulsion of crystal layers (after Aurélien Pierre's model): dense, soft and cloudy
  rather than dots on top of the photo. It fades out towards black and white as on a print, so shadows keep their depth
  and blown highlights stay clean, and the fit-to-window preview shows the grain you will export. Amount, Size and
  Roughness keep their meaning and Lightroom Classic's strength and grain size. This is rendering process 7: new photos
  (and Reset) get it, photos you already edited keep their grain until you choose Photo ▸ Update to Current Process.
  See [film grain](grain.md).

### Colour noise reduction (process V6)
- Colour noise reduction removes colour noise at the raw default 25, where it used to leave most of it, and keeps
  colour edges at high values instead of bleeding them into fringes (issue #815). It filters the colour differences
  R−Y and B−Y, leaving brightness exactly as it was, along edges found in a denoised guide, and takes isolated
  coloured specks out. New photos get it; photos edited before keep their look until Update to Current Process. A zoomed
  view is smoothed like the same part of the whole photo and the export.

### The web build can be embedded
- A page framing LightCraft in an iframe can open it with `?host=parent` and speak to it over `postMessage`, the
  protocol PdfCraft, GridCraft and DeckCraft share: it hands photos in, receives exports and backups instead of
  downloads, runs commands and hears whether closing would lose unsaved changes (issue #2270; `docs/web.md`).
  A parent on another origin, or a page with an opaque origin, keeps the normal downloads.
- A page can also run LightCraft in its own document, with no iframe: `data-host="page"` on the canvas carries the same
  messages as `CustomEvent`s on the canvas instead of `postMessage` (issue #2270; `docs/web.md`). `?host=parent` wins
  when a page asks for both.

### A library is written only to the folder it was opened from
- LightCraft wrote a library's files to wherever the library's path led at that moment, not to the folder it had opened.
  When a share was mounted over the library's folder, or the folder was moved away and another put in its place while
  the library was open, it wrote into that other folder: it could replace another library's catalog (`catalog.snap`
  and `catalog.log`) with its own, and closing the library removed the note another program had left in
  `catalog.lock.owner` to say that it has the library open (issue #3240).
- LightCraft now remembers the folder it opened (its device and inode number) and, before every save, checks that the
  library's path still leads to it. If it doesn't, nothing is written: not the catalog, its log, the library's
  settings, the lock note or a thumbnail. The not-saved warning says why, names the path and asks you to put the
  original folder back; your changes are kept in memory, quitting asks first as it does for any unsaved change, and
  saving goes on by itself once the original folder is at its path again. That holds for photos, albums and presets; a
  preference that could not be saved is reported where you changed it, and is written with the next preference you
  save. Opening the library at that path again takes the lock of the folder that is there now, so it is refused while
  another program has that library open.
- Saving keeps working after a drive or share is mounted again. A volume that is mounted again gets a new device
  number, and some file systems number their folders anew at every mount (FAT and exFAT drives on Linux, sshfs). The
  folder at the path still counts as the one that was opened when it holds exactly the lock note this session wrote
  into the folder it opened (the note holds a value no other lock's note has), or when it is the same volume mounted
  again: the same inode number and the same creation time under another device number (a system that doesn't know
  when a folder was created can't tell that from another folder). On the same device an inode number is given again
  to a folder made later, so two creation times that are known and differ are two folders. A copy of the library's
  folder made while the library was open holds that note too and counts as the library, and so does a clone of its
  volume; a share mounted over the folder, with another library in it or with nothing, never does. A copy lacks the
  changes made after it was made: they are written to it by the next snapshot, which holds them all, and until then
  they are kept in memory and reported as not saved. If neither tells, the folder counts as another one and nothing is
  written.
- Dropping the lock removes the lock note only if it is the one this session wrote, with the bytes it wrote, in the
  folder it locked or one that holds that note; another program's note is left alone.
- Import ▸ Move removes the originals from the card only after the library's catalog is on disk, not just handed over
  to be written: when the library can't be saved, the originals stay on the card.
- On Windows a folder's identity isn't available to the program yet (Rust's standard library offers it only on its
  nightly builds), so there the check notices a path that no longer leads to a folder, not one that leads to another
  folder; the lock note is protected there too.
- On every system, files outside the library's catalog and settings are still written by path, some of them over what
  is there: originals copied into the library (always under a new name), Smart Previews, profiles, the face-scan
  record (`focus-scanned.bin`), the Lightroom import's `Interop` folder, and what is done to the photos stored in the
  library's `Originals` folder (their sidecars, Save Metadata to File, rename, delete from disk, duplicate and
  conversion to DNG).

### Remove Hot Pixels
- Detail ▸ Noise Reduction has a new box, Remove Hot Pixels (raws only), on for newly imported raws (issue #1345).
  At high ISO single photosites read far brighter than all their neighbours and turn into small red, green or blue
  dots that noise reduction only makes fainter. They are now replaced before the raw is developed. A point of light
  spread over neighbouring photosites, such as a star, is kept; untick the box for star fields that need every
  single-photosite point. Photos edited earlier keep their look: the box is off for them.
- A raw that would have more than 0.2 % of its photosites replaced is left unchanged: such a photo doesn't look like
  hot pixels on a sensor. Stars and other points of light that are kept don't count, so a dense star field still
  loses its hot pixels. Settings ▸ Performance ▸ Hot pixel limit sets the share (0.05 % to 1 %).

### Raising Exposure keeps raw highlights (process 5)
- Raising Exposure on a raw no longer turns the brightest tones the sensor recorded white (issue #1632). The tone
  curve now eases into white a stop at a time instead of reaching it within about a stop of the sensor's white: at
  Exposure +1 and +2 a sky, a lit wall or a face keeps its detail where it used to go flat white. At Exposure 0 the
  brightest tones render a few codes darker (on average 1 code or less on the photos measured), and fully clipped
  areas such as a blown sky stay slightly below pure white until Exposure lifts them further. A DNG whose own tone
  curve already reaches white at the sensor's white renders as before. This is rendering
  process 5: new photos (and Reset) get it, photos you already edited keep their look until you choose Photo ▸ Update
  to Current Process. See [process versions](process-versions.md).

## 2026-11-02

### The Windows title bar is readable from the moment the window opens
- When LightCraft's appearance differs from the one set in Windows (the dark default on a light Windows, for one), the
  title bar kept the system's colour with the title in LightCraft's, so the title looked blank until focus moved to
  another window. It now takes LightCraft's colours as soon as the window has focus.

## 2026-11-01

### Korean and Vietnamese text in exports draws whole
- macOS often stores Korean file names decomposed (NFD), each syllable as its jamo. Contact-sheet captions, export
  watermarks, slideshow overlays and print page text drew those as loose jamo (`ㅈㅔㅈㅜㄷㅗ` for `제주도`), and
  decomposed Vietnamese letters lost their stacked marks. Text is now composed before it is laid out, so both draw as
  they do in the app (issue #3480, #3277).

## 2026-10-31

### Find Similar Photos no longer freezes the window
- The first search reads every photo in the library, and it did that on the thread that draws the window, so in a large
  library the app stopped responding and Windows offered to close it (issue #3468). The photos are now read in the
  background: a "Find Similar Photos" row in the activity stack counts them, you can keep working meanwhile, and its ✕
  stops the search. A stopped search leaves the view as it was, and the next one goes on from what was read. The menu
  item is off while a search runs, and opening another library stops it. When a search ends the grid shows the photos it
  found, also from the Photo menu, and a message says how many. `library.findSimilar` from the control channel and
  `mcp --connect` still gets `{photos}`, now when the search ends; a caller that stops waiting (the control server
  gives a request 60 s) can ask again once that search has ended (while it runs, a new request is refused as already
  running), and what was read isn't read again.

## 2026-11-01

### Import a Lightroom catalog backup as it is
- File ▸ Import Lightroom Catalog… also takes the `.zip` backups Lightroom Classic writes in its `Backups` folder
  (issue #2592), for when Lightroom and its catalog are gone and only the backups and the photos are left. LightCraft
  unpacks the catalog into a temporary folder in the library, imports it and deletes the copy; the zip is not
  changed. Open Library given a `Backups` folder, or one of its dated folders, offers to import the backup.
- Importing a backup of a catalog you already imported no longer adds every collection a second time: collections
  are matched by the catalog's own id, which its backups keep, instead of by the catalog file's path.

## 2026-10-30

### Lightroom catalogs with a print inside a collection import their collections
- Lightroom Classic can keep a saved print, book, slideshow or web gallery inside a plain collection, but a
  LightCraft album sits only inside a folder. Importing such a catalog stopped at the end with "parent must be an
  existing folder" and brought over no collections, and photos whose originals were offline were lost with them
  (issues #2165, #2532). Such a collection now joins the nearest collection set above it, or the top level, and the
  import result names it under warnings; so does one whose parent is system-only or gone from the catalog.

### Lens distortion correction for the Sony A7 III
- Raws from the Sony A7 III (ILCE-7M3) now get the camera's own distortion correction, read from the file, like
  the A7R IVA's: straight lines stay straight at wide angles (the FE 16–35 F4 ZA at 16 mm shifts detail near the
  corners by up to about 40 px on a 24 MP photo) and at long ones (the FE 28–70 at 70 mm). Measured against the
  camera's JPEG, the median error is well under a pixel (up to about 1.5 px in the 16 mm corners). Optics ▸ Enable Lens Corrections turns it off and Profile Distortion scales
  it; photos imported before this pick it up with Photo ▸ Reload from Disk. Vignetting and chromatic aberration
  from Sony files are not applied yet.

### Lens corrections without grey corners
- Lens profiles, the camera's own distortion correction, manual Distortion and Chromatic Aberration now crop just
  inside the corrected photo, as in Lightroom, so no grey corners or edge marks show. Perspective corrections still
  need Constrain Crop to do the same.

### The Flatpak may talk to the accessibility bus
- The Flatpak package now has access to the accessibility bus (`org.a11y.Bus`) and no other new permission; its network, Pictures folder and GPU access are unchanged. Without it the sandbox hid the bus, which AccessKit needs to reach a screen reader such as Orca; this has not been tried with Orca yet. The Flatpak build is the only one affected.

### A keyboard shortcut for Clear Color Label
- Clear Color Label is now a command of its own in Help ▸ Keyboard Shortcuts, so it can have a key like Set Rating or
  Set Flag; before, only the red, yellow, green and blue labels (6–9) had keys and clearing a label was menu-only. It has
  no key until you give it one. Photo ▸ Set Color Label ▸ None runs it and shows its key. The key clears the label of
  the selected photos as one undo step, only the active photo in Compare and Survey, and moves on with Auto Advance,
  as the other label keys do.

### Samsung panoramas import
- Some panoramas from Samsung phones were refused as truncated ("the image data doesn't end with an end-of-image
  marker"), although other apps open them whole: their image data runs straight into the Samsung (SEF) block at the
  end of the file, with no end-of-image marker in between. When the file ends with a valid SEF block, the image now
  ends where that block begins, so these photos import, show and build previews. A JPEG that is really cut short is
  still refused.

### Photos waiting for a library wait for a running import too
- Photos given on the command line or dropped on the launch list are imported once a library opens. If another import
  or a Synchronize Folder is still running then, they now wait for it to end instead of being dropped, and a message
  says so (issue #2779).

### Export sizes keep the pixels typed
- Export ▸ Image Sizing kept pixel sizes only in steps of 16, so a typed 1080 became 1088 and 3000 became 3008. The
  long edge, short edge, width and height fields now keep any whole number of pixels.

### The control channel refuses pointer positions that aren't on any screen
- `ui.click`, `ui.move`, `ui.drag`, `ui.dragWidget`, `ui.pointer` and `ui.scroll` with a coordinate or delta far past
  any screen (such as `1e308`) used to queue an infinite or NaN position. A debug build panicked on it and a release
  build handed it to every widget. Numbers outside ±1,000,000 are now an error, and nothing is queued.

### The histogram stays SDR when HDR is switched off
- After an HDR edit was dragged and HDR was then switched off, dragging a slider showed the old HDR histogram (with its
  SDR / HDR colour bar) again until the drag ended. The histogram now follows the edit: an SDR edit shows the SDR
  histogram while you drag, too.

### At most 64 red eye corrections per photo
- Every pixel of a render goes through every red eye correction, so a sidecar, preset or agent with thousands of
  them could stall a preview or export for hours. A photo now renders its first 64, and Red Eye refuses a 65th.

### Reliability
- A damaged or crafted Olympus ORF, Samsung SRW, Sony ARW or Pentax PEF whose strip sizes add up past the largest
  64-bit number no longer crashes LightCraft (debug builds) when it is read: the file is refused, or read as far as
  its data go.

### A colour-range mask keeps at most 64 samples, however it arrives
- A colour-range mask compares every pixel with every colour it has sampled, so a mask with thousands of samples
  could stall a render or export, or lose the GPU for the rest of the session. `mask.add` and `mask.update` already
  kept the first 64; a sidecar's `lc:settings`, a preset, `develop.merge`, `render --settings` and the catalog and
  edit history now keep the first 64 too, in order, and the extra ones are skipped as they are read. Masks made in
  the app (up to 5 samples) are unchanged.

### A SAM 3 model in the wrong format says so
- Object and Describe need `model.safetensors` from `facebook/sam3` in the Hugging Face format. The
  `sam3.safetensors` on community mirrors is Meta's original checkpoint, with other tensor names; installed in its
  place, AI masks failed with "unsupported dtype C64". LightCraft now says that the file is Meta's original
  checkpoint and which file it needs instead.

### Reliability
- A photo with a mask id at the 32-bit limit (from a damaged or hand-edited sidecar, a paste or an agent) no longer
  breaks the masks added after it: new masks, duplicates and the masks of a preset each get an id no other mask has.
  Before, the next id wrapped around to 0, so a second new mask shared the first one's id (debug builds crashed).

## 2026-10-29

### A person's page opens in seconds in a large library
- Finding the unnamed faces that look like a person (a person's page, and again after each face confirmed there) now
  runs on every processor core, and each comparison of two faces uses the processor's vector instructions. In a
  library of 92 000 unnamed faces, a person with 4 100 named ones is estimated to have taken about 2 minutes 40 seconds
  on one core of an Apple M1 Pro, with the window frozen, and now about 3 seconds (both measured on 3 000 of those
  faces, 5.3 s and 0.1 s, and scaled up). Name suggestions and the order of the unnamed
  faces get the faster comparison too.

### Move Folder To… no longer freezes the window
- Move Folder To…, in the menu of a folder in Folders or Local, now opens its folder dialog the way Import and Move to
  Folder… do: the window keeps drawing and answering while you choose, and the folder moves when the dialog closes,
  with the same "Moved; N photo(s) relinked" message. Before, the dialog held up the whole window until it closed;
  on Linux with X11 the app could stop responding altogether. While the dialog is open, another library can't be
  opened (the move belongs to the library it was started in), and while Open Library… or New Library… waits for
  its folder, Move Folder To… is unavailable.

### A library on a disconnected drive is reported at launch, not replaced
- When the library LightCraft last opened is missing at launch, because its drive or network share isn't connected
  yet or it was moved, the window now says it couldn't open the library and offers Try Again, Choose Another
  Library…, Continue Without Saving and Quit. Before, LightCraft quietly made a new, empty library at that path,
  filled it with the demo photos and opened it, so it looked as if the photos and edits were gone. Nothing is
  written there now, and Try Again opens the library once its drive or share is back: on an empty folder left in
  its place, such as a share's mount point, it says so again instead of making a new library there. A library
  folder LightCraft isn't allowed to read is reported as unreadable, with the system's reason, not as gone. A
  library given with `--library` or `LIGHTCRAFT_LIBRARY`, and the default location on first launch, are still
  created as before.

### The histogram's clipping buttons read in light themes
- The two buttons at the histogram's top corners (shadow and highlight clipping) are no longer near-black tiles with a
  grey chevron. They take the theme's own raised fill, and the chevron stands out from it in Charcoal, Midnight, Silver
  and Paper alike.

### Object and Describe masks show their pins
- With Show Pins on, an Object mask now has a pin where you first clicked the object, and a Describe mask has one in
  the middle of what its description found. Before, these masks had no pin on the photo, so they couldn't be picked
  there. Clicking a pin selects its mask; dragging it changes nothing, as these masks follow what they selected.
  With the Object tool on, a click on another mask's pin selects that mask too, instead of adding a click to the
  selected Object mask, and a click on the selected mask's own pin adds nothing. Subject, Sky, Background and the
  range masks still have no pin.

## 2026-10-28

### The empty photo grid names Import Photos' shortcut as it is bound
- When a view is empty and the way in is File ▸ Import Photos…, the message under "No photos" used a fixed "Cmd+Shift+I" (or a translation's fixed copy of it) whatever the platform or the binding. It now shows the key as the menu bar writes it (on a Mac its glyphs, elsewhere Ctrl+Shift+I) on its own line under the sentence, follows a remapped key, and names no key when Import Photos has none. The sentence now wraps in a narrow window instead of running off its edge.

### The photo in Detail is named with its file for screen readers
- With VoiceOver, the photo in Detail view is now announced with its file name, rating, flag and colour label ("Photo:
  IMG_0042.JPG, 4 stars, picked") instead of only "Photo", as the grid names the same photo.

### The grid's thumbnail size slider is a slider to screen readers
- With VoiceOver, the Thumbnail size control at the right of the grid's bottom bar is now announced as a slider with its
  value and range, instead of a button with no value. Increment and Decrement (VoiceOver's Control-Option-Up and Down) and,
  while it has the keyboard focus, the Up and Down arrow keys change it by one step, as the `=` and `-` keys do.

### Local's standard places can't be renamed by mistake
- The Pictures, Desktop, Downloads and Home rows of Local no longer offer Rename Folder… or Move Folder To…. Before,
  the Rename prompt began with the row's translated label rather than the folder's name, so in German pressing OK
  on “Bilder” renamed your real Pictures folder to “Bilder”, and Home could be renamed the same way. Folders inside
  them, and folders you keep in Local with Browse Folder…, rename as before, starting from their real name. The
  `folder.rename` and `folder.move` commands now refuse the home folder and its Pictures, Desktop and Downloads too,
  so a script or an agent can't do it either.


## 2026-10-27

### The Edit menu loses its Language submenu
- Choose the interface language in Settings ▸ General ▸ Language, which already lists every language. Edit no longer carries 18 more rows for it, on any platform.

### The Edit menu groups Select Only Active Photo and Paste Settings from Previous with their kin
- Select Only Active Photo now sits under Deselect All, and Paste Settings from Previous under Paste Selected Settings…, instead of both after Settings…, near the end of the Edit menu. On macOS, where Settings… lives in the application menu, the Edit menu no longer shows two separator lines in a row.

### Screen readers name the sidebar's disclosure triangles
- Each triangle in the left sidebar (album folders, local folders, By Date, imported folders, keywords) and in the
  keyword list now says which row it opens or closes: "Expand Travel", "Collapse 2026". They were all named just
  "Expand" or "Collapse", so VoiceOver read a list of identical buttons.

### Screen readers and Voice Control name the grid's date headers as they read
- A date header in the photo grid is now named with the text it shows ("Sunday, 20 September 2026 · 1 photo"), where
  it was named with the bare date key ("2026-09-20"). VoiceOver reads what a sighted person reads, and Voice Control's
  "click Sunday" finds the header.

### Reading a photo from a network share asks the server less
- Checking a photo (before an import, and for Reload, Recheck, Relink and Convert) asked for the file's size, then
  opened it, then asked for its modification time as a question of its own. It now opens the file once and reads
  both from the open file, so each photo costs the server fewer round trips (about a quarter less time to read a
  set of photos from an SMB share, in one measurement on one share). What is imported and the messages for a file
  that can't be read are the same.

### A refused name prompt stays open and says why
- A one-line prompt (Rename Folder, New Folder on Disk, the preset and version names, New Library for a name it can't
  use, Auto-Tag from Tracklog) that the app refuses, for example a folder name that is taken, now stays open with what
  you typed and shows the reason, so you can change the name. Before, it closed without a word. A New Folder on Disk
  that works now says so: “Created folder “Selects” in “2026/Shoot””. Cancel and Esc still close the prompt.

### The macOS menu bar shows every row
- File ▸ Export… no longer reads “Custom…”, File ▸ Export with Preset keeps its Custom… row, and Photo ▸ Add to Album keeps New Album…. When two menu rows ran the same command, the menu bar left the second one out and gave the first one its label; now each row is its own item and a click on either one runs the command. The View menu now also lists its second Layout Image row (without a key), as the in-window menu does.

### Shortcuts read the same way everywhere on macOS
- Wherever LightCraft shows a shortcut (the menu bar's labels, a button's tooltip, the empty-library hint, the
  line under "No photos" in an empty album, the Keyboard Shortcuts dialog and its search) it lists the modifiers in
  the order macOS menus use, Control, Option, Shift, Command: `⇧⌘I` where it used to say `⌘⇧I`. The line under
  "No photos" also shows the shortcut as it is bound now, and as Ctrl+Shift+I on Windows and Linux, where it
  always said Cmd+Shift+I. Windows and Linux otherwise keep the order a shortcut is written in.

### Screen readers name a slider's value field "value"
- The number beside a slider is now named "Exposure value" (the slider's name and "value"), and "Click to type a value,
  drag to change it" is its description. It was named "Exposure: Click to type a value, drag to change it", so
  VoiceOver read the whole sentence each time it reached the field, once for every slider in the Edit panel.

## 2026-10-29

### A dialog no longer dims the macOS title bar
- On macOS the top bar is the window's title bar, and the window buttons drawn over it stayed bright while a dialog dimmed
  the bar under them. As under a macOS sheet, the dialog's backdrop now leaves the bar alone: its buttons are inactive, a
  click on it does not close the dialog, and dragging its empty space still moves the window. Windows, Linux and full
  screen are unchanged.

## 2026-10-28

### The window's parts are named for screen readers
- The top bar, the tool strip and the bottom bar are now announced as toolbars (Top bar, Tool strip, Bottom bar), and the
  sidebar (Library), the photos, the Tools panel (or Presets) and the filmstrip as landmarks, so a screen reader can list
  them and jump to one instead of walking every control. Nothing on screen changes. Not yet tried with a real VoiceOver session.

### Dialogs are exposed to screen readers as dialogs
- Export, Settings and the other dialogs, the library chooser and the prompts that stop the window (the quit question, a
  library that could not be opened, a settings file problem) are now exposed to screen readers as dialogs: modal ones, so the
  rest of the window is marked as blocked while one is open, and an alert dialog for the prompts. The answer to Check for
  Updates is a dialog too, but not a modal one. Before, each was a plain group that only carried the dialog's title.
- An alert dialog also carries what it says as its description: a screen reader can read the library problem's path, error and
  explanation, or a prompt's text, together with the dialog.

### Screen readers no longer read the shortcut with every button name
- Icon-only buttons (the tool strip, the view buttons and Before/After and Filmstrip in the bottom bar, the top bar's
  Import Photos…, the mask overlay and White Balance Selector buttons, the slideshow controls) are now announced by
  their label alone ("Edit", "Presets", "Photo Grid"), and the shortcut is the button's description ("E", "Shift+P",
  "G"), which VoiceOver reads after a pause or on request. Before, it read "Edit (E)" every time it landed on the
  button. This holds in every language, including Japanese and Traditional Chinese, which write the shortcut in
  full-width brackets. The tooltip you see on hover is unchanged.

## 2026-10-25

### A one-field white balance edit no longer shifts the other one
- Settings that name only a white balance temperature, or only a tint — `develop.merge`,
  `lightcraft-cli render --settings <partial JSON>`, an MCP `set_develop {settings: …}` call, or a hand-written
  preset naming one of the two — used to change the colour balance of photos they never mentioned. On a raw edited in
  Kelvin the field the partial left out was re-read on the other scale: `wb {temp: 5800}` on a photo at 5000 K /
  +12 tint came back at 5800 K with the +12 read as a relative shift, moving the green–magenta balance by a visible
  amount. The kept field now carries the look the photo had, and the result is stored on the scale that photo is
  edited on.
- The same partial on a photo still on As Shot — or on a named white balance preset, on a raw with a Kelvin scale —
  stored the number without any render ever reading it: those modes answer their own white, so the panel showed
  5800 K over a picture still at the file's white. That white is now written out as Custom values before the partial
  lands; a partial that names a mode itself still gets that mode.
- Presets made from a photo and the crs / XMP and Luminar importers name mode, temperature, tint and scale together,
  and partials naming both fields (or neither) behave exactly as before; a partial that says `"scale": "kelvin"` is
  still read in Kelvin.

### JPEG ICC chunks are validated before colour conversion
- JPEG ICC profiles are assembled only when every chunk is present exactly once, the sequence numbers and
  declared totals agree, and every APP2 segment is complete. Reordered valid chunks still work. An invalid
  sequence uses the existing unsupported-profile sRGB fallback, including when the JPEG is a raw preview.


## 2026-10-25

### `>=` and `<=` work in the search box
- Fielded search tokens now take inclusive comparisons: `rating:>=3`, `iso:<=400`, `f:>=2.8`, `focal:<=50`. Before,
  the `=` was read as part of the number, so such a search quietly showed no photos at all.

### Import rename numbering stops safely at its limit
- Copy and Move imports can use the last representable rename number once. If more renamed files remain, each is
  reported as failed with guidance to lower `renameStart` or leave `rename` blank; completed transfers stay
  accounted for and catalogued. A `renameStart` value outside this platform's range is rejected before setup.

### Incomplete timestamps no longer become plausible photo times
- An ISO date ending in `T`, a clock with extra components, or a malformed fractional second is no longer read as a
  different valid time. XMP keeps the original property available and can use the next valid capture-time field;
  GPX treats an invalid point time as untimed, so it cannot tag a photo at a fabricated time.

### Invalid EXIF capture clocks no longer become plausible dates
- An EXIF capture time with extra clock components is ignored as a whole. LightCraft can use a valid DateTimeDigitized,
  IFD0 DateTime or embedded XMP value instead, while All Metadata continues to show the original tag. This also keeps
  malformed timestamps from creating false matches when geotagging from a track log.

### Drags reach the screen a frame sooner
- The window queues one frame ahead of the display again instead of two, as eframe does by default (since #136 it
  used egui-wgpu's high-throughput setting). Sliders, crop handles, brushes and every other drag show up one display
  frame sooner: 8.3 ms at 120 Hz, 16.7 ms at 60 Hz. On a MacBook Pro at 120 Hz, a heavy develop drag went from
  about 18 ms to about 10 ms between a frame being handed to macOS and macOS compositing it, with the same 120 frames
  a second. On a Mac the window also holds one drawable less: its width × height × 4 bytes, 15–22 MB for a
  1200–1500-point-wide window on a Retina display.


## 2026-10-24

### AI Denoise follows the photo's real noise
- The built-in denoiser used to read a photo's fine texture as noise, so it always believed a photo was at least as noisy as
  about ISO 12800 and over-smoothed quiet photos while under-cleaning noisy ones. It now measures each colour channel
  separately, ignores texture, and sets its strength from the noise it actually finds. On clean photos from a Canon EOS R and
  an R6 Mark III with noise added at real ISO levels, the result at ISO 25600 is 2.2 to 2.7 dB closer to the original, and at
  ISO 51200 about 5.5 dB closer; at ISO 6400 it is 0.6 to 1.0 dB closer, and quiet photos are no longer smoothed
  needlessly. Photos denoised before are denoised again when they are next needed. See [AI Denoise](denoise.md).

### Better built-in AI Denoise
- The built-in denoiser now cleans with block-matching collaborative filtering: similar blocks of the picture are
  grouped, transformed together and thresholded, so more fine detail survives at the same level of cleaning. On a
  public raw with added noise it scores 0.25 to 0.6 dB higher than before at every noise level and keeps more
  texture at medium to extreme noise (medium: 44 % of it against 42 %; extreme: 12 % against 9 %), a little less at
  light noise (58 % against 62 %), with no colour blotches or isolated specks. It is as fast as the old filter on the processor, and when the computer has a graphics card that is faster
  it runs there: on an RTX 4080 SUPER a photo's tiles go about 6 to 10 times faster, with the same picture (Settings ▸ AI
  Denoise ▸ Run on chooses; Automatic times both). Photos
  denoised before are denoised again the next time they are needed. See [AI Denoise](denoise.md).

### A right-click on a text field while you carry photos opens no menu
- While you drag photos from the grid, a right-click on a text field, such as the search box, opens no Cut, Copy and
  Paste menu. Before, the menu opened over the field the photos were on. Right-clicking a field without a drag works
  as before.

### Typed GPS coordinates are validated before editing metadata

- Entered coordinates must contain a complete decimal or degrees/minutes/seconds value. Unknown text, exponent notation, wrong-axis or conflicting hemispheres, and minutes or seconds outside [0,60) are rejected instead of being silently ignored and reinterpreted. A rejected GPS value also leaves the other fields in the same metadata edit unchanged.

### The Slideshow settings page stays put while the preview renders

- In Settings ▸ Slideshow, the line under the slide preview ("The selected photo as a slide…") now shows from the first
  frame instead of only once the preview has finished rendering. Before, it appeared with the render, pushing the page
  below it down by a line, so a click made in that moment could land beside the control you aimed at.

### A refused move no longer switches the Move Photos question off
- Ticking Don't ask again in the question that appears when you drop photos on a Folders row used to be remembered even when the move was then refused (for example because a file of the same name is already in that folder). The choice is now kept only once the move has started, so a refused move leaves the question on.

### Importing a folder from a network share waits less
- After the import review, the import used to check that each photo was still as the review had seen it by asking the
  disk about one photo after another, so on a network share every photo waited for a round trip to the server. It now
  asks about up to 16 photos at a time, the same wait for every 16 instead of for each one. Reading the photos in the review
  is unchanged.
- Looking for each photo's `.xmp` sidecar, which asks the disk several names for every photo, also goes up to 16
  photos at a time.

### Original export checks embedded place names when removing location
- Original copies are refused when “Remove Location Info” is enabled and the source contains GPS or a nonblank sublocation, city, state or country. Use JPEG or TIFF for rendered output; DNG is available for raw photos.

### Auto straighten finds the horizon and plumb lines
- Auto straighten (Auto in the crop panel, or a double-click with the Straighten tool) now finds a sea or
  landscape horizon among waves and clouds, and levels buildings by where their verticals converge, so a photo shot
  upward is no longer turned by the lean of its walls. Measured on 113 photos straightened by hand in Lightroom
  Classic, it straightens 50 of them instead of 29, without making more of them worse.
- It turns a photo by at most 5° (before: 10°); only two of those photos needed more.

### Sidecar keywords stay searchable in other applications
- Saving an XMP sidecar wrote each keyword's path into `dc:subject`, so after any change, even a star rating, a
  photo keyworded `Places|Italy|Rome` listed `Places|Italy|Rome` there instead of `Places`, `Italy` and `Rome`,
  and a search for "Rome" in Lightroom, darktable, digiKam or another DAM no longer found it. Sidecars now get the
  names in `dc:subject` and the paths in `lr:hierarchicalSubject`, as Lightroom Classic writes them, and LightCraft
  reads them back as the same keywords. A sidecar written by an earlier version is put right the next time it is
  saved.


### Relative-date filters and smart albums follow the clock
- A current view or source count using “in the last” rules now refreshes when the session clock moves into a new
  minute, even when no catalog edit occurred. This fixes stale photos remaining in the grid and stale counts for
  direct or nested smart albums. Held views keep photos that expired until Refresh View while admitting photos that
  newly match; expiry itself does not create an undo step.

### The histogram's tonal zones adjust the Basic tones
- The histogram is a control surface again, as in Lightroom Classic: hovering one of its five zones (Blacks, Shadows,
  Exposure, Highlights, Whites) tints it and shows its name and value under the plot ("Exposure: +0.45 EV"). Dragging one
  sideways moves that control — the zone you pressed stays locked while the pointer crosses the others, Shift drags a
  tenth as far, and the whole drag is one undo step. Double-clicking a zone puts its control back to its default.

### Drag the parametric Tone Curve
- In the Tone Curve's parametric mode the graph is now drawn from the renderer's own curve, so it always matches the
  photo, and the line can be dragged: pressing it picks the region under the pointer (Highlights, Lights, Darks or
  Shadows) and moving up or down changes that slider, as one undo step. Hovering the line names the region first.
## 2026-10-24

### Virtual-copy numbering stops cleanly at its limit
- Creating a numbered virtual copy now reports when the `Copy N` sequence is exhausted, before any copies in a
  batch are created. An explicit name remains available even when the numeric sequence is full.

### A right-click while you carry photos opens no menu
- While you drag photos from the grid, a right-click opens no context menu, on an album, folder or keyword row in
  the sidebar or on any other row or thumbnail that has one. Before, the menu opened on the row the photos were over.
  The menu of a text field (Cut, Copy, Paste) is not held back.

### Adding photos that are already in an album no longer costs an undo step
- Add to Album and dragging photos to an album now leave the album, the undo history and Redo alone when every
  photo was in the album already. Before, they still recorded an undo step, so Redo was lost and Undo had a step
  that changed nothing. Photos the library no longer has (a selection kept after an Undo took them away) are also
  left out of a new album made from the selection, out of Add to Album, and out of the target album (B), which does
  nothing and says nothing when none of them is left, and counts only the photos it changed.

## 2026-10-23

### AI Denoise works out of the box
- Turning on AI Denoise no longer asks for an ONNX model and a `denoise-model.json`: LightCraft's own built-in
  denoiser runs automatically. Installing a model of your own is optional (Settings ▸ AI Denoise ▸ Your own model);
  Stop using returns to the built-in one. The set-up prompt and its "resume after installing" flow are gone. See
  [AI Denoise](denoise.md).
- The built-in denoiser measures the photo's noise once, cleans the four colour planes together on variance-stabilised
  data (so colour blotches go too), and cleans harder, with a second pass, the noisier the photo is. Colour noise gets
  a wider pass of its own, and in heavy noise isolated specks are smoothed away. On a public raw with added noise it
  scores 3.7 to 10.4 dB higher than the noisy picture, the most at heavy noise, and keeps more fine texture there
  than before (heavy noise: 22 % of it against 20 %; extreme: 9 % against 7 %).

### Export subfolders stay inside the export folder
- An export subfolder (typed in the Export dialog, saved in a preset or passed to `export`) can no longer lead
  outside the chosen folder (issue #2571). `..` and `.` parts and a leading `/` are dropped, and `\` and `:` become
  `_`, so a shared preset with `../..` in its subfolder writes inside your folder instead of elsewhere on disk.
  Nested subfolders such as `Client/Jobs` still work.

### Place names always download into the settings folder
- Download Place Names (for Fill Location from GPS) always saves the GeoNames files in the settings folder (issue
  #2575). An agent or script driving LightCraft could name another folder and another server, and have that
  server's files written there; it is now refused. Each file is saved complete or not at all, and replaces whatever
  is in its place instead of writing through a link to somewhere else.

### Videos in the grid are no longer sent to the image decoders
- A video in the library (an MP4 or MOV brought in from a Lightroom catalog) no longer asks the image decoders for a
  grid thumbnail (issue #2682). They can't read one, so each video failed with "unrecognised image format", showed a
  "!" and was tried again whenever the library changed, filling the log. Its cell now keeps the plain placeholder until
  LightCraft can show video frames. The background face search skips videos too, instead of failing on each one at
  every launch. A video is recognised by its type, by the format `VIDEO` that Lightroom catalogs
  give videos, or by its extension (`.mp4`, `.mov`, `.m4v`, `.avi`, `.mts`, `.m2ts`, `.3gp`, `.mkv`, `.webm`, `.wmv`,
  `.mpg`, `.mpeg`).
### Right-button drags no longer pick up photos in the grid
- Dragging with the right mouse button over a photo in the grid used to pick up the photos and, on a photo that wasn't
  selected, replace the selection with it. Now only the left button drags photos, and a right-button release while you
  are dragging photos no longer drops them on an album, folder or keyword. Right-click still opens the photo menu.

### A damaged GIF or BMP can no longer crash an import
- A GIF or BMP whose header claims an enormous picture (a file of a few dozen bytes can claim a billion pixels) is
  now refused with an error when importing or opening it (issue #2553). Before, LightCraft set aside memory for the
  whole picture, several gigabytes, and could close without warning, losing unsaved work. At import, a GIF or BMP
  picture larger than 4 megapixels now has its size read from the header instead of being decoded; smaller ones are
  still decoded, so a damaged file is caught then. A picture that is mostly blank (a run-length-encoded BMP that ends
  early, or a GIF whose first frame is smaller than the picture) still opens up to 4 megapixels; a larger one is
  refused, because opening it would still set aside memory for the whole picture.

### Merge previews after a failed one
- The HDR, Panorama and HDR Panorama dialogs make a new preview each time they open (issue #2708). After a preview
  had failed once, for example because a photo's file was missing, opening the dialog again with the same options
  showed neither a preview nor an error until an option was changed.

### Edits read from a sidecar are kept in range
- LightCraft edits read back from an XMP sidecar (Read Metadata from File, or at import) are now checked like presets
  and pasted settings: sliders and curves are kept in their ranges and the straighten angle within ±45° (issue
  #2555). A turned crop that reaches far past the photo is trimmed to the photo when it is shown or exported. Before,
  a damaged or hand-edited sidecar could set a crop that made a full-size export ask for trillions of pixels and
  close the app. Crops made with the crop tool are unchanged.

### Text boxes in Settings
- Esc in a text box of Settings (Copyright, Creator, the Auto Import album, the two External Editing boxes) gives
  the text back and stays in Settings; in the first three it used to save what was typed, and in all of them it
  closed the window. Those three now have the Cut / Copy / Paste menu too, and what is typed in Copyright or
  Creator is saved when another tab is clicked, where it used to be dropped.

### The histogram stays in view
- The histogram stays at the top of the Edit panel while its sliders scroll under it (issue #2679). It used to scroll
  away with them, so it was out of sight while using the sliders further down the panel.

### No maze pattern in noisy raws
- Flat areas of high-ISO raws, such as a dim wall or a blurred background, could show short horizontal and vertical
  strokes instead of grain, often orange and blue under warm light. Noise reduction made them stand out more, because
  it smooths the grain around them. The demosaic chose between a horizontal and a vertical guess at each pixel, and
  in a flat area the noise alone decided which. Where neither guess is clearly better it now blends the two, so the
  noise looks like grain. Edges are as sharp as before. Thumbnails and previews that LightCraft rendered from a raw
  are redrawn; the camera's own embedded preview, shown for an unedited raw until its render is ready, is unchanged.


### Tab leaves the name field in New Album, New Smart Album and the name prompts
- In New Album, New Smart Album, Save Metadata Preset and the other dialogs with one name field, the field has the
  keyboard focus when the dialog opens, and Tab now moves on to the check box, Cancel and OK (Shift+Tab goes back).
  Before, the field took the focus back every frame, so only Return and Esc got you out of it. Return still
  confirms and Esc still cancels.

### A thumbnail that can't be read is tried again only when its photo changes
- A file the grid can't draw (a damaged JPEG, a file the decoders can't read) was decoded again after every change to
  the library, even a change to another photo: face recognition and metadata reads at launch made each such file
  fail 20 to 40 times in a few minutes, one log warning each time (issue #2682). It is now tried again when that photo
  changes (Locate Missing File, Reload, an edit) or when the library can't say which photos changed. A photo whose
  file is missing, such as one on a drive that is unplugged, is still tried again at every change, so it comes back
  once the drive does.

### Foreign XMP metadata survives namespace-prefix collisions
- Saving a sidecar keeps another application's properties even when its namespace uses prefixes such as `lc`
  or `xmp`. Those foreign properties no longer become LightCraft settings or ratings when imported.

### The log can show every thumbnail and preview LightCraft asks for
- With `RUST_LOG=warn,lightcraft*=info,lightcraft_ui_egui::render=debug` (or `LIGHTCRAFT_LOG=debug`), the log has a
  line for each picture LightCraft asks for, with its file, and one for how it ended: drawn, or dropped and why.
  Before, only failures were logged, so the log couldn't tell a file asked for 37 times from one asked for once and
  failing inside (issue #2682).
  The usual log is unchanged. See [Get help with a problem](user/troubleshooting/get-help.md).

### Find Missing Photos finds the files of a library made on Windows
- A library made on Windows records its originals with Windows paths. Opened on macOS or Linux, its photos are
  missing until relinked, and Find Missing Photos found them only by their content, so it missed every photo it had
  no fingerprint for (such as photos brought in from a Lightroom catalog) or that had been edited since, even in a
  folder holding every file under the same name. It now matches them by name as it does any other photo: the name
  after the last `/` or `\`, in any letter case, checked against the size when the library has one. Several files
  of that name are still reported rather than guessed, and undo puts back the paths as they were.

### Auto straighten leaves straight photos alone
- Auto straighten (Auto in the crop panel, or a double-click with the Straighten tool) no longer turns a photo by
  more than 10°, and acts only when at least three lines agree. Before, it often turned photos that were straight:
  the edges of wooden planks, a branch or a bird's wing were taken for the horizon, sometimes for a 25° turn.
- When it finds no horizon or vertical lines, it says so instead of doing nothing without a word.

### PSD and PSB metadata stays available
- LightCraft now imports PSD and PSB files with EXIF and XMP image resources. Capture dates, GPS and descriptive fields
  stay available in All Metadata; PSD edit copies keep their capture date. Original exports with Remove Location Info enabled
  are refused when a PSD or PSB embeds GPS, since LightCraft cannot strip metadata from a byte-for-byte original copy.

### Quitting on macOS leaves no lock note
- Quitting LightCraft on macOS no longer leaves `catalog.lock.owner` in the library folder. The note, which names the
  program that has the library open, stayed behind after Quit and the window's close button, pointing at a process
  that no longer existed. The library's lock is now released as soon as everything is saved, as it already was on
  the other systems.

### Asking for the missing photos no longer freezes the window
- `library.missing` (the control channel and `mcp --connect`) looked at every photo's file on the thread that draws
  the window, so on a library of hundreds of thousands of photos on a network share the app stopped answering for
  minutes. The files are now checked in the background: a "Missing Photos" row in the activity stack counts them and
  its ✕ stops the check, and the request is answered with the same list when the check ends. A second request meanwhile
  shares the running check. A caller that stops waiting (the control server gives a request 60 s) gets the answer of
  that check when it asks again within ten minutes, instead of another walk of the share, as long as the photos have
  not changed since; otherwise the files are checked again. If photos change while the files are being checked (an
  import adds some, others are removed, moved to Recently Deleted or relinked), the answer leaves out the photos that
  no longer apply, a photo added meanwhile is not part of that check, and the answer is not kept for a later request.


### Choose where a Lightroom catalog goes
- File ▸ Import Lightroom Catalog… now asks first: merge the catalog's photos, collections and edits into the
  library open now, or create a new library for them, named after the catalog and placed next to the open library
  (both can be changed). LightCraft opens the new library, then imports the catalog into it. Cancel does nothing.
  Open Library… on a Lightroom catalog goes through the same choice.
- To import as before without the question, choose Settings ▸ General ▸ When importing a Lightroom catalog ▸
  Always merge into the open library, or tick Don't ask again in the window. Ask where to import it brings the
  question back.

### Choose which library opens at launch
- Settings ▸ General ▸ **At launch**: *Open the last library* (as before) or *Ask me*. With *Ask me*, LightCraft
  starts with a window listing your recent libraries: each one's name, the folder it is in and when you last opened
  it. One that is gone (moved, renamed, on a disconnected drive), can't be read or no longer holds a library is
  greyed out with the reason. Each one is checked in the background, showing *Checking…* until it answers (and that
  the drive isn't answering after 5 s), so the list never waits on a network share that is offline or a disk that
  has to wake up; File ▸ Open Recent Library uses the same answers (it greys out only libraries that are gone). Making the list only looks: it never locks or writes anything in your libraries, so one
  that another program has open is reported, with who has it, when you press **Open**, and the window stays. The
  last library is selected; **Open** (or Return, or a double-click) opens it,
  **Open Another…** asks for a folder, **New Library…** makes one, **Quit** (or Esc) quits. ↑ and ↓ move through
  the list.
- Holding Alt (Option on a Mac) as the window appears shows the same list once, over the library that opened: open
  another one from it, or press Esc to keep working where you were. On a Mac, an Option key held from before
  LightCraft starts is only noticed once it changes, so press it as the window appears.
- `--library` and `LIGHTCRAFT_LIBRARY` still decide the library when given, and `lightcraft-cli` never asks.
- File ▸ Open Recent Library ▸ **Remove from List** forgets one library, and the launch window's **Remove from
  List** does the same. Only the entry goes: the library and its photos stay where they are. Agents use
  `app.recentLibraries {remove: path}`; its list now also says when each library was last opened (`lastOpened`).
- Photos dropped on the window while the list (or the window of a library that couldn't open) is up wait for the
  library you open and are imported into it, as files given on the command line are; presets dropped then are
  refused with a note, since they belong to a library.

### Editing a smart album made from an album keeps the album
- A smart album saved from the view of an album stays limited to that album when you edit its rules and press OK. It used to match the whole library afterwards, because the rules dialog has no album field and replaced the album along with the rules.
### Drag photos from the filmstrip
- You can now drag a photo from the filmstrip onto the sidebar, as you can from the grid: onto an
  album, a folder or a keyword. Dragging a selected photo takes the whole selection; dragging one that isn't selected
  takes just that photo and selects it. In the Compare view, a photo that isn't selected is dragged alone and the
  selection, the active photo and the two photos on screen stay as they were. Clicking a filmstrip photo works as
  before: outside Compare it selects the photo, and in Compare a plain click puts the photo into the active side.
### Dropping photos on a folder or album that shares its name
- When photos are dragged onto a Folders row and another folder has the same name (two folders called `Home` on
  different disks), the label at the pointer, the Move Photos question and the message afterwards name the folder
  it is in, for example `Home (/Volumes/Archive/Photos)`, so you can tell which one you are about to move them
  into. Long parent paths keep their last names behind `…/`, unless that would read like another folder's path of the
  same name (a mirror on another disk): then the whole path is shown. A name that nothing else uses stays as it was, except that a network share's row is now
  named as the Folders list shows it (`photos on tokyo`) instead of by the last part of its mount path.
- Photos dropped on an album that shares its name with an album in another folder say so too (`Garden (Travel
  2026)`). Two albums with the same name in the same place have nothing to tell them apart by and keep the plain
  name.

### Panel layout messages, face recognition prompts and the second window's title in your language
- The messages shown when a panel layout cannot be restored or a panel move is not applied, the face recognition
  prompts (the banner and the name box's offer, with their buttons), the "Face recognition is on" and "is installed"
  messages, and the title of the second window are now in the interface language in all 17 languages. They stayed in
  English before. So did "The download failed", shown under a denoise or face recognition model's download when the
  download gives no reason.


## 2026-10-22

### Exports don't create a photo's sidecar
- Saving an export, a preset or any other file as `IMG_1.xmp` or `IMG_1.jpg.xmp` in the folder of the library photo
  `IMG_1.jpg` is now refused when no sidecar is there yet, as writing over an existing one already was. The library
  would have read the new file back as that photo's edits.

### Dodge and burn with the brush on the photo itself
- With the mask overlay hidden (O, View ▸ Show Mask Overlay or the eye beside Masks, or after a mask slider hid it),
  the brush stroke you are painting is no longer drawn in the overlay colour while you hold the button, so the photo
  stays visible as you dodge and burn (issue #2549). The stroke's effect still appears when you let go. With the
  overlay shown, the stroke is tinted as before; a colour overlay at opacity 0 leaves it untinted too.


### Reliability
- Opening a library no longer writes through a link left at the lock's owner note (`catalog.lock.owner`): the link
  is removed and a new note made in its place, so the file it pointed to is never changed (as for the catalog's
  temporary files, issue #1502).

### Keys reach text fields and the shortcut editor on macOS
- While a text field has focus, the native menu now lets go of the keys the field needs (`G`, the digits `0`–`9`,
  `P`, `U` and the like), and while Keyboard Shortcuts is recording a key it lets go of all of them (⌘, and ⌘Q in
  the LightCraft menu too), except the system's own items (Hide LightCraft ⌘H, Hide Others ⌥⌘H, Close Window ⌘W
  and Minimize ⌘M) and the two keys of the Help menu (⌘/ and F1). Before, the menu item kept its key on macOS, so the
  key could still run the menu command instead of reaching the field or the editor. The keys come back on the menu
  items when the field loses focus or recording ends; the menu's order, checkmarks and enabled state are unchanged.

### Find the grid shortcut in View
- Photo Grid and Square Grid now show the grid-cycle shortcut (G by default) in the View menu. The hints follow
  shortcut changes; clicking a menu row still selects that grid (issue #2500).

### GPX track logs read escaped values correctly
- Coordinates, elevations and times in a GPX track can contain XML character references such as
  `&#53;`. LightCraft now decodes those characters before parsing values, reports malformed or
  undeclared references as an error, and keeps CDATA literal. Auto-Tag places photos at the track
  position represented by their capture time.

## 2026-10-21

### Settings window
- Settings is one size on every tab and stays where it is as you go through them; before, each tab made its own
  size and the tabs moved under the pointer. The tabs stay in place while a long page scrolls (in a very short
  LightCraft window, where the page has too little room to scroll by itself, the tabs and the page scroll together), a
  page that goes on below shows a scroll handle without the pointer on it, and each page remembers where it was
  scrolled to, also when Settings is closed and opened again.
- Nothing in Settings runs off the side any more. A row with more choices than fit (the languages on General) wraps
  onto further lines and a long label wraps in its column, where both used to widen the window: in a small
  LightCraft window the labels and the Close button of General ended up off screen.
- The Slideshow tab is one column like the other tabs, with the slide preview first, instead of a column beside the
  preview that made Settings much wider on that tab. The preview stays above the page while it scrolls, so pointing
  at a template further down still shows it there (in a very short window it scrolls with the page instead). Pointing
  at a template no longer pushes its rows out from under the pointer, and the Export buttons wrap.
- A long folder (General ▸ Library ▸ Location, the folder Auto Import watches, the smart previews folder, a monitor
  profile's file) is shortened to its last folders ("…/Pictures/Library") on one line; rest the pointer on it for
  the whole path.
### One star rating control
- The stars in the bottom bar, the Info panel and the filter bar are now one shared control, and the badges on grid
  cells, filmstrip thumbnails and the Compare caption use the same drawing. Hovering a star in the filter bar now
  previews the rating like the others do, and with a star focused (Tab), ← and → lower and raise the rating.
### Progress looks the same everywhere
- Download, scan, denoise and activity progress now use one bar that fills the width it is given, with its text on
  it, and a gentle sweep while the amount of work isn't known yet. Waits that only said "Selecting…", "Waiting to
  start…" or "Installing…" now show a small turning arc beside the text, and a thumbnail still being made shows a
  quiet placeholder that fits the theme in the grid, the filmstrip and Compare. Screen readers hear a progress
  indicator with its percentage.
### Menu names that say what they are
- Switches in the menus are named for what they show, with the check mark saying whether it is on: Filmstrip ✓,
  Focus Point ✓, Clipping ✓, Photo Counts ✓, Mask Overlay ✓ instead of Show Focus Point ✓. No two commands share a
  name any more: View ▸ Detail is now Detail View (the Edit section Detail keeps its name), Window ▸ Edit is Edit
  Panel, and Compare Before and After is Before/After Side by Side, next to Split and Top/Bottom.
- The preview cache command has one name, Discard Preview Cache, in File ▸ Previews and in the toast that confirms
  it. Keyboard shortcuts are unchanged.
### Dropping files shows what will happen
- While files are dragged over the window, it dims and a card says what dropping will do: review the photos and
  folders for import, import the presets, or open the face model. If a dialog is open, the card asks you to close it
  first, and a drop is refused with a message instead of replacing the dialog. The same goes while an import is
  running, and in the web version.
- The import review of a finished scan (a drop, or File ▸ Import) no longer replaces a dialog you opened in the
  meantime; it opens as soon as that dialog is closed.
- Photos and folders dropped on the window now open the same import review as File ▸ Import, so you pick add, copy or
  move, the destination and a preset before anything is imported. Settings ▸ Import ▸ "Import dropped files without
  review" brings back the old behaviour of importing at once.
- In the web version, a dropped file the browser can't read, or that can't be imported, now shows a message instead of
  failing silently.
- For scripts: `ui.dropFiles` hovers files over the window or drops them, as the operating system does.
### Counting many smart albums is faster
- Counting every smart album at once (the numbers in the Albums list, and the `albums.list` command) now works out an
  album that other smart albums test (“album is …”) once for the whole library, instead of again for every album
  that tests it. On a synthetic library of 312,000 photos with 77 smart albums, 51 of them testing one shared album,
  the full count took about 14 s instead of about 23 s on a heavily loaded machine; the rest is the text rules of
  the albums themselves. The counts are the same as before, including for albums that loop through each other.

### Selection rings you can see in the light themes
- The active photo's white outline vanished on Silver and Paper's light grid, and told the active photo from the other
  selected ones by lightness alone. Now the active photo has a heavier ring (3 pt, with a thin line against the photo so
  it also shows on a white one) and the other selected photos a lighter one (1.5 pt), in colours each theme picks to
  stand out from its grid. The filmstrip rings its photos the same way, and so do Compare, Reference and Survey (where
  the ring is the only sign of the active photo) and the People view's chosen person.
### Smart albums open and count faster on large libraries
- A smart album that tests another smart album and also a file path or other text (for example "in Rejects, and the
  path contains …") now checks the quick rules first and the slow ones last, so most photos are ruled out before the
  other album is asked about them. The photos in the album and their order are the same, and the rules still show in
  the order you wrote them. (A library whose smart albums test each other in a circle, which LightCraft doesn't let
  you make, or test each other 32 deep, keeps testing the rules as written.) On a 312,000-photo test library, opening
  51 such albums in turn went from about 19 s to about 5.8 s (about 377 ms to 113 ms each; a busy machine,
  so rough numbers).
### A count never covers a name in the sidebar
- In the left panel, the count of a deeply indented row (a folder, keyword or album) no longer prints over its icon
  and name when the panel is narrow. It follows the name, wholly past the panel's edge, and scrolling sideways
  reaches it; so does the colour dot of a labelled folder. A row with room for its name keeps its count at the edge, as before.

### Dialog buttons say what they do
- The confirm button in dialogs now names its action instead of "OK": Create for a new album, smart album, folder or
  preset, Rename for photos, albums, keywords, people and presets, Create Stacks for Auto-Stack, Change Time for Capture Time,
  Copy and Paste for settings, and Export 12 Photos in the Export dialog. Rename Photos now explains what its Tags
  button lists and what happens on disk, instead of pointing at the button. Contact Sheet, Auto-Stack and
  Slideshow Export no longer say "1 photos" or "1 stacks". The Import review's Move button counts photos that are
  in Recently Deleted apart, since they are restored and their files stay where they are: "Move 2 Photos · Restore 1
  Photo".


### Sharper resampling in HDR and panorama merges
- Merged photos (HDR and panorama) are resampled with a sharper filter (Lanczos-3 instead of bilinear). Moving a
  photo by half a pixel used to lose a third of its finest detail; now it keeps most of it, without halos around
  hard edges such as clipped highlights.

### Scrolling past editing sliders
- Leaving a selected slider disarms its vertical mouse-wheel adjustment (issue #1355), even when the pointer leaves
  and comes back between two screen updates. Scrolling back over it now scrolls the panel instead of unexpectedly
  changing the photo. Click or drag the slider again to adjust it with the vertical wheel; keyboard arrow
  adjustments and an ongoing drag still work. A slider reached with Tab takes the arrow keys but not the wheel:
  click it to scroll-adjust it. Sideways scrolling still adjusts the slider under the pointer without selecting it
  first.

### A pinch no longer re-renders the photo at every zoom step
- Pinching the loupe now keeps the size the fit view is rendered at until the gesture is quiet, as it already did for
  the render sizes and windows. Before, each frame of a pinch asked for a new full-frame render at a new size.

### Fujifilm lens corrections that match the camera
- X-T4 raws now read the lens's own distortion and vignetting tables the way the camera does. Many photos from zoom
  lenses got no distortion correction at all (more than half of those checked from the XF16-55 and XF70-300), and
  corners came out up to 6.5 % brighter than in the camera's JPEG. The corrected photo now lines up with the camera's
  framing. Other recent Fujifilm bodies whose tables have nine knots are read the same way, but only the X-T4 was
  measured. Thumbnails are redrawn when the library next shows them.

### Reference view reliability
- Escape now leaves Reference for Detail without changing the active photo or its edits; the next
  Escape returns to the grid. A dialog, tool or Lights Out still handles Escape first.
- Opening or creating a different library clears the pinned reference. Photo IDs belong to one
  catalog; a pin no longer silently becomes another library's photo with the same numeric ID.
- Missing or Recently Deleted photos cannot be pinned. Deleting the pinned reference stops drawing
  it; re-entering Reference chooses a live photo, and restoring the deleted photo makes it pinnable again.
  In Recently Deleted, Set as Reference Photo is greyed out, and a refusal says to restore the photo.
- Switching library from Reference view goes to the grid instead of an empty Reference canvas. A refused
  or failed switch keeps both the reference and the Compare pair.
- `photo.setReference` refuses an `id` that is not a photo id (a string, a negative or fractional
  number) instead of pinning the active photo; only an absent or null `id` means the active photo.

### Edit Capture Time leaves a capture time it can't read as it was
- A capture time that is cut short, has seconds that aren't digits or has text after it (a Lightroom catalog's capture
  time is copied as it is) is no longer shifted into a clean-looking wrong time: Edit Capture Time leaves the photo as
  it was and says so, and its preview says the photo's time can't be read instead of previewing a wrong one.
  `photo.setCaptureTime` counts those photos as `unreadable`. Set date & time still repairs such a photo selected on
  its own; with other photos selected it says why it can't move them by the same amount. When the dialog can't make a
  change (a time that isn't a date, a shift past year 9999), it now says why and stays open, instead of closing.

### Month names in folder and file name templates
- Date templates take the month by name: `%B` gives January, `%b` gives Jan. Import ▸ Folders ▸ Custom template…
  `{date:%Y}/{date:%B}` files photos into 2026/January, 2026/February…, the layout many existing libraries already
  use. The names are English in every interface language, so folders don't change when the language does. Rename
  Photos and export file names take them too.

## 2026-10-20

### Windows: photos follow the monitor's colour profile
- On Windows, photos are now shown through the colour profile Windows assigns to the monitor the window is on
  (Settings ▸ System ▸ Display ▸ Color profile, Color Management, or a calibrator's profile), while no monitor profile
  is chosen in Settings ▸ Display. Before, they were shown as sRGB, so a wide-gamut monitor showed them oversaturated
  and a calibration was ignored unless you picked the profile by hand. Moving the window to another monitor, or
  changing the profile in Windows, is followed within about a second.
- While Windows manages colour itself (HDR on, or Auto Color Management on Windows 11), photos stay sRGB: Windows
  converts them for the monitor then. Settings ▸ Display ▸ **Use Screen Profile** goes back to this after choosing a
  profile by hand. See [display profiles](display-profiles.md).

### Smart albums check File Path rules faster
- A smart album rule on File Path (contains, doesn't contain, is, isn't, starts with, ends with, is empty, isn't
  empty) no longer builds new text for every photo. On a synthetic library of 312,000 photos, a File Path "contains"
  or "doesn't contain" rule took about 17 ms per pass instead of about 62 ms, around 3.5 times faster, with the same
  photos matched; about 6 ms of that is only reading the paths. Paths and rule text with letters beyond A–Z are
  compared as before.
## 2026-10-19

### AI Denoise on DirectX 12 with NVIDIA GTX 10-series cards
- AI Denoise on the GPU under DirectX 12 (the Windows default) gives the same result as on the CPU again on an NVIDIA
  GeForce GTX 1070. The driver ran the denoise network's output stores wrong, so every second pixel's colour
  channels came out shifted and the denoised photo was wrong without any error. Vulkan was not affected.

### The Before label stays in view when zoomed in
- Zoomed in, the "Before" label (\ key or the Before view) now sits at the canvas' corner instead of leaving the
  screen with the photo's corner (issue #2267).

### Synchronize Folder on a folder that is up to date
- When the scan finds nothing to import, relink, remove or read, the Synchronize Folder dialog says the library is up
  to date with the folder and has one Close button. It used to show four greyed choices, two of them still ticked,
  and a Synchronize button that started a job with nothing to do. Files it skipped (already in the library elsewhere,
  or unreadable) are still listed.

### Hidden Local locations come back one at a time
- With several locations removed from Local, "Show N hidden locations" now lists them, so each comes back on its own
  (Restore All is there too). The row used to bring every hidden location back at once (issue #2114).

### Rating in a filtered view keeps your place
- When a filter shows only one-star photos and you take the star off a photo, it leaves the view and the photo after
  it is now selected, so you carry on from where you were (issue #2312). The same goes for flags and colour labels,
  in Picks and in smart albums. Before, the photo stayed selected although the grid no longer showed it, and → or
  Auto Advance jumped back to the first photo of the view. With Auto Advance on, or with Shift+0–5, you land on the
  photo after it: no photo is skipped.

## 2026-10-18

### Thumbnails of Lightroom HDR and panorama merges in a second
- Grid and filmstrip thumbnails of DNGs that Lightroom merged (HDR, Panorama, HDR Panorama) now develop from the
  small copies of the raw image Lightroom keeps inside the file (256 to 2048 px), not from the whole merge. A 23836 ×
  7078 drone panorama's 512 px thumbnail took 38 s and now takes about a second, with the same look; your edits still
  apply. Loupe previews larger than the biggest copy, 1:1 views and exports still read the full image.

### Fewer false "not imported" warnings for Lightroom raws
- Importing raws with Lightroom XMP sidecars no longer lists settings Lightroom writes only for itself as adjustments
  that weren't imported: `CompatibleVersion`, the camera and lens profile checksums, the lens profile's name, file and
  setup, the crop's "constrain to image" option, and the lens profile's strength when it is at its default of 100 %.
  A raw sidecar used to name all of them for every photo. Settings LightCraft really doesn't apply, such as `Look`,
  are still reported.

### Fill Location from GPS: no more neighbouring town in City
- The offline place names list towns of 15,000 people or more, so a photo taken in a smaller one got the nearest larger
  town in City, sometimes another municipality (issue #2242). The Fill Location tooltip and the command help now say so,
  and `metadata.reverseGeocode` takes `maxDistance` (metres): past it, City stays empty (State and Country still fill)
  and the reply names the town it found as `nearestCity`.

### A preset that couldn't be saved is no longer lost silently
- When presets.json can't be written (a full disk, or the browser's storage quota), the new or changed preset now
  counts as unsaved, like other changes: the top bar warns, saving is retried, and quitting asks first (issue #2266).
  Before, the failure was only logged, and the preset could be lost without any warning.

### Portrait crop ratios stay portrait
- A crop ratio no longer flips to the photo's orientation (issue #2253): after X turns the crop portrait, picking
  another ratio (4 × 5, 2 × 3…) keeps it portrait, as in Lightroom, and a Custom ratio taller than wide gives a
  portrait crop.

## 2026-10-17

### Short Epson and Mamiya raws are refused
- An Epson ERF or Mamiya MEF whose raw strip runs past the end of the file is now an error on import (issue #2119).
  Before, the header probe trusted the declared strip length and sized its sample buffer from it, so a few KB of file
  could make it allocate gigabytes.

## 2026-10-16

### Synchronize Folder shows that it is listing the folder
- A folder with tens of thousands of photos, above all on a network share, can take minutes to list before
  Synchronize Folder checks a single photo. Its row in the activity stack used to sit at "0 of 64085" with an empty
  bar all that time, as if it had stopped. It now says how many folders and files it has listed so far, with a bar
  that moves on its own, and then counts the photos it checks. The dialog says the same.
- ✕ on the row stops the listing too, not only the checks after it.

### The photo grid keeps up with imports into a large library
- While photos are imported into a large library, the grid takes in each batch as it arrives instead of reading
  every photo of the view again: at about 180,000 photos a batch cost the window a tenth of a second, over and over
  for as long as the import ran. Changing one photo's capture time or crop is quicker too.

## 2026-10-15

### Photo Merge takes each photo once
- A merge that names the same photo more than once (through `ids` on the control channel, MCP or the CLI) now merges
  it once (issue #1947). Naming one photo three times no longer "merges" it with itself, and a long repeated list no
  longer decodes the photo again for every entry.

### Constrain Crop tightens the crop you see
- Geometry ▸ Constrain Crop now changes the crop itself, as in Lightroom (issue #1927). Ticking it, or moving a
  Geometry slider, Upright or a lens correction while it is ticked, shrinks the crop about its centre until the blank
  corners left by the correction are gone, and the Crop tool shows the tighter crop. Before, it only applied when the
  photo was shown outside the Crop tool, so in the Crop panel, where the checkbox is, nothing seemed to change. A crop
  you draw by hand is kept as drawn, and unticking keeps the tighter crop.

### Web: no backup that misses unsaved changes
- In the browser version, File ▸ Back Up Library… no longer reports success while a save is failing (storage full or
  cleared): the backup copies the stored library, so it left out the changes that couldn't be saved (issue #1508). It
  now refuses to start and says how many changes are unsaved and why. LightCraft retries the save with every change;
  back up once nothing is left unsaved.

### Web: an unreadable library is not opened
- In the browser version, a library file that exists but can't be read at start-up is no longer taken for a missing
  one (issue #1507). LightCraft used to open the library without it, showing an incomplete catalog that the next save
  would write over the stored copy. It now leaves the library unopened, saves nothing and says which file couldn't be
  read; reload the page to try again.
## 2026-10-14

### Model downloads time out on a name that doesn't resolve
- Model downloads (AI denoise, faces, SAM) give up on a server name that doesn't resolve within the connect timeout,
  and Cancel stops a download that is still looking the name up (issue #1532). The lookup used to block with no time
  limit, and each of a server's addresses then got the whole connect timeout of its own.

### Sony A7CR distortion correction

- Full-frame 3:2 Bayer A7CR raws with distortion Auto or forced Auto now use their embedded distortion table. The corrected render is closer to the camera JPEG geometry. Off files keep their original geometry. APS-C, aspect crops and lossless M/S remain excluded.
- The warp also supplies the geometry needed by the lens-aligned camera-look fit in PR #1586. The pairing code is a separate change. Details and numeric validation are in `docs/sony-lens-corrections.md`.

### Lightroom radial masks on the right side
- Radial masks brought over from Lightroom Classic (catalog import, XMP sidecars, edits inside DNGs and presets) now
  apply their effect inside the circle, as Lightroom does, instead of outside it (issue #1815). A mask inverted in
  Lightroom stays inverted, and older Radial Filters keep their Effect Outside / Invert Mask setting. Photos imported
  before this keep the masks they got: Photo ▸ Read Metadata from File reads a sidecar's again.

### Delete in an album removes from the album only
- In an album, the Delete key now takes the selected photos out of the album, as in Lightroom. It used to move them
  to Recently Deleted, so they also left their folder's view (issue #1805). They stay in the library and in their
  folder; Edit ▸ Undo puts them back in the album. Photo ▸ Remove from Album does the same and now shows the key.
  To delete photos from the library from an album, use Photo ▸ Delete Photo or right-click ▸ Delete Photo. In a smart
  album, Delete changes nothing: its rules decide what it shows.

### Local folders select a photo
- Showing a Local folder now makes its first photo the active one, as albums and the other sources do (issue
  #1447), or keeps the photo you had when the folder holds it. Before, the photo from the previous view stayed active:
  Photo Grid marked nothing, and Detail, the histogram and the photo info showed a photo that isn't in the folder.

### Nikon Z 6II, Z 8 and D5300 colour profiles
- Raws from the Nikon Z 6II, Z 8 and D5300 now start from a colour profile built from a few hundred photos from each camera, the same way the
  Sony and Fujifilm profiles were made, instead of fitting each photo's colour on its own. Colours that one photo
  shows only a little of come out closer to the camera's JPEG.

### Closer camera colour for lens-corrected raws
- Raws from cameras that correct their own JPEG for lens distortion (Panasonic and Fujifilm with that setting on, the
  Sony A7R IVA) now start from colours closer to the camera's. The starting look was being fitted against a JPEG that
  didn't line up with the raw near the edges. Photos you already imported pick this up when their previews are rebuilt.

### HDR merges of moving lights, and many brackets at once
- A star, the moon or a light that moves between the photos of a bracket (a night bracket on a tripod) no longer
  leaves a black hole where the middle photo had it clipped. With Deghost, the brightest photo's copy of it in a
  dark sky is now removed too.
- Photo ▸ Photo Merge ▸ HDR for Each Bracket Set merges every bracket among the selected photos with the last HDR
  settings, one after the other: each stack, and photos taken less than a second apart at different exposures.
  From the command line: `lightcraft-cli merge hdr-batch FOLDER`.
- Merging uses about a quarter less memory: three 67 MP raws need 3.8 GB instead of 4.8 GB.

### XMP sidecars catch up after a network share comes back
- With automatic XMP writing on, an edit to a photo whose folder can't be written (a network share that dropped
  out, a folder that went read-only) used to be written only to the library, with a line in the log, so the sidecar
  stayed behind the edit. LightCraft now says once that the sidecars are waiting, tries again every few seconds once
  the files are reachable, and says when they're written. `library.retrySidecars` does it on request.

### Reliability
- A damaged or crafted raw can no longer make LightCraft set aside gigabytes of memory before finding out the file is
  bad (issue #1512): a compressed PEF whose data is too short for the size it declares, an uncompressed TIFF-based
  raw whose tile claims far more samples than it holds, and an ARW6 with a broken tile are refused first. All 74
  files in the test corpus still decode.

### Reliability
- Thumbnails and previews are written to the cache on disk by one background writer instead of a new thread for
  each image (issue #1522). When renders come in faster than the disk takes them, at most 128 MB of images wait;
  past that a write is skipped (the image stays in memory and is written by a later render), so a slow disk can't
  pile up threads and memory.

### Reliability
- Saving the catalog and resuming a model download no longer write through a link left at the temporary file's
  name (`catalog.snap.tmp`, `model.onnx.part`): the link is removed and a new file made in its place, so the file it
  pointed to is never changed (issue #1502).

### Reliability
- A photo whose file was replaced (Reload Changed Files after an outside edit) no longer keeps the faces recognition
  made from the old pixels: they are made again from the new file, and a scan still busy with the old file when it
  changed doesn't put its faces on the new one (issue #1524).

### Settings stays put when you change tabs
- The Settings window keeps its top edge and width when you switch tabs, so the tab row no longer jumps around
  under the pointer. It used to be centred, so every tab of a different height moved it.

### Layout image over the loupe
- View ▸ Loupe Overlay ▸ Choose Layout Image… draws a PNG with transparency over the photo in the loupe, such as
  a magazine cover's masthead and cover lines, so you can frame a shot for the page it is made for. It fits inside
  the photo, follows zoom and pan, and ⌥⌘O shows or hides it. The same menu sets its opacity and a matte that
  darkens the photo outside it. The layout stays chosen across launches.

### Smaller JPEG exports
- JPEG exports are 12–14 % smaller at the same quality, with exactly the same pixels (issue #1373): each file now
  carries Huffman tables made for its own picture instead of the standard example tables. Every viewer opens them
  as before.

### Reliability
- A photo whose Defringe amount was stored far past the sliders' 20 (in a damaged catalog or sidecar) no longer
  crashes LightCraft each time it renders: the amount acts as 20.

### Lens names for Nikon DSLR raws
- Photos from Nikon DSLRs like the D700, D750, D80 or D5300 now show which lens they were taken with, for example
  "24.0-70.0 mm f/2.8". Those cameras don't write a lens name, so the lens field was empty and you couldn't filter or
  search by lens. LightCraft now reads the lens range Nikon keeps in its own maker note, the way Lightroom shows a
  lens it doesn't have a name for. Newly imported photos show it.

### Import when a card is connected
- Settings → Import → Cameras and Cards has an option to open the import review as soon as a camera or memory card
  is connected, the same review File → Import from Device opens. It's off by default. A card that's already in when
  LightCraft starts doesn't ask, and if a dialog is open or an import is running it waits until that's done.

### Local folders
- Photos deleted (or moved) by another app no longer stay in a Local folder, failing to load and logging an error
  each time you look (issue #1392): the next time you browse the folder, in a later session, they're left out. A photo you had rated, flagged or
  edited stays, marked missing, so its changes aren't lost; photos in My Photos are unchanged.

### Full-resolution panoramas
- Panorama and HDR Panorama merges keep the resolution of their photos instead of stopping at 40 megapixels
  (issue #1455), up to 512 MP and 65,000 pixels on the long edge, as in Lightroom. When the full size needs more
  memory than the computer has, the panorama is made as large as fits (five 51 MP photos: up to 166 MP with
  16 GB, 355 MP with 32 GB) and the message says so. The merge also frees each photo's pixels once they are
  projected, so it needs less memory than before at any size (an 81 MP stitch: 4.4 GB instead of 6.2 GB).

### Nikon D600, D610 and D5000
- Raws from the Nikon D600, D610 and D5000 no longer show a bright line down the right edge (issue #1627). Their
  sensor data runs a few columns of filler past the picture, which stayed in the image; these bodies now develop
  at the camera JPEG's size (6016 × 4016 for the D600 and D610, 4288 × 2848 for the D5000, as the D90 already
  did). On the D600 and D610 the white level is also measured inside the picture, so the filler can't pass for
  clipped highlights.

### More Canon EOS R6 Mark II C-RAW files decode
- Some EOS R6 Mark II C-RAW files (about 1 in 50 in one photographer's library) opened as their preview with
  "Canon CRX adaptive QP value 172" or "175". They now decode from the sensor data. Photos imported before this
  switch over with Photo ▸ Reload from Disk.

### Nikon raws without coloured edge bars
- Raws from older Nikon bodies no longer show a thin coloured or dark bar along one edge (the right edge, or the top
  of a portrait photo): masked sensor columns were being developed as part of the picture (issues #976, #914,
  #1236). The D7000, D5100, D800, D800E, Df, D4, D3, D3S, D700, D300, D300S, D600, D610, D810, D4S, D5600,
  Coolpix A, D3000, D40X, D60, D80, D2Xs, D200, D3200, D3100, D5000, D40, D50, D70, D70s and Nikon 1 V1 now show
  the area the camera itself frames, a few pixels smaller than before.
### An empty library leads to Import
- A library with no photos now opens on the Photo Grid with the sidebar (Square Grid stays as it is), instead of a
  Detail view that pointed at an empty grid. The grid and Detail view offer Import Photos… and, in the desktop app,
  Import Lightroom Catalog… as buttons, and say that photos (and, in the desktop app, folders) can be dropped into
  the window. The shortcut they show is the one Import Photos… has now.
- The top bar has an Import button, beside Export, in every library.

### Reliability

### One kind of button
- Dialogs' buttons and About's Discord link are drawn by one button component: primary (filled with the accent),
  secondary, danger (filled red) and ghost, in three sizes, with an icon or without, and an icon alone (named for
  screen readers). Each darkens a little when hovered and more when pressed, shows a ring where the keyboard is, and
  its text reads at 4.5:1 or more on its fill in every theme. Dialog buttons are 30 points tall, like the welcome's.

### A dialog's confirm button says it's the next step
- In dialogs, the confirm button is on the right with Cancel to its left, and filled with the accent when it makes or
  brings in something (Import N Photos, Merge, Save, Create, Download…). Delete and Remove stay plain, so a destructive
  choice is never the eye-catching default.
### Straight brush strokes with ⇧-click
- With the brush, click once, then ⇧-click somewhere else: the brush paints a straight line between the two, and
  further ⇧-clicks carry on from the last point, as in Lightroom. Change the brush size, feather or flow before the
  ⇧-click and the line tapers from the old values to the new ones. The whole line is one undo step.
  `mask.brushStroke {connect: true}` does the same for agents.

### Local folders you browse are kept
- Browsing a folder under Local now records it as browsed, so the photos in folders you use aren't forgotten after
  the number of days set in Settings → Performance. Only the `library.browse` command recorded it before, so a
  folder browsed every day from the sidebar was forgotten anyway and read again from scratch on the next visit,
  which is slow on a network share.

### Hard-edged Heal and Clone spots
- A spot with Feather at 0 no longer draws black pixels exactly on its radius. This also fixes spots at 0% Opacity
  changing pixels along their edge. The hard edge now leaves pixels on the radius unchanged.

### Search finds people
- Typing a person's name in Search Photos finds the photos with that named face (issue #1449).
- Quotes keep several words together: `person:"Jane Doe"` finds exactly that person, `"jane doe"` those words side
  by side, and `keyword:"new york"` a keyword of two words.

### Where the camera focused
- **View ▸ Show Focus Point** (⌥F) draws the autofocus frame the camera recorded over the photo, in Detail, Compare
  and Survey, following rotation and crops; the Info panel says how it focused (`AF-C · Wide · Animal Eye Tracking`).
  Lightroom has no such view.
- **Z zooms to it**: Toggle Zoom centres on the focus point, so checking that the subject is sharp is one key
  (View ▸ Zoom to Focus Point turns this off). Photos without a point zoom as before.
- Sony α1 (ILCE-1) and A7S III (ILCE-7SM3) raws for now; manual-focus shots and Wide shots that only report the frame
  centre show nothing. More cameras will follow. Details: [focus-points.md](focus-points.md).
- **Photos already in your library get theirs in the background**: LightCraft reads just the few kilobytes of each
  file that hold the focus point (about 100 photos a second from a spinning disk), with a *Reading focus points* row
  in the activity stack you can stop. Photo ▸ Read Focus Points runs it by hand.

### Cleaner HDR merges
- Bright windows in an HDR made with Photo ▸ Photo Merge ▸ HDR no longer take a magenta tinge from the brighter
  photos along the areas they clipped: right next to a clipped area, a photo's colour isn't used. It showed most when
  the highlights were darkened or saturated.
- The same photos give the same HDR whatever order they are selected in; before, a different order could change a
  few pixels.

### HDR merges keep the white balance
- An HDR merged from raws that LightCraft colours from the camera's JPEG (CR2, NEF, ARW…) now opens at the same
  As Shot temperature and tint as its photos, and changing the white balance no longer turns it green. Sony ARW
  merges used to open at about 7000 K / +115 where the photos show 4000–5300 K / +8. HDRs merged before this keep
  their old white balance; merge them again.

## 2026-10-13

### Edits keep up in a large library
- A small edit (a keyword, a rating, a flag, a slider) no longer has the grid's list worked out again from every
  photo: only the photos the edit touched are asked about again and put at their place in the order. In a library of
  67,000 photos that step went from 37 ms to under 1 ms. Still worked out whole: an edit to more than 256 photos, a
  change to an album, a stack or the keyword list, an album shown in its own order, Recently Added, Missing Photos,
  and a view that asks about "the last N days".
- With no filter set, the count of the source is taken from the list instead of from a second pass over the library.
- The side panels keep a tally an edit cannot have changed: a rating or a slider changes none of the folders,
  keywords, dates, people and counts; a keyword leaves the folders, the dates and the counts as they are. With both
  side panels open, the frame after a keyword went from about 156 ms to about 54 ms in that library (2 ms with the
  panels closed, from 71 ms).
- The count beside each smart album in the left panel follows an edit the same way: the album asks only the photos
  the edit touched, where it asked every photo of the library after each edit (about 25 ms an album in that library).
  With that, the frame after a keyword is at about 29 ms there. New rules, a change to an album or the keyword list,
  an edit to more than 256 photos, and each new minute for an album that asks about "the last N days" are still
  counted from every photo.
- Still tallied from every photo on each edit: the filter bar's lists of cameras, lenses and keywords.

### A view can hold its photos until you refresh it
- View ▸ Hold View Until Refreshed (off unless you turn it on; kept with the library). With it on, an edit that makes
  a photo stop matching the view keeps it in the view: a keyword given in a smart album of photos without keywords,
  a flag taken off in Picks, a rating that falls under the filter bar's. With it off, as before, the photo leaves the
  grid at once and every photo after it moves up. View ▸ Refresh View (also in the sort menu while the hold is on),
  Reshuffle, another source, filter or sort, or new rules for the smart album shows what matches now.
- Photos that start matching still appear at once, and deleting a photo or taking it out of the album or folder
  shown still takes it out of the view.

### The window opens at the size you left it
- LightCraft's window opens at the size it had when you last used it, and zoomed (macOS) / maximized if it was: it
  used to open at 1600 × 1000 every time. Double-click the top bar to zoom the window, quit, and it is zoomed when
  you come back; un-zoom it and it goes back to the size it had before.
- Full screen is not remembered (the app opens as a window), and neither is where on the desktop the window was:
  the system places it.
- On macOS the system does not tell LightCraft when a window is zoomed from the Window menu or resized after a
  zoom, so it goes by the window's size, and when in doubt takes the window for a window of the size it has: it
  comes back as large as you left it, but not as a zoomed window. That is so after a zoom from the Window menu
  with the Dock at a side of the screen, or of a window already as wide as the screen. Zoomed by a double-click
  on the top bar it comes back zoomed. The other way round, a window you drag out until it is as wide as the
  screen and nearly as tall counts as zoomed.
- For scripts: a size set with `ui.resize` is remembered like any other, so a script that needs a size sets it.

### Keyword List: a keyword shows that one inside it is applied
- In the Keyword List (right panel ▸ Keywords), a keyword whose box is empty now carries a dot in it when the
  selected photos have a keyword inside it, at any depth: with `Places › Italy › Rome` on a photo, `Places` and
  `Italy` show the dot and `Rome` the tick. A folded keyword no longer hides that something in it is applied.
  Resting on the box names what is inside.
- The tick and the dash are as they were, and are about the keyword itself: all of the selected photos have it, or
  some do. A keyword the photos have themselves shows that, not the dot. A click on the box still gives the
  keyword itself to the selected photos.

### HDR merges keep the lens correction
- An HDR made with Photo ▸ Photo Merge ▸ HDR now keeps the lens correction the photos carry (Sony's, Panasonic's
  and Leica's, and the one some DNGs carry, e.g. from drones): Optics ▸ Enable Lens Corrections straightens it as it
  does the photos it was made from. HDRs merged before this don't have it; merge them again.

### Portable mode
- A file named `portable.txt` next to the LightCraft program makes it keep its settings, logs and downloaded
  models in a `LightCraftData` folder beside it instead of the per-user settings folder (issue #1200), as
  PhotoCraft does. If that folder can't be written, the usual folder is used and the log says why.

### Reliability
- Importing a preset zip that unpacks to far more than any preset (a "zip bomb") is refused with a message naming
  the file, instead of asking for gigabytes of memory, which could end LightCraft.

### Reliability
- A crop of no size (from an agent or a sidecar) no longer gives the Detail view a photo of no size to lay out
  (its width over its height was 0 / 0, which stopped debug builds); it shows as a single pixel's colour.

### Reliability
- A crop a hair wide (or of no size), set by an agent or read from a sidecar, no longer crashes or hangs the
  render with Clarity, Dehaze, Texture or Highlights / Shadows on: their blurs are held to the picture's size.
- A crop of no size with healing spots or masks no longer crashes the render: samples outside the picture read its
  edge.

### Reliability
- A library whose catalog file was damaged (or edited by hand) in a way that still reads no longer crashes
  LightCraft when it shows a stack, or hangs it when a folder is moved: on opening, records are put back under
  their own ids, stacks keep only photos that exist (at least two), folders inside themselves move to the top,
  and new photos never reuse an id in use. What was repaired is written to the log.

### Nikon lens corrections
- Raws from the Nikon Z 6II, Z 8 and Z f now open with the camera's own distortion correction, as Lightroom applies a
  built-in profile: straight lines near the edges stay straight and the framing matches the camera's JPEG. It works
  with Z lenses and with F-mount lenses on the FTZ adapter, follows the in-body stabilisation's shift of the optical
  centre, and can be turned off under Lens Corrections. Vignetting correction from the file comes later.

### Thumbnail cache stays in its folder
- The thumbnail cache no longer follows a shard folder (`thumbs/ab/`) that is a symlink or junction to somewhere
  else (issue #1504): trimming or clearing the cache can't delete files outside it, and thumbnails are never read
  from or written through such a link.

### Synchronize Folder asks a network share less
- A Synchronize Folder scan no longer asks the disk about every photo of the library in the folder (is its file
  there, has it a sidecar): it has just listed the folder, and reads the answers off the listing. On a network share
  each of those questions is a round trip. Measured on a hard disk over SMB, for folders of 1,600 to 2,400 photos
  that had not changed: 4.6 to 7.1 s of questions after the listing (about 3 ms a photo), now under 0.05 s. The
  listing itself took 4 to 5 s and is as it was.
- The disk is still asked wherever a listing can't be sure what a file system would say: about a name that is
  there in another case, a link, a name Windows reads another way (`aux.jpg`, a `~`, a `:`, a dot or a space at the
  end), a folder the scan did not walk to its end, and, in a folder that holds any name with a character outside
  ASCII (an umlaut, a curly apostrophe, a dash), about every name the folder does not list. Names it does list are
  answered there too. In such a folder the scan saves less, and its checks now start after the listing where they
  ran beside it.
- A photo the folder lists is there for the scan, also where its file could not be opened by its path (a folder
  that may be listed but not searched, a path longer than the system takes): such photos used to be listed as
  missing. And a share that drops after the scan has listed a folder no longer turns that folder's photos into
  missing ones.

### Large libraries: Synchronize Folder, import and sidecars start sooner
- Opening Synchronize Folder, an import review or an import no longer makes a table of every photo in the library
  before it looks at the first file. In a library of 3.5 million photos that held the window for about 6 s before
  a Synchronize scan began (now under 1 s), 2.6 s before an import review (now 0.05 s) and 1.7 s before an import
  (now 0.05 s). The scan looks up only the files it finds and the contents it reads, on its own thread.
- Writing one photo's XMP sidecar (Save Metadata to File, or automatically after an edit) no longer works out who
  owns every shared sidecar name in the library: 2.4 s a write in that library, now under 1 s.
- Nothing else changes: the same files are found new, already there, moved or missing, and sidecars get the same
  names.

### Faces load faster in the People view
- Faces on unedited raws are cut from the camera's preview inside the file instead of developing the raw (issue
  #1440): a Sony α1 face reads 8 MB instead of 70 MB, an A7S III face about 1 MB instead of 24 MB, several times
  faster on an external hard disk. A face whose preview is too small, and any edited photo, is still developed from
  the raw, so it keeps its look.
- Raws whose preview is in Adobe RGB (Sony α1 among others) no longer read the whole file for their grid thumbnail:
  only the header and the preview are read, as for other raws.
- Faces are kept in the thumbnail cache at a few fixed sizes, so moving the thumbnail slider no longer renders them
  all again.

### Reliability
- A raw file whose black level is stored as "not a number" (or infinity), or a floating-point DNG with such
  samples, no longer crashes LightCraft at 1:1 or on export: the bad values read as black.

### Reliability
- Exporting a photo more than 65,535 times as long as it is wide (a one-pixel strip), or opening the Export dialog's
  watermark preview for it, no longer crashes LightCraft; the export is capped at the encoders' 65,535 pixels.

### Reliability
- Dragging a Tone Curve point that sits very close to its neighbours (two clicks side by side, or a curve from a
  sidecar, a preset or an agent) no longer crashes LightCraft; the point stays between them. Curve points sent to
  `develop.curve` are kept in order, and a sidecar curve with a "NaN" or "inf" point is ignored.

### Reliability
- A demo photo whose stored size was damaged (a width of 4294967295) is rendered at its own size instead of
  one that overflows.

### DNG camera identity
- DNG export and Convert to DNG no longer duplicate the camera make when the model already
  contains it: `Canon EOS R6` stays `Canon EOS R6`, rather than `Canon Canon EOS R6` (the camera
  identity subissue in #840). The separate Make and Model tags keep their original values.
  This does not change colour matrices, camera calibration or RAW noise rendering.
### Building from source
- The English and Simplified Chinese build guides now describe command-local job and release
  profile overrides for memory-constrained builders (issue #1196), including why packaging
  recipes can override inherited settings. Default release profiles and application behavior
  are unchanged; the guidance does not guarantee a build will fit every 16 GB machine.
### Lightroom catalog import
- A Lightroom Classic catalog whose changes are all still in its `.lrcat-wal` file (a new catalog Lightroom has
  open and hasn't written back yet) imports instead of failing with "unsupported SQLite schema format".

### Reliability
- An export enlarged far past the photo's size (20000 typed for 2000 with Don't Enlarge off) no longer ends
  LightCraft: an enlargement stops at 512 megapixels, as in Lightroom, and one that needs more memory than the
  computer has is refused with the size it would take, before it starts.
### Confirm matching faces together
- On a person's page, the ↑ control on a suggested face confirms it and all shown suggestions with equal or higher
  similarity as one undo step. Hover or focus that face and press A for the same action; hidden suggestions stay hidden.

### Noise reduction looks the same at every size
- Luminance and colour noise reduction no longer look much stronger in grid thumbnails and the filmstrip than in
  the loupe (issue #960). Their radii are now set in the original photo's pixels, so a thumbnail, the fitted loupe
  and a smaller export look like the full-size result scaled down; 1:1 views and full-size exports are unchanged.
  Like in Lightroom, judge noise reduction at 1:1: at small sizes the noise it removes is mostly averaged away.
  Cached thumbnails are redrawn.
- When the graphics driver resets the GPU while LightCraft is exporting or rendering (issue #1337, seen on Windows
  with NVIDIA), LightCraft still stops, because its window can't keep drawing on the lost device, but it now says
  "LightCraft stopped unexpectedly" and why, instead of "could not open its window", and the next start renders
  on the CPU and explains how to turn the GPU back on.

### Resetting a slider
- Resting the pointer on a slider's name or its thumb now says that a double-click resets it ("Exposure — double-click
  to reset it"), in every language (issue #1436).
- A double-click on the thumb is a single step in History and Undo. Its first click no longer nudges the value to
  where the pointer landed, and a single click on the thumb leaves the value alone.

### Slider drags on large raws
- Dragging a slider no longer re-renders the edited photo's filmstrip thumbnail on every frame; it follows once you
  let go. On a 64 MP raw the first of those renders decoded the whole file again, which held up the loupe's
  previews for up to a second.
- A thumbnail of the photo open in Detail is made from its already decoded preview instead of decoding the file
  again.
### Dehaze while zoomed in
- With Dehaze on, panning a photo zoomed to 1:1 or moving a slider while zoomed no longer samples the whole
  original again to find the haze colour. On a 64 MP raw (Sony A7R VI) that took ~0.2 s of CPU per pan and per
  slider step; a slider step now takes ~5 ms on the GPU.
### Thumbnails of raw files appear sooner
- Grid thumbnails and the first picture in the loupe of an unedited raw now come from the smallest JPEG the camera
  stored that is big enough, not always from the largest one. On a Sony A7R VI file a 512 px thumbnail decodes
  0.3 MB of JPEG instead of 5.6 MB and is ready several times sooner; Nikon and Panasonic raws with a mid-sized
  JPEG get faster too.
## 2026-10-12

### Canon CR2 highlights
- Blown highlights in CR2 files from the Canon EOS 50D, 60D, 450D (Rebel XSi), 500D (Rebel T1i), 550D (Rebel T2i),
  1200D (Rebel T5) and 100D (Rebel SL1) now count as clipped (issue #1272). They used to stop at 81–98% of white, so
  highlight recovery missed them and, darkened, they took a colour cast instead of going neutral grey.
## 2026-10-12

### Pentax raws without black borders
- Raws from the Pentax KP, KF, K-3 Mark III (and Monochrome), K-70, K-1, K-1 Mark II, K-S1, K-S2 and 645Z no longer
  show a black (or, on the 645Z, white) band along one or more edges (issue #1271). The sensor's masked border is
  left out, so these photos come out a little smaller, closer to the camera's own JPEG. Crops and masks on photos
  edited earlier may shift by a few pixels.
## 2026-10-12

### Camera-look deep shadows

- The starting look fitted from a raw's camera JPEG now uses its darkest tones too (issue #1307).
  Photos with deep shadows no longer have to extend the first measured tone in a straight line to black.
  Existing smart previews are refreshed when their originals are online, and cached renders are redrawn.
### Slider drags follow the pointer more closely
- With a GPU, a slider drag's preview is drawn in the same frame as the slider moves instead of one frame later,
  when the preview renders in a few milliseconds (it waits at most 40 % of a frame for it; slower renders, such as
  on the CPU, are not waited for).
## 2026-10-12

### Kelvin white balance for more Sony cameras
- Sony ILCA-99M2, ILCA-77M2, SLT-A33, DSC-RX10, ILCE-3500 and ILCE-7S raws now show white balance in Kelvin too,
  read from the white-balance presets the camera stores in every ARW: a photo shot at 3400 K on the camera reads
  3396 K, one on the Shade preset 7493 K. As for #730, only the numbers change: edits made on the old relative
  scale keep their look, and As Shot shows the real temperature once the file is opened.
## 2026-10-12

### Bold text in other scripts
- Arabic names and other Arabic text in headings, chosen tabs and other bold places are now drawn bold, as Latin text
  beside them is; they used to stay at regular weight.
## 2026-10-12

### Older raw cameras
- Canon PowerShot G9 raws open with the camera's white balance (White Balance ▸ As Shot); it used to start from a
  neutral default.
## 2026-10-12

### Older raw cameras
- Olympus E-10 raws open with the camera's white balance (White Balance ▸ As Shot) and without the grey haze in
  the shadows: the black level recorded in the file is now subtracted.
### Told when there is no GPU
- When GPU rendering is on but no graphics processor can be found, LightCraft now says so once at start-up instead
  of quietly rendering everything on the CPU, much more slowly. Help ▸ System Info says why. On NixOS this happens
  when a `cargo` build runs outside `nix develop` (no Vulkan loader); start it from there.
## 2026-10-12

### Leaf and Hasselblad raws
- The Hasselblad Lunar's raws (a Sony NEX-7 inside) now develop from their sensor data with every editing tool,
  instead of opening as their embedded preview. Photos imported earlier switch over with Photo ▸ Reload from Disk.
- An uncompressed Leaf Aptus 22 MOS no longer opens as a dark, colourless picture of its sensor mosaic: it imports
  as a raw and shows its embedded preview (preview only, with the reason), as the compressed MOS files do.
## 2026-10-12

### Zoomed 64 MP raws stay decoded
- Panning a photo zoomed to 1:1, or moving a slider while zoomed, no longer decodes the whole raw again each time on
  high-resolution cameras such as the Sony A7R VI (64 MP). Their decoded original (~800 MB) is bigger than the
  default cache share (768 MB), so it was evicted as soon as it was stored. The original of the photo shown in Detail
  now stays, like its preview, until another photo or view is shown.
- Zooming in with Before/After side by side decodes the original once: the Before side used to decode its own copy
  beside the After's, and a window asked for again while the first was still decoding (a pan, the layout settling)
  started yet another decode.
- A zoomed view keeps the GPU copy of the original while it is on screen: pausing for a few seconds between pans no
  longer frees it, which cost a re-upload of about a second on the next pan (800 MB for a 64 MP raw). It is freed
  once you zoom out or move on.
- The kept original no longer pushes everything else out of the cache: on a 64 MP raw it filled the cache share
  alone, so the photo's preview and thumbnail sources and its neighbours' were decoded from the raw again on every
  edit at 1:1, every zoom out and every step to the next photo.

## 2026-10-11

### Keywords panel
- The titles **Keywords** and **Keyword List** in the Keywords panel fold their sections shut and open again, so
  the list of every keyword is one click away however many keywords the selected photos have. What is folded is
  remembered.
- Settings ▸ Interface ▸ Keywords of the selection ▸ **Grouped by parent** lays the selected photos' keywords out by
  the keyword they are inside: "Places › Italy" once, on a line of its own, with Rome, Venice and the others side by
  side under it. A long list stops after eight lines with "+N more", and the suggestions say only the keyword's own
  name. Whole names, one chip per keyword, stays the default.
- A selection without keywords now says "No keywords yet" where its chips would be.
- Typing in **Add keyword** offers the library's matching keywords right under the box. ↓ and Return (or a click)
  give the offered keyword and keep the cursor in the box for the next one; Return alone still adds what you typed.
  A name the library doesn't have is marked as a new keyword before you press Return, so a misspelling no longer
  becomes a keyword unnoticed. The suggestions further down stay put while you type.
- With several photos selected, the Keywords panel says how many photos its keywords belong to. The × on a keyword
  is a larger target that lights up on its own, and taking a keyword off several photos at once now says which
  keyword left how many photos, and that Edit ▸ Undo puts it back.

### HDR and panorama merges of CR2 keep their colour
- Photo Merge of Canon CR2 (and other raws whose colour LightCraft fits from the camera's own JPEG, such as NEF and
  ARW) gives the merged DNG the colour each photo has when opened alone (issue #965). An HDR merge of CR2s used to come
  out green and dark.
### "Rendering…" on the photo
- The loupe says "Rendering…" at the bottom of the photo when what it shows isn't the finished photo yet: the
  camera's embedded JPEG while a raw decodes, the previous render while an edit renders, or the magnified frame
  while the 1:1 detail is on its way. It appears once that has lasted half a second, so quick renders never show it.
- If LightCraft can't open a photo (its original is on a drive that isn't connected, or the file is damaged) but has
  its embedded JPEG or a thumbnail to show, the loupe now says so at the bottom of the photo ("Original offline · no
  smart preview" or "This photo can't be opened", the reason on hover) instead of showing that preview as if it were
  the photo.
### `--import <folder>` takes HEIC
- `lightcraft-cli run --import <folder>` (and the MCP tools that take folders) now picks up HEIC, HEIF and Nikon NRW
  files, the same files as `library.import` (issue #1080). They used to be skipped without a word.
- Compare and Reference View panes say "Rendering…" (or that the photo can't be opened) the same way, so a
  magnified preview isn't taken for the photo when checking focus at 1:1.

### Lens corrections
- Sony A7R VI (ILCE-7RM6) raws are corrected for lens distortion from the table the camera records in each file,
  under Optics ▸ Enable Lens Corrections, on by default for newly imported photos. On 33 photos shot with the camera's
  correction on (24–70 mm, 100 mm macro, 200–600 mm) the render lines up with the camera's JPEG within 0.68 px at
  1440 px at the corners, where it was up to 17 px off before. The camera's lateral chromatic aberration table is read
  too, but not applied by default: our demosaic already hides most of that colour fringing, and the table on top made
  it slightly worse. The vignetting table is read but not applied: the camera's own JPEGs don't apply it either. This
  covers lossless, Compressed and Compressed HQ (ARW 6.0) ARWs alike. The A7R IVA (ILCE-7RM4A) has its own distortion
  correction, checked against Sony's exports; other Sony bodies record the same tables, but they stay uncorrected until
  they are checked the same way. Photos imported earlier get the correction with Photo ▸ Reload from Disk (when still
  at their import settings). See `docs/sony-ilce7rm6-lens-corrections.md`.

### The thumbnail cache is no longer taken for your photos
- LightCraft's cached thumbnails no longer show up in Windows Photos / Gallery or other photo apps as pictures of
  yours (issues #610, #1066). They were ordinary `.jpg` files in the library's `thumbs` folder, which is usually
  inside Pictures, so every thumbnail (one for each photo, size and state of its edits) was listed as a photo.
  They are now kept under a name that is no picture's. The ones already there are taken over, not rendered again:
  the first time a library opens after this update, "Tidying the thumbnail cache" shows in the activity stack
  while they are renamed (it can be stopped, and goes on at the next open).
- Opening a library no longer rewrites the date of every thumbnail it shows, which made them all look new at each
  launch. Reading a thumbnail writes nothing (but for one that went unused for a week, whose date is brought
  forward); what was read is remembered for the session, so a full cache still lets go of what is not in use first.
- A `thumbs` folder that holds nothing but the cache says that it is one (`CACHEDIR.TAG`), so backup programs that
  go by that can leave it out. It is safe to delete while LightCraft is closed, as before. A `thumbs` folder that
  also holds files of yours (a library opened on a photo folder that had one) is not tagged, and your files in it
  are left as they are. Note that files there named exactly like the cache's own (`ab/ab…` with 32 hex digits and
  `.jpg`) have always been taken for the cache's, and are renamed with it.
- If you go back to an older version, it renders its thumbnails again as `.jpg`. This version then takes those
  over one by one as they are used; the rest stay until the cache makes room.

### Nikon raws without coloured edge bars
- Raws from older Nikon bodies no longer show a thin coloured or dark bar along one edge (the right edge, or the top
  of a portrait photo): masked sensor columns were being developed as part of the picture (issues #976, #914). The
  D7000, D5100, D800, D800E, Df, D4, D3, D3S, D700, D300, D300S, D600, D610, D810, D4S, D5600, Coolpix A, D3000, D40X,
  D60, D80 and D2Xs now show the area the camera itself frames, a few pixels smaller than before.

### JPEG XL export
- Export as JPEG XL (issue #247): Format ▸ JPEG XL in the Export dialog, `format: "jxl"` for agents and the CLI
  (`render in.raw -o out.jxl`). Quality as for JPEG, or Lossless; Effort (Fast / Normal) trades time for a
  smaller file; Progressive files show a coarse version first. 8- or 16-bit, sRGB, Display P3 or Rec. 2020 (lossless
  files also Adobe RGB and ProPhoto), metadata as for JPEG. With HDR output, photos edited in HDR are written as
  16-bit Rec. 2020 PQ. Not in the web version yet.
- Lossy JPEG XL files in Display P3 or Rec. 2020 now open in their real colours; saturated colours used to come in
  noticeably duller.

### Export next to the originals
- The Export dialog has Export to: Specific folder (as before) or Same folder as original photo, like Lightroom
  Classic (issue #956). With the second, each photo is exported into the folder its original is in, plus the
  Subfolder if you give one (say `Exports`), so a batch from several folders lands next to each set of originals.
  "If file exists" works per folder as usual, and an original is never written over.
- A photo that has no folder on disk (a demo photo, or one in the web version's browser storage) or whose folder
  is missing (moved, drive unplugged) is not exported; it gets its own error naming it.
- The choice is saved in export presets and Export with Previous. Agents pass
  `destinationMode: "sameAsOriginal"` (or `"specificFolder"`) to `app.export`; `dir` is then not needed.

### Alt/Option-drag previews
- Hold Alt (Option on macOS) while dragging Exposure, Highlights or Whites to see which areas clip to white: the
  photo turns black, fully clipped areas show white and areas clipped in one or two channels show those channels'
  colour. Shadows and Blacks do the same for clipping to black, on white (issue #937).
- In Detail ▸ Sharpening the same key shows Amount in greyscale, Radius and Detail as the fine detail being
  sharpened, and Masking as the mask: white is sharpened, black is protected. Radius and Detail don't change the
  render yet, so their preview stays the same while you drag them. Noise Reduction's Luminance, Detail and Contrast
  show the photo in greyscale.
- The preview lasts while the key and the slider are held, and never changes the edit, its history or exports.
- Linux: KDE Plasma (and some other desktops) move windows with Alt+drag. If Alt+drag moves the window instead,
  set the window manager's move modifier to Meta.

### Open Library knows a Lightroom catalog
- Choosing a Lightroom Classic catalog folder in File → Open Library… (or one of its `Previews.lrdata` /
  `.lrcat-data` folders, or the `.lrcat`) no longer makes an empty LightCraft library inside it (issue #891). The
  library open now stays, and LightCraft says "This is a Lightroom catalog, not a LightCraft library" and offers
  **Import Lightroom Catalog…** with that catalog, or Cancel. `lightcraft-cli --library` refuses those folders too.

### Canon EOS R5 Mark II
- Canon EOS R5 Mark II C-RAW files that opened as "preview only" (more than half of them, depending on the
  scene) now develop from their sensor data with every editing tool, like the camera's other raws. Photos
  imported earlier switch over with Photo ▸ Reload from Disk.

### Switching libraries
- File ▸ New Library… asks for a name, then where to put it, and opens the new library (issue #902).
- File ▸ Open Recent Library lists the last 8 libraries; ones that are gone (moved, drive disconnected) are greyed
  out. Clear Recent Libraries empties the list.
- The open library's name shows under My Photos at the top of the left panel and in the window title.
- `lightcraft-cli --library` given a library's own file (`catalog.snap`) opens its folder instead of failing with
  "File exists".
- Agents use `app.newLibrary {path, name}`, `app.recentLibraries` and `app.clearRecentLibraries`.

### Edit in PhotoCraft
- Right-click a photo ▸ Edit In ▸ Edit in PhotoCraft (or Photo ▸ Edit In, ⇧⌘E) renders a copy with your edits, stacks it
  with the original and opens it in PhotoCraft. LightCraft finds PhotoCraft where its installer put it (Windows,
  macOS, Linux packages, AppImage, Flatpak), and says so if it isn't installed, before making a copy.
- The copy is a 16-bit PSD by default, which PhotoCraft saves straight back to with File ▸ Save; when you come back to
  LightCraft the copy shows what you saved.
- Settings ▸ General ▸ External Editing: the format (PSD or TIFF), colour space and bit depth for PhotoCraft and for
  the other editor (Edit in Other Editor, now ⌥⌘E), and where PhotoCraft is if you use a portable copy.
- Export can write PSD too (flat, 8- or 16-bit).

### Faster GPU exports
- Exports with noise reduction, Texture, Clarity, Dehaze or Highlights and Shadows can be much faster on the GPU,
  depending on the graphics card. On a Windows laptop with an AMD Radeon 780M, a full-size export of a 24 MP raw
  with those edits went from about 3.7 s to 1.9 s. Photos look the same as before.

### Reliability
- Upgrading from a Windows installer older than 0.6 (such as 0.5.0) keeps LightCraft in the folder it was installed
  in, instead of moving it back to Program Files (issue #399). If that folder has been deleted since, the upgrade
  installs to Program Files.
- A photo that runs into a bug in LightCraft while it renders (in a raw decoder or the editing pipeline) now fails
  like a photo that can't be opened, with the reason, instead of rendering forever; its thumbnail stops waiting too.
  Each such bug used to take one of the render threads with it, so after a few of them no photo rendered until
  LightCraft was restarted. The bug is still written to the log (Help ▸ Open Log Folder) for a report.

### Library sorting
- Photos that tie on the sort key (equal ratings, one import batch, a burst shot within the same second) now sort by
  file name, then id, instead of import order. Recently Added keeps a batch in file name order, and Auto-Stack orders a
  burst by file name, so the first file is the cover.

### More of the rendering on the GPU
- LUT profiles, masks with Refine Edges and soft proofing into a colour space render on the GPU (they used to send the
  whole render to the CPU; soft proofing to a printer or paper profile still renders on the CPU), and so do spot removal, defringe and the histogram (they used to bounce the image through the CPU mid-render).
  Results match the CPU within 3 levels in 8 bits (mean under half a level; `docs/gpu-pipeline.md`).
- Grid, filmstrip, preset and profile thumbnails render on the GPU once it is ready (about a quarter faster on an RTX
  5070, and the CPU stays free for decoding raws).
- While a slider is dragged, the loupe is drawn straight from the GPU: rendering and drawing share the window's
  graphics device, so drafts are never copied to memory and back (`LIGHTCRAFT_GPU_WINDOW=0` turns this off).

### Large preset collections
- A library holding thousands of presets (a Lightroom collection imported whole: 11 000 presets, a 42 MB
  presets.json) stays responsive. Every command used to re-serialize the whole list to see whether it had changed
  (~0.6 s per slider tick); now the list is saved only after it changes, and a slider tick takes ~2 ms.
- The Presets panel builds only the rows in view (and their thumbnails) instead of every preset on every frame; the
  preset pickers in Import and Settings ▸ Import scroll the same way.
- Importing a large collection and opening its library no longer compare every preset with every other.

### Slideshow export: PDF, JPEG and video
- View ▸ Export Slideshow… (or the Export buttons at the end of Settings ▸ Slideshow) writes the slideshow out, like
  Lightroom Classic's Export PDF, Export JPEG and Export Video: the photos in view as their slides, with the layout,
  overlays and the intro and ending screens, in view order.
- **PDF:** one page per slide at 1024, 1920 or 3840 pixels on the long side, at a JPEG quality you choose. Each page
  carries the slide duration and fade, so a PDF viewer's presentation mode plays it as a slideshow, and "Automatically
  show full screen" asks the viewer to open it that way.
- **JPEG:** numbered files (`Holiday-001.jpg`, `Holiday-002.jpg`…) in a new folder.
- **Video:** AV1 video in an MP4 (or WebM) file at 720p or 1080p, 24 or 30 frames per second: each slide stays up for
  its duration and the fades are rendered frame by frame (crossfades, or fades through the fade colour). The video has
  no sound yet. It is AV1 rather than Lightroom's H.264, which has no open encoder we can ship; current browsers,
  VLC and recent phones and TVs play it.
- The export runs in the background with its row in the activity stack; ✕ stops it and leaves no half-written file
  behind. A photo that can't be read is skipped and named in the message at the end. Agents use `slideshow.export`
  (`slideshow.exportStatus` for the result).

### Slideshow templates
- Settings ▸ Slideshow now opens with a template browser, like Lightroom Classic's Template Browser. A template holds
  everything about how a slideshow looks and plays: the playback timing and fades, the layout, options and backdrop,
  the overlays and the intro and ending screens. Click one to apply it; point at one to see it on the selected photo in
  the preview beside it without changing anything.
- Five built-in templates of our own: Plain Black (the photo on black), Gallery Wall (a light wall, a white mat and a
  soft shadow, with the caption and rating under the photo), Edge to Edge (photos cropped to fill the screen), Cinema
  Wide (16:9 with black bars, the title in the corner, fades through black and a closing card) and Shooting Data (the
  exposure, ISO, focal length, camera and lens under each photo on a dark backdrop).
- Save the current settings as a template of your own; right-click it to update it with the current settings, rename,
  export or delete it, and import templates others share with you. Your templates are `.json` files in the settings
  folder's `slideshow-templates` folder, shared by all your libraries.
- Applying a template can't be undone with Edit ▸ Undo (slideshow settings are library preferences), so the settings it
  replaced are listed as "Previous settings" until you quit: click that to go back.
- A template file that can't be used (damaged, from a newer LightCraft, too large) is listed as skipped instead of
  stopping the others, and a template whose identity plate image or background photo isn't there still applies, with a
  note saying what is missing. Agents use `slideshow.templates.*`, and `slideshow.preview {template}` renders a template
  without applying it.

### Slideshow intro and ending screens
- A slideshow can now open with an intro screen and close with an ending screen, like Lightroom Classic's Titles
  panel. Each is switched on on its own and has a background colour and, centred on it, your identity plate (the one
  set under Overlays: its text or image) or a line of text of its own, in the plate's colour or one you pick, at a
  scale. Each stays up for its own duration (by default the slide duration) and fades in and out like a slide.
- The intro plays once before the first photo; the ending after the last photo when Repeat is off (while repeating
  the show runs until you stop it, so the ending doesn't come up). Random order never moves them, ←/→ step across them,
  and the control bar says Intro or End while one is up (the photo count only counts photos).
- Set them in Settings ▸ Slideshow ▸ Titles; the preview there switches between the photo's slide, the intro and the
  ending. They are saved with the library. Agents use `slideshow.titles`, and `slideshow.preview {title: "intro"}`
  renders a screen as a PNG.

### Slideshow overlays
- Slides can now carry Lightroom Classic's Slideshow overlays: an identity plate (a line of text in a colour, or an
  image file such as a PNG logo with transparency, at a size and opacity, optionally drawn behind the photo), the
  photo's rating as stars, and any number of text overlays (up to 16) built from tokens: `{caption}`, `{title}`,
  `{file}`, `{date}`, `{exposure}` ("1/250 s at f/8"), `{iso}`, `{focal}`, `{camera}`, `{lens}`, `{rating}` and the
  other file-naming tokens, with a size, colour, opacity and an optional soft shadow (opacity, offset, radius, angle).
  Each sits at one of nine anchors of the slide or of the photo, moved by an offset, and never leaves the slide.
- The export watermark can be drawn on every slide's photo too ("Use export watermark" takes the one you last
  exported with).
- Set them in Settings ▸ Slideshow ▸ Overlays; the slide preview there and View ▸ Slideshow show them. Sizes are a
  share of the slide, so slides look the same on any screen. They are saved with the library. Agents use
  `slideshow.overlays`; `slideshow.preview` now also returns where each overlay landed.

### Slideshow layout, options and backdrop
- Slides can now be laid out like Lightroom Classic's Slideshow Layout, Options and Backdrop panels: margins (all four
  linked, or each on its own), Zoom to Fill Frame (crop the photo to fill its cell), a stroke border (colour, width),
  a cast shadow (opacity, offset, radius, angle), and a backdrop colour with an optional colour wash (a gradient from a
  second colour, at an angle and opacity) and a background image (a photo from the library, at an opacity).
- Set them in Settings ▸ Slideshow, which now shows the selected photo as a slide as you change them (with the margin
  guides, at the screen's aspect or 16:9 / 4:3). Sizes are a share of the slide, so a slide looks the same on any
  screen. They are saved with the library.
- View ▸ Slideshow plays the composed slides, prepared ahead off the UI thread like before, so fades and the playback
  controls work as they did. With the default layout (no margins, border, shadow or backdrop) it plays the photos as
  before. Agents use `slideshow.layout`, and `slideshow.preview` returns one composed slide as a PNG.

### Slideshow playback
- View ▸ Slideshow (⌥⌘↩) now plays with Lightroom Classic's Playback settings: how long each slide stays up, a fade
  between slides (a crossfade, or through black, white or any colour; 0 cuts), random order (every photo once per
  pass, a new order each time round), repeat (off: the slideshow ends after the last photo) and preparing previews in
  advance (the next two slides render while the current one is up, so a fade never waits or flashes).
- Change them in Settings ▸ Slideshow (View ▸ Slideshow Options…); they are saved with the library. Agents use
  `slideshow.playback`; `view.slideshow` takes any of them for one run (`interval` still sets the slide duration).
- While it plays, moving the pointer shows a small control bar: previous, play / pause, next, the slide number and
  end. Space pauses, ← / → step (a cut), Esc ends. A slide's time starts once it is shown sharp.

## 2026-10-10

### Dialogs fit the window
- A dialog taller than the window no longer runs off it (issue #781): on a 1366×768 screen the Export dialog's title
  and its Cancel / OK buttons were off screen, so it couldn't be confirmed. Now its options scroll and the title and
  buttons stay visible. Long lists in dialogs (What's New, All Metadata, Keyboard Shortcuts) get shorter to fit.
  Dialogs that fit look as before.

### Previews match exports on Mac screens
- On macOS, photos are shown through the profile of the screen the window is on while no monitor profile is chosen in
  Settings ▸ Display (issue #787). On P3 screens previews used to look more saturated than the exported files in
  Preview or Photos. Moving the window to another screen is followed; **Use Screen Profile** goes back to it after
  choosing a profile file.

### Sidebar sections
- Arrange the left sidebar your way: drag Albums, Local, By Date, Folders or Keywords by its header to move it (a line
  shows where it will go), or right-click a header for Move Up / Move Down.
- Hide the sections you don't use: View ▸ Sidebar Sections, or right-click a header ▸ Hide This Section. Right-click
  the My Photos title to bring one back, or choose Reset Sidebar Sections. The arrangement is remembered.
- In a long section, the header stays at the top of the sidebar while you scroll through its rows, so you always see
  which section you are in and can fold it from there.
- Sections are easier to tell apart: a hairline between them, the fold chevron in the same column as the rows'
  triangles, a highlight under the pointer. A folded section shows how many rows it holds, counts of 0 are fainter,
  and a section with nothing in it says so instead of disappearing.
- Recently Deleted is listed with All Photos, Recently Added and Picks under My Photos.
- Keywords has a + in its header, like Albums: Create Keyword Tag without opening the Keyword List.
- Agents: `view.sidebarSection`, `view.sidebarMoveSection`, `view.sidebarReset`; `ui.set` takes `sidebar`.

### Kelvin white balance for raws whose camera has colour matrices
- Raws from the 52 camera models whose colour matrices LightCraft has measured (Sony ILCE-7M3, ILCE-7M4, ILCE-7RM3,
  Nikon D850, Canon EOS 5D Mark III and others) now show white balance in Kelvin, as a DNG does and as Lightroom
  does: As Shot reads the file's white (an ILCE-7M3 sample: 4268 K / +7), the Temp slider runs 2000–50000 K and the
  Daylight, Cloudy, Shade, Tungsten, Fluorescent and Flash presets set real temperatures (issue #730). The matrices
  only convert between the camera's multipliers and Kelvin; the colour look is what it was.
- Nothing already edited changes: a Custom white balance set on the old relative scale renders pixel for pixel as
  before, and becomes the Kelvin value with the same look the next time it is edited. A photo imported earlier shows
  its real As Shot temperature once the file is opened (or Reload reads it).
- Lightroom's `crs:Temperature` for these raws is read as the Kelvin it is (sidecars, Lightroom catalogs, presets);
  raws of other cameras keep the as-shot shift of issue #510. The two Kelvin scales come from different matrices and
  differ by about 7–10 % on the ILCE-7M3; which one is off is still open.

### Fujifilm lens corrections
- Fujifilm RAFs from 59 camera models now get the lens correction the camera stores in the file: distortion (with the
  camera's own zoom to fill the frame) and vignetting, as with Panasonic and Sony files. The Optics profile controls
  adjust or switch them off, and DNG export keeps them. Lateral chromatic aberration data is not applied: our
  demosaic already lines the colour planes up. Details and measurements: `docs/fuji-lens-corrections.md`.

### Appearance
- Settings ▸ Interface ▸ Appearance Mode: Sync with System, Dark Mode or Light Mode, above a light
  and a dark theme card, each previewing its theme (dark: Charcoal, the look so far, or Midnight;
  light: Silver or Paper). New and existing installs stay dark; following the system is opt-in.
- The top bar's appearance button cycles Auto, Light, Dark (a monitor, sun or moon), and View ▸
  Appearance lists the modes and themes. On Linux, Auto follows the desktop portal's colour scheme
  as it changes, without polling.

### Add to Apple Photos (macOS)
- The Export dialog has **Add to Apple Photos**, with an optional album. The files are exported to your folder as
  usual and then added to Photos, into a top-level album of that name (made when it's missing). The toast says how
  many Photos added, or why it added none. Export with Previous and export presets repeat it.
- The first time, macOS asks whether LightCraft may control Photos. Photos may ask about duplicates; files it skips
  show as a partial import.
- Agents: `app.export {addToPhotos, photosAlbum}`, `export.addToPhotos {paths}` for files already on disk, and
  `export.photosImports`. See [Add to Apple Photos](apple-photos.md).

### Activity stack
- Long-running tasks show in one place, top left under the top bar, as in Lightroom Classic (issue #345): imports and
  folder scans, exports (and the contact sheet PDF), Synchronize Folder, Build / Smart Previews, Lightroom catalog import, Photo Merge, model downloads, the face scan,
  AI Denoise and Find Missing Photos. Each row has the task's name, a progress bar, the count and what it is working
  on; ✕ stops the tasks that can stop. Three rows show, then "+N more". The separate export panel and the progress
  windows and toasts are gone.
- Quitting while a task that can be stopped is running asks first ("Quit Anyway" stops it).
- Agents list and stop tasks with `activity.list` and `activity.cancel`; `ui.inspect` reports them as `activity`.

### Importing a deleted photo again
- Importing a file whose photo is in Recently Deleted brings the photo back, with its edits, rating and albums
  (issue #706; before, the import skipped it as "already in the library" while the grid showed it deleted). The
  import review checks such files, marks them "Will be restored" and counts them as "in Recently Deleted"; the
  choice next to that (Restore them / Import as new / Leave them) now starts on Restore. Files dropped on the window
  restore the photo too and say "Restored 1 photo from Recently Deleted". A deleted photo whose file was moved is
  relinked to the file it is imported from. Browsing a folder in Local, Auto Import and a Lightroom catalog import
  never restore anything. Agents: `library.import` → `onDeleted` defaults to `restore` (`skip` keeps the old
  behaviour, `fresh` imports a clean copy and deletes the old record).

### Formats
- File extensions match whatever their letter case: `IMG_0001.JPG` and `DSC_0002.NEF` as Nikon writes them, `.Jpg`
  after a rename, an `.XMP` sidecar. Adding photos or a folder, Browse Folder (Local), drag-and-drop, the CLI and the
  sidecar lookup always did; the Add Photos dialog on Linux did not until 0.5.0 (GTK and the desktop portal match
  `*.jpg` case-sensitively, so `.JPG` and `.NEF` files were hidden — issues #342 and #705).

### Reliability
- Closing a library releases its lock explicitly (issue #680). On Linux and macOS the lock used to go with the file
  handle, and a program being started by another thread at that moment held a copy of the handle until it was fully
  launched, so reopening the library straight away could be refused with "This library is already open in another
  LightCraft program" although nothing had it open. Nothing in the shipped app is known to hit the window today; it
  made a lock test flaky, and the fix closes the window for good.

## 2026-10-09

### HDR PNG export
- With **HDR output** on, a photo edited in HDR can now be exported as a **16-bit PNG** with the PQ curve in Rec. 2020,
  like the HDR AVIF: the same brightness, with SDR white at 203 cd/m², and content light levels recorded.
- The colour is described by the PNG `cICP` chunk, not an ICC profile. HDR-aware viewers (current Chromium-based
  browsers, for example) show it in HDR; **viewers that don't read `cICP` show the PQ values as if they were sRGB**,
  so the picture looks flat and washed out there. That's how PQ PNG works, not a broken file: for a picture that
  looks right everywhere, export a JPEG with HDR output on (an SDR image plus a gain map).

### Smart album rules
- The rule editor's field menu is grouped: Rating, Pick Flag, Color Label and Any Searchable Text at the top, then
  submenus for Source, File, Date, Keywords & People, Description, Camera Info, Location, Size, Develop and Assisted
  Culling.
- New fields: Keyword Count ("2 or more", "exactly 2"…), People and People Count (named faces), Shutter Speed (written
  as 1/250), File Extension, Video Duration, Copy Name, In a Stack, Alt Text, City, State / Province, Country, Long
  Edge, Short Edge, Aspect Ratio (landscape / portrait / square), Cropped and Treatment (in color / black & white).
  Size rules measure the photo as shown: Megapixels now counts the cropped photo, like Long Edge, Short Edge and
  Aspect Ratio (a 24 MP photo cropped to a square is 16 MP).
- Choice values read as words in every language: "Public Domain", "Picked", "Black & White" rather than ids like
  `publicDomain` (rules and agents keep using the ids; `album.ruleFields` adds `choiceLabels`).
- Rule values are checked: a rating of 9, a date like 2026-13 or "banana", a "between" whose dates are the wrong
  way round, "in the last 0 days", a colour label that doesn't exist, "contains" with nothing to look for, an
  album that is gone, or an empty group is reported with its rule ("rule 2.1: no rating 0–5 is 9")
  instead of quietly matching nothing or everything. New date rules start at the current year.
- A smart album can include or exclude another smart album: "Keywords contain travel" and "Album isn't Excluded Photos"
  leaves out whatever Excluded Photos matches, as its rules change. The album picker shows your albums as in the sidebar
  (folders open on click) or finds them as you type part of a name or folder (↑ / ↓ and Enter to pick); albums that
  can't be picked, such as one that would make an album include itself, are greyed with the reason. Esc with a dropdown or calendar open in a dialog
  closes just that.
- Date rules have a calendar button: pick a day, a month or a whole year (Year / Month / Day), in your language; the
  two dates of a "between" can't be picked out of order; Esc closes just the calendar. It picks dates, not times (a
  time is typed, and picking a day replaces one). Typing still works, and "2026-10-01 10:00" (a space for the
  T) now matches.
- Rule problems are shown in your language and name the field the way the menu does ("Title: needs something to look
  for").
- A smart album whose rules no longer check (an album they test was deleted) is marked ⚠ in the sidebar; its tooltip
  says what to fix, and `albums.list` reports `problems`.
- Editing a smart album's name and rules is one step: both or neither, and one undo takes both back
  (`album.setRules` takes `name`).
- The rule editor marks each rule that needs fixing right under it and keeps OK disabled until they are fixed. An
  Album rule is "is" or "isn't" an album, picked with the album picker.
- Yes/no fields (Has Edits, Cropped, Has GPS…) read Yes / No instead of true / false. A rule sent as `"false"` now
  means no (it used to count as yes), and a value that is neither yes nor no is refused.
- Any Searchable Text also finds the state / province, alt text, people and a virtual copy's name.

### Keyword lists
- File ▸ Import Keywords… and Export Keywords… read and write keyword list files as Lightroom Classic does (a keyword
  a line, a tab per level, synonyms in braces, keywords left out of export in brackets). Capture One, darktable, Adobe
  Bridge and Photo Supreme (its Formatted Vocabulary File) use the same files, so keyword lists move between them and
  LightCraft. Importing adds the keywords you don't have, in one undo step; a file it can't read says which line, or
  to save it as UTF-8. Exporting warns about keywords Capture One won't import, and names any keyword the format can't
  hold (such as a name in brackets), which it leaves out so the file always reads back.

### Keyword sets
- Keyword Set ▸ Edit Set… edits a set's nine keywords in place, one field per ⌥ key, and renames it (or saves the edits as a new
  set). An empty field leaves its key empty instead of moving the keywords after it; editing Recent Keywords and naming
  them saves a new set.

### Keywording box
- The chips at the top of the Keywords panel are the keywords of every selected photo, not only the active one's; a
  keyword only some of them have is marked with an asterisk (hover: how many). Only the × removes a keyword, from
  every selected photo; a chip's menu acts on the selection (add to all, remove, show photos, edit) and no longer
  deletes a keyword from the whole library.
- Switch to & Containing to see the keywords with the keywords containing them, or to Will Export to see what
  exported files will carry for the selection.
- The keyword set's buttons and the suggestions follow the selection too; the typing boxes get the Cut / Copy / Paste
  menu, and Return in the painter's box starts painting.

### Keyword List
- The Keywords panel ends with a Keyword List, as in Lightroom Classic: every keyword with its photo count, those no
  photo has yet too. Filter it, tick a keyword to give it to the selected photos (a dash: only some have it), or click
  the arrow to see its photos.
- Create keywords with + (inside the one you picked, with synonyms, and given to the selection if you like), edit one
  by double-clicking it, delete one with − after a confirmation. Right-click for more: create inside, Put New Keywords
  Inside This Keyword, Purge Unused Keywords.
- Drag a keyword onto another to nest it, or onto the list's title to bring it back to the top level; photos dragged
  from the grid onto a keyword get it.
- Right-click ▸ Put New Keywords Inside This Keyword: new keywords, made with + or typed in the box above, go inside
  it. The list is there with no photo selected too, to set up keywords first.
- Keyword tag options decide what exported files carry: Include on Export, Export Containing Keywords, Export
  Synonyms. Exports now write keyword names to `dc:subject` and their paths to `lr:hierarchicalSubject`, and keywords
  imported from files (or read from sidecars) keep the hierarchy `lr:hierarchicalSubject` gives them.

### Text fields
- Right-click Search Photos, a slider's typed value, the Info panel's fields, the name field of New Album, Rename
  Album, New Smart Album, Rename Keyword, Merge Keywords and similar dialogs, or the name field under unnamed faces for
  Cut, Copy, Paste and Select All. Esc in them gives back the text from before you started typing (in the Info panel it
  no longer saves it). Return in those dialogs now confirms them, and their name opens selected. More fields will
  follow.
- On Windows and Linux, Ctrl+C outside a text field copies edit settings and Ctrl+V pastes them (⇧Ctrl+V: Paste
  Selected Settings). Ctrl+V only reaches LightCraft while the system clipboard holds text; otherwise use Edit ▸ Paste Edit
  Settings.

### Dialogs
- System Info, All Metadata and What's New end with one Close button, like About, instead of Cancel and OK
  (issue #782).

### Synchronize Folder
- Right-click a folder (or a disk other than the startup disk) in the sidebar's Folders section ▸ Synchronize
  Folder…. The folder and the folders inside it are scanned in the background for photos added on disk, photos whose
  file is gone, photos whose file was renamed or moved within the folder, and XMP sidecars changed by other apps; then
  choose what to do: import the new photos and relink the moved ones (the defaults), move the missing ones to Recently
  Deleted, read the metadata updates. A folder on a disk that isn't connected is reported as such. Synchronizing
  runs in the background with a row in the activity stack (✕ stops it); everything it does is one undo step, and no file on disk
  is touched. Agents use `folder.scanChanges` and `folder.synchronize`.

### Folder colour labels
- Right-click a folder (or a disk other than the startup disk) in the sidebar's Folders section ▸ Set Color Label ▸ a colour or None. The row
  shows the label's dot before its photo count. Agents use `folder.label` (`path`, `label`); `library.folders`
  reports each row's `label`.
- A label follows its folder when it is renamed or moved in LightCraft, together with the labels of the folders
  inside it; undo and redo carry them back and forth.
- The catalog format is now version 4 (`Catalog.folder_records`, `Op::SetFolderRecord`). Once this version has
  opened a library, older versions refuse it, as with every format change.

### Monitor profiles
- Settings ▸ Display ▸ Choose Profile… shows photos through your monitor's ICC profile (matrix/TRC or LUT-based), so
  colours are right on wide-gamut and calibrated displays instead of oversaturated. The Detail view renders straight
  into the display's own gamut; thumbnails and other previews are converted to it. Histograms, the preview caches
  and exports don't change. Agents use `app.displayProfile`. See [display profiles](display-profiles.md).

### Highlights and Shadows (process 2)
- Highlights and Shadows keep the fine detail of the tones they move (issue #632): pulling Highlights down on a bright
  sky no longer flattens the twigs, lines and texture in it, and lifting Shadows keeps the texture of dark areas, much
  as Exposure would; the edges between bright and dark regions stay as sharp as before. This is rendering process 2:
  new photos (and Reset) get it, photos you already edited keep their look until you choose Photo ▸ Update to Current
  Process. See [process versions](process-versions.md).

### Masking
- Drag anywhere inside the selected radial gradient's ellipse to move it, including rotated
  ellipses and radial components in compound masks. Edge and rotation handles keep their existing
  functions, and one Undo restores the entire drag.

### Crop rotation
- Outside the crop box, where dragging rotates the photo, the pointer is a curved double arrow, and the angle is shown
  next to it while you rotate (issue #534). For an exact angle, type it in the new Angle field under Straighten and press Return
  (Esc keeps the old angle; a decimal comma works too), or click the Straighten value; hovering any slider's value now says it can be typed.

## 2026-10-08

### Albums tree
- Album folders fold with the same disclosure triangle as Local, By Date, Folders and Keywords.
- Right-click a folder ▸ New ▸ Create Album… / Create Smart Album… / Create Smart Album from Filter… / Create Folder…
  makes it inside that folder (`dialog.newAlbum`, `dialog.newFolder`, `dialog.smartAlbum`, `dialog.newSmartAlbum` take `parent`).
- Drag an album or folder onto a folder to move it there (a closed folder opens after 0.6 s under the pointer; a
  "Albums" header takes it back to the top level; Esc cancels; holding a dragged album or photos near the top or bottom edge of the sidebar scrolls it). Drop on the top or bottom half of another album,
  or the edge of another folder, to place it before or after it: that folder is then ordered by hand. Right-click ▸
  Sort Contents A–Z (or + ▸ Sort Albums A–Z at the top level) goes back to by name. To put a folder after an open
  folder, fold that folder first (the bottom of an open folder means "inside"). Agents use `album.reorder`
  (`id`, `parent?`, `before?`) and `album.sort`.
- The catalog format is now version 3 (`Album.order`, `Op::SetAlbumOrder`). Once this version has opened a library,
  older versions refuse it, as with every format change.

### AI RAW denoise
- Detail has a per-photo AI Denoise switch and Amount. Bayer RAW photos use a disposable cache, with matching previews and exports and pure-Rust CPU/GPU inference.
- Optional models are installed separately after accepting their terms; no weights are bundled. See [setup and limitations](denoise.md).

### Library keyboard culling
- Colour labels tint thumbnail surrounds in Square Grid and the Detail filmstrip, and a translucent footer along the bottom of the photo in Photo Grid. Label confirmations use a matching pale colour.
- Setting or clearing a colour label shows a brief bottom confirmation, like rating a photo; custom label names appear in the message too.
- On macOS, ratings `0–5`, labels `6–9` and pick/unflag `P/U` now reach the app even when shown in the native menu (issue #283; adapted from PR #261).
- `Shift+6–9` labels and advances. `Shift+P` picks and advances in Photo Grid and Square Grid; it opens Presets in other views. With Auto Advance on, Shift still moves only once.
- Help → Keyboard Shortcuts includes the number-key bindings. See [library shortcuts](library-shortcuts.md).

### Keyboard shortcuts
- Shortcuts are editable: Help ▸ Keyboard Shortcuts (⌘/) lists every command with a search box; click a shortcut and
  press the new keys (Esc cancels), × removes it, ↺ restores the original, Reset All undoes every change. A key that
  belonged to another command moves to the new one. Menus show the new keys; agents use `app.setShortcut`.
- Return presses OK in Choose Edit Settings to Copy (⇧⌘C) and Paste Selected Settings (⇧⌘V), and Esc cancels them
  (issue #735).

### Formats
- HEIC / HEIF photos (iPhone and Mac) open now: the optional `lightcraft-heif` crate (heic-rs, pure Rust) behind
  codecs' `heif` feature — 8- and 10-bit, alpha, grid tiles, the container's rotation/mirror/crop, ICC, EXIF and XMP.
  Off by default (HEVC patents are the distributor's call, same as PhotoCraft); official builds pass `--features heif`.
- HEIC colours now match libheif to within one code value (they were up to ~10 off): the HEVC stream's own
  full-range/matrix signalling is honoured (iPhone photos are full range), chroma is upsampled like libheif, grids
  take their tiles' ICC profile, and `imir` mirrors the way libheif writes it. Importing a HEIC reads its size from
  the container instead of decoding it; small previews use the file's embedded thumbnail. The release packages
  (macOS, Windows, Linux, FreeBSD, Nix) now really are built with HEIC support; a build without it reports
  "HEIC/HEIF support isn't included in this build" for each `.heic`/`.heif` at import.

### Editing
- The Tint slider works the right way round (issues #188, #321): left adds green, right adds magenta, as its track
  shows and as in Lightroom, and Tint values in Lightroom XMP sidecars now render as they do there. A custom Tint
  saved in an earlier version now shifts the other way; set it again (or re-run Auto / the white-balance picker).
- White balance on DNGs (and other raws with a colour matrix) re-develops the photo for the new white through the
  camera's own colour matrices, as Lightroom does, instead of shifting the colours of the as-shot rendering: a grey
  lit by the chosen white comes out grey and saturated colours move as the camera records them. The eyedropper and
  Auto use the same model. Custom white balances on these photos render slightly differently than before.
- Crop (issue #295): a Lock toggle keeps the aspect ratio on every handle, Custom takes your own ratio (Apply), and
  dragging a handle into the image edge stops there instead of pushing the crop out of shape.

### Library and views
- Trackpads: pinch to zoom around the pointer and scroll with two fingers to pan the photo; panning keeps the photo
  inside the view. A plain mouse wheel over a zoomed photo pans it too.
- A Folders section in the sidebar lists the folders your photos were imported from; choose one to see its photos.
- Select All and multi-selection show every selected photo in the grid and filmstrip, not only the active one
  (issues #187, #298). Importing files that are in Recently Deleted asks whether to leave them there, restore them
  (with their edits) or import them as new; the trash view's Photo menu has Empty Recently Deleted.
- The Import Photos review opens bigger and can be resized; its photo grid fills it (issue #337). Shift-click checks
  or unchecks a range of photos (issue #338).
- When a folder holds several file types, the Import Photos review has a toggle per type (`ARW · 120`, `JPG · 120`):
  import only the raws and leave the JPEGs beside them (issue #344).

### Languages
- The interface is available in Spanish (issue #371), German and Russian (Edit ▸ Language), alongside English,
  Chinese (Simplified and Traditional), Japanese and Brazilian Portuguese.

### Editing
- Type an exact value into any slider (issue #322): click the number next to its name, type (`1.5`, `-20`, `5600`)
  and press Return; Esc keeps the old value.

### Editing
- The eye on the Light, Color and Detail section headers now hides their adjustments, as it already did for Effects,
  Optics, Geometry and Calibration (issue #316).

### Library
- Choosing a date under By Date or a keyword under Keywords shows those photos from All Photos, as their counts
  promise, instead of filtering whatever album or folder was open, which often showed nothing (issue #341).
)
)

## 2026-10-07

### RAW decoding
- Olympus ORF raws get the starting look fitted to the camera's own JPEG too, instead of opening flat and grey (the
  E-1, E-400 and XZ-2 corpus files: all accepted), with white balance relative to the as-shot look as for the other
  formats. On an E-1 photo the starting render moved from ΔE00 11.3 to 8.3 against Lightroom's. Photos already
  imported pick it up when re-rendered.
- Samsung SRW files without compression now open as raws: NX5, NX10, NX11, NX20, NX200, NX210, NX1000, NX1100, EX1
  and WB2000. The compressed ones (NX1, NX30, NX300, NX500, NX2000, NX3000, NX3300, NX mini) still open from their
  camera JPEG. Photos already imported pick the change up on Reload.
- Raws from 52 camera models (22 Canon, 11 Nikon, 11 Sony, 3 Fujifilm and 5 others, plus their other names) whose
  camera JPEG can't be fitted no longer open with the neutral fallback: they start from colour matrices fitted to the
  camera's measured spectral sensitivities, from the Academy Software Foundation's rawtoaces-data. A camera profile
  and the fit to the photo's own JPEG still come first, so photos that had a fitted look keep it. See
  [camera preview colour](camera-preview-colour.md#spectral-camera-matrices-and-the-order-of-precedence).
- Canon CR2 raws no longer open too dark with blocked-up shadows: the black level was measured over border columns
  that light already reaches (left of the image area Canon records), 4 % of the range too high on the EOS 6D. It is
  now measured on the masked columns alone (8 corpus bodies, EOS 40D to 5DS R). On a 6D photo the starting render
  moved from ΔE00 7.6 to 5.2 against Lightroom's.
- Canon CR2 and Pentax PEF raws get the same starting look fitted to the camera's own JPEG as ARW, NEF, RW2, RAF
  and CR3, instead of opening flat and desaturated (issue #310). Photos already imported pick it up when re-rendered.
- JPEG XL compressed DNGs (DNG 1.7) now open: lossless tiles decode sample for sample (checked on synthetic files);
  lossy tiles decode too, keeping the raw values above 1.0 instead of clipping them (checked on one real file). A tile that cannot be decoded makes the file open from its embedded
  preview, with the reason, instead of showing a black tile. A JPEG XL preview stored in the DNG is used like an
  embedded JPEG.
- Apple ProRAW's gain table map (its local tone mapping, `ProfileGainTableMap`) is now read and kept when a photo is
  exported or converted to DNG. It is not applied by default: Lightroom Classic renders ProRAW without it. To see a
  ProRAW the way the iPhone renders it, turn on Profile ▸ Camera local tone mapping (shown for photos that carry the
  map); the option is per photo, so presets and Copy Settings carry it.
- iPhone ProRAW and other DNGs that carry their own segmentation mattes (DNG semantic masks) use them for the Select
  Sky, Subject and Background masks instead of our heuristics, so the sky is selected where the camera found it
  (checked on one CC0 iPhone 12 Pro ProRAW). Photos without mattes are unchanged.
- Panasonic and Leica raws (RW2, RWL) are now corrected for lens distortion the way the camera corrects its own JPEG
  (issue #256): the correction the camera records in the file is applied under Lens Corrections ▸ Enable Profile
  Corrections, on by default for newly imported photos, with the same framing as the camera's JPEG. At 12 mm the
  12–32 mm kit zoom was off by about 5 % of the image width at the corners before. Files shot with the correction off
  are unchanged; photos imported before this change get it when imported again.
- Canon CR3 raws now develop from their sensor data: lossless RAW and C-RAW, checked sample for sample on the EOS
  M50, R100, R8 and RP (on the RP also in 1.6× crop mode). CR3 files the decoder can't read yet still open from their embedded JPEG, as before.
- Canon EOS R7 C-RAW files develop from their sensor data too, instead of opening from their embedded JPEG. For R7
  C-RAWs imported earlier, Photo ▸ Reload from Disk picks up the raw data.
- Canon CRW, Minolta MRW, Sigma X3F, Kodak KDC, Leaf MOS and Epson ERF files that LightCraft can't decode yet
  now import as "preview only" with their embedded JPEG instead of failing. A raw whose data is damaged but whose
  preview is intact does the same.
- Raw files whose raw data sits in a private block of a TIFF (Phase One / Leaf IIQ, Canon EOS-1D / 1Ds and Kodak DCS
  TIFFs) are no longer opened as a thumbnail-sized ordinary image. They are recognised as raws LightCraft can't decode
  yet and import as "preview only", with the reason.
- Sony ILCE-7M4 downsized lossless ARWs now decode subsampled YCbCr tiles into linear RGB,
  preserving RAW editing & full-resolution export instead of using embedded JPEG previews.
- Sony A7R II (and other) raws whose camera JPEG is lens-corrected no longer open grey and too dark (issue #232): the
  starting look is fitted to the camera JPEG away from edges when the misaligned edges spoil the fit on all pixels.

### Lightroom Classic catalogs
- File → Import Lightroom Catalog… opens `.lrcat` directly, with originals referenced in place.
  Ratings, flags, labels, keywords, collections/sets, virtual copies and supported edits migrate;
  existing LightCraft edits are preserved by default. Source settings/history are archived, unsupported
  fields are reported, and the original Lightroom database stays read-only. Rendering is approximate.

## 2026-10-05

### Reliability
- The Windows installer asks where to install LightCraft (Program Files by default; upgrades keep the folder you
  chose) and ends on a page saying it was installed, with a "Launch LightCraft" box. It used to finish without a word,
  so a successful install looked like nothing had happened (issues #18, #399). Silent installs (`/qn`, `/passive`)
  show no dialogs and take `INSTALLFOLDER=...`.
- If the desktop app can't open its window (for example when no graphics device can be used), it now says so in a
  message box that names the log file, instead of quitting without a trace (issue #260).
- On Linux and FreeBSD, file dialogs (Import Photos…, Open Library, Export, presets, keyword lists…) are children of
  the LightCraft window. The xdg-desktop-portal picker used to open as a separate top-level window on Wayland
  ("Failed to associate portal window with parent window" in the portal's log): tiling compositors put it beside the
  app, and with LightCraft fullscreen it was hidden altogether, so Import Photos… looked like a hang until the
  dialog was found and closed.
- On macOS, single-key shortcuts that appear in the menu bar now work: E, C, H, M, ⇧P, I, K, D, ratings 0–5,
  labels 6–9, P / U and the rest did nothing, because macOS only passes ⌘ / ⌃ combinations and function keys
  to the menu bar and the app ignored those keys, assuming the menu bar would handle them. Keys outside the menus
  (Space, G, X, ⌫) and ⌘ shortcuts were not affected.
- `--memory` sessions keep their promise to save nothing (issues #164, #169): UI changes made in one no longer
  land in `ui.json` (where they replaced the saved settings), and the GPU crash sentinel no longer creates the
  settings folder there. The same goes for the temporary session offered when the library can't be opened.
- The desktop app keeps a log file: `logs/lightcraft.log` in its settings folder (Linux `~/.config/lightcraft/logs/`),
  with the logs of the two previous runs beside it, so warnings and crashes of a run started from a desktop menu or the
  Dock can be attached to a bug report. `LIGHTCRAFT_LOG` works as before; `RUST_LOG` takes env_logger-style
  directives. See README → Quick start → Logs.
- Help → Open Log Folder shows that log file in the file manager (Finder, Explorer, or the folder on Linux), so it
  can be attached to a report without hunting for the settings folder (issue #260).
- `lightcraft-cli` logs warnings on stderr too (issue #168); `LIGHTCRAFT_LOG` or `RUST_LOG` picks another level.
- LightCraft no longer crashes at launch on Windows PCs whose Vulkan driver is broken (issue #136, e.g. some Intel UHD
  630 drivers): on Windows the window and GPU rendering use DirectX 12 only and never load the Vulkan driver unless
  asked to. `LIGHTCRAFT_GPU_BACKEND=dx12 | vulkan | metal | off` (or wgpu's `WGPU_BACKEND`, which GPU rendering
  ignored before) chooses the graphics backend; `off` renders on the CPU. The GPU now starts after the window
  is up, and only when Settings ▸ Performance ▸ Use the GPU for rendering is on; if LightCraft ever dies while
  starting the GPU, the next launch starts with GPU rendering off and says how to turn it back on.
- The Windows app no longer quits at launch with "Parent device is lost" when another program's `dxcompiler.dll` is
  on the DLL search path without its `dxil.dll` (issue #471): DirectX 12 shaders now always compile with the
  compiler built into Windows (FXC). `WGPU_DX12_COMPILER=dxc` uses a `dxcompiler.dll` instead.
- Exports and renders never write over a photo's original (issue #93): exporting into the photo's own folder with
  the same name and "Overwrite" (or Export with Previous repeating it), an exact output path from the control
  channel or MCP, a merge preview path or `lightcraft-cli render IMG.jpg -o IMG.jpg` is refused with a clear
  message, and the original is left byte for byte. Ordinary earlier exports are still overwritten when asked.
  Exported files are written to a temp file and then renamed into place, so a full disk or an unplugged drive
  never leaves a truncated file; the XMP sidecar of an "Original" export follows the "If file exists" choice too.
- Convert to DNG, Copy as DNG, Photo Merge and smart previews no longer write straight to the final file (issue
  #106): a DNG is checked against the raw data, written to a temp file, synced and read back before it gets its
  name (never replacing a file), and only then is the photo relinked or the raw copy removed — a failed write
  leaves no DNG and keeps the raw. Smart previews are written the same way; a damaged one (cut short by a crash or
  a full drive) no longer counts as built and Build Smart Previews replaces it.
- Import ▸ Copy verifies every copy, like Move (issue #96): each file is written as a new file, synced to disk and
  checked against the content read from the card. A copy that fails or differs is removed and reported as a failed
  import — so "import complete" means the copies are good before you format the card — and a name that is taken
  gets -1, -2… instead of being replaced.
- Faster exports and card imports, with the same protection for what can't be recreated (issue #134): exports,
  renders and screenshots are still written to a temp file and renamed into place, but no longer forced to disk
  one by one — they can always be exported again, and on a USB drive or a NAS that per-file sync dominated a large
  export. The catalog, XMP sidecars, settings, DNGs, merges, smart previews and the copies an import makes are still
  synced. Import ▸ Copy now checks each copy against the content hash taken while scanning the card instead of
  reading the card a third time (Move still compares byte for byte before it deletes a source); a file that changed
  on the card after Review Import is reported instead of being imported with stale details. Checking an export path
  against the library's originals no longer scans the whole library when nothing is at that path.
- Saving metadata to an XMP sidecar another application wrote no longer replaces it (issue #92): LightCraft merges its
  fields in and keeps the rest — e.g. that application's develop settings and edit history — byte for byte. A
  sidecar that isn't valid XMP is copied to `<name>.xmp.bak-<time>` first. With the default stem naming, a raw and a
  JPEG with the same name (`IMG_0001.CR3` + `IMG_0001.JPG`) no longer share one sidecar: the raw keeps `IMG_0001.xmp`,
  the JPEG uses `IMG_0001.JPG.xmp`.
- A save that fails part-way (a full disk, a network share that drops) no longer looks like a damaged catalog
  afterwards (issue #101): the partial write is cut off before LightCraft retries, so the next launch replays every
  change. Catalogs already holding such a fragment load in full. Quitting while the catalog log can't be written
  still saves your queued changes in the closing snapshot.
- The catalog has a format version (issue #102). Opening a library from an older LightCraft upgrades it; a library
  written by a newer LightCraft is refused with "this library was written by a newer version of LightCraft" and left
  untouched — older versions no longer read part of it as a damaged log. Once this version has opened a library,
  LightCraft 0.2.0 and older refuse it ("unsupported format … v2").
- The control port (`--control`) closes a connection as soon as it receives anything that isn't a JSON request
  (issue #94): an HTTP request from a web page can no longer carry a command in its body. Lines are capped at
  4 MiB and connections at 16.
- A sleeping NAS, a dropped network share or a USB drive spinning up no longer freezes the window (issue #104):
  whether originals are there is checked on a worker thread (grid thumbnails, the Info panel, the photo menu, Missing
  Photos); importing (also by drag and drop), Find Missing Photos, Build / Discard Smart Previews, the Rename preview,
  the Local folder tree and Auto Import read the disk on worker threads too. The import progress window has Cancel.
- Browser version (experimental), keeping a library safe (issue #107): File ▸ Back Up Library… downloads the catalog
  and every imported photo as one zip, and File ▸ Restore Library from Backup… brings it back (the current library
  is kept). A failed save (storage full) now shows the unsaved warning and is retried, a photo that can't be stored
  isn't added, a second tab shows a message instead of overwriting the first, `?reset` asks first, and the page says
  when the browser may evict the library. Hosting: the sample cache headers no longer mark the (unhashed) files
  immutable, and HOSTING.md describes the actual build.
- Canon CR2 photos from the EOS 7D, 50D, 60D, 550D, 600D, 1200D, 1300D, 5D Mark II and 1D Mark IV (and other
  models whose sensor starts on a green-blue row) no longer come out magenta (issue #85): the colour-filter
  layout is read from each file instead of assumed.
- Exports are never black because of the GPU (issue #78): a GPU render that runs out of device
  memory, exceeds the GPU's buffer limits, hits a driver error or reset, or comes back
  incomplete is redone on the CPU — the file is the same image either way. Work is sent to the GPU
  in short pieces so slow integrated GPUs aren't reset by their watchdog. `ui.inspect` → `perf`
  (`gpuReason`, `gpuFallback`), Help ▸ System Info and Settings ▸ Performance say why the GPU isn't
  used (e.g. a skipped software adapter such as llvmpipe) and why the last render fell back.
- The thumbnail cache only ever counts and deletes its own files (issue #98): a library opened on a folder that
  already has a `thumbs/` folder of other pictures no longer loses them when the cache is trimmed or cleared.
- Settings files are never quietly reset (issue #103): a damaged `prefs.json`, `presets.json` or `view.json` is kept
  as `<name>.corrupt-<time>` and you're told; one that can't be read (e.g. locked by another program) is left alone
  for the session instead of being overwritten with defaults. The app settings (`ui.json`, which remembers your
  library) are written atomically and saved as soon as you open another library, not only at quit. Quitting while
  changes couldn't be saved tries once more, then asks: Try Saving Again, Quit Anyway or Cancel.

## 2026-10-02

### Presets and profiles
- Import presets from other editors: XMP presets, classic `.lrtemplate` files, "DNG presets" from mobile apps and `.zip`
  bundles of any of these — whole folders at once, grouped by pack. Masks inside presets come along.
- Luminar looks: `.lmp` files and `.mplumpack` collections import as presets (grouped by collection); the sliders
  with a counterpart here come along, the rest is listed.
- 23 new built-in presets: Portrait, Landscape, Urban, Food, Seasons, Vintage and B&W toners.
- Importing XMP presets no longer lists bookkeeping fields (`Cluster`, `SortName`, `SupportsAmount2`, the as-shot
  white, empty Point Color slots…) as settings that couldn't be carried over.
- A preset whose lens-profile switch is off no longer turns off the lens corrections built into a DNG (iPhone ProRAW
  and other files with embedded distortion / vignetting corrections), matching what the preset does elsewhere.
- XMP presets apply their red / green / blue curves only when they also have the master curve and all three channel
  curves, as Lightroom does: a preset with just one channel curve (or no master curve) leaves the channels alone.
- Imported `.cube` LUT profiles appear in the Profile menu and the profile browser, grouped by their folder, and stay
  favourites across restarts (issue #328).

### Library
- Photos in Recently Deleted can be restored from the app: right-click ▸ Restore (or Delete Permanently), also in the
  Photo menu. The filmstrip has the photo context menu too. Adding a file again that is in Recently Deleted no
  longer just says "duplicate skipped": it opens the side panel on Recently Deleted with the photo selected and says
  how to restore it or delete it permanently and import it afresh. (For a fresh start on a photo, Reset Edits,
  Cmd+Shift+R, keeps the photo and clears its edits.)
- Canon CR3 files show their full-size embedded JPEG (e.g. 6960 × 4640 on an EOS R6 Mark III) instead of the
  1620 × 1080 preview, and import with their metadata: capture time, camera, lens, exposure, GPS and XMP. Their raw
  data is not decoded yet, so they stay preview-only. For CR3s imported earlier, Photo ▸ Reload from Disk (now in
  the Photo menu and the photo context menu) picks up the full-size preview and fills in the camera metadata they
  were missing, without touching anything already set.
- Rename Photos never overwrites another photo when only the letter case changes (issue #95): on case-sensitive
  volumes (Linux, case-sensitive APFS) `img_1.JPG` next to `IMG_1.JPG` is a different photo and the renamed one gets
  `img_1-1.JPG`; on case-insensitive volumes the case change still goes through.
- Rename Photos reports files it could not move back after a failure (issue #105), e.g. when a network share drops
  mid-batch: the error lists them (old → new) and the library points at their new names (an undoable partial rename),
  so none shows as missing. Renaming one of a raw + JPEG pair copies their shared `IMG_0001.xmp` instead of taking
  it away from the other (issue #92). Find Missing Photos also finds renamed files by their content, prefers a content match
  over a same-name same-size look-alike, and skips (and reports) photos it can't tell apart instead of guessing.
- Rename Folder… and Move Folder To… (Local) can be undone and redone (issue #97): the folder moves back on disk with
  its photos and XMP sidecars, and the photos point at it again. If something now occupies the old place, the undo
  is refused and nothing is overwritten.
- Smart albums with a rule editor: match all / any / none, nested groups, 26 fields.
- Quick Collection and target album (B in the grid), keyword sets (⌥1–⌥9), colour-label sets.
- Colour-label filter with several labels at once; expandable folder tree in Local.
- Import: copy to any folder, by day / by month / one folder, rename on import, metadata preset, Copy as DNG.
- Import ▸ Move: photos go into the destination (with the same folders and renaming as Copy, e.g.
  `Photos/2026/20260114/20260114_001.jpg`) together with their XMP sidecars; each original leaves the card only after its
  copy is verified and in the library. Duplicates and files that fail stay where they were.
- Watched-folder auto import; Convert to DNG; Duplicate; Build Standard / 1:1 / Smart Previews.
- Export file names use the Rename Photos tokens ({title}, {seq:2}, {date:%Y-%m-%d}…), plus new {num}, {folder}, {lens}, {iso}, {rating}, {creator}.
- Copyright status, rights usage terms and copyright info URL in Info, metadata presets and exports.
- Auto-Tag from Tracklog: GPS locations for your photos from a GPX track log, matched by capture time.
- A change that can't be saved to disk (full or unplugged drive) is no longer silent: the command reports
  "saved in memory but not written to disk", the top bar shows a warning, and LightCraft keeps retrying until the
  save goes through.
- Smaller, faster catalogs: photos you only looked at in Local (never added, rated or edited) are forgotten once
  their folder has not been browsed for 30 days — your files and sidecars stay, and browsing the folder shows them
  again. Change the period (or turn it off) in Settings → Performance.
- A library is open in one program at a time (issue #99): opening a library that LightCraft or `lightcraft-cli` already
  has open — on this computer or another one sharing the folder — says who has it ("already open in LightCraft (process
  123 on studio-mac)") instead of letting both write and silently drop each other's edits. A crash never leaves the
  library locked: the lock is the operating system's and goes away with the program.
- If your library can't be opened at launch (open in another program, unreadable, on a drive that isn't connected,
  written by a newer LightCraft), LightCraft says so and why, and offers Try Again, Choose Another Library…, Continue
  Without Saving and Quit (issue #100). It no longer quietly starts a demo session that looked like a reset library and
  lost everything at quit; a temporary session shows a banner the whole time and never writes to your library.

### Editing
- Optional remote SAM 3: keep the native editor local and run Object, Describe, and detail
  inference on a Mac through SSH. Saved masks still render and export offline.
  See [remote Metal inference](ai-masks.md#remote-metal-inference).
- AI masks with SAM 3 (Object and Describe in the Masking panel): click an object to select it (⌥-click leaves a
  part out), or type what to select ("sky", "the red car", "car, road"); both combine with other masks, have an
  Edge setting, and get a sharper zoomed-in pass in the background. The model runs inside LightCraft in pure Rust
  and never freezes the window. It is optional and not part of LightCraft (Meta's SAM License, about 3.4 GB): the
  first time you use an AI mask, LightCraft asks before downloading it, shows the progress, can cancel and resume,
  and checks the file before using it. Masks keep their selection, so they render and export without the model.
- Auto Sync: edits apply to every selected photo. Auto B&W mix. Automatic versions.
- Colour-range masks: click the photo to sample. Luminance ranges: range bar, smoothness, luminance map.
- ⌘-drag to straighten, ⇧G Guided Upright, a grid while transforming.
- Nikon NEFs start from a colour and tone look fitted to the camera's own JPEG, as Sony ARWs do, instead of a muted,
  greenish neutral rendering (issue #150); white balance is adjusted relative to the as-shot look. 12-bit NEFs
  (e.g. D750, D780, D850, D7500, Z 50) no longer render nearly black or with crushed shadows: their black level was
  read in the wrong units.

### Viewing and sharing
- Slideshow, second window, All Metadata, System Info.
- Edit in External Editor (⇧⌘E): a 16-bit TIFF copy, stacked, refreshed when you come back.
- Lossy DNG files and Smart Previews open as raw photos.
- Compressed Nikon NEFs (lossless and lossy compressed, 12- and 14-bit — e.g. D3200, D5100, D7000, D750, D850, Z 50)
  now develop from the raw data instead of the camera's embedded JPEG, so a B&W or other picture style set in the
  camera no longer gets baked in. Photos already imported as "preview only" switch over on Reload. (Files that
  Nikon splits into two differently compressed halves still use the preview for now.)
- Panasonic and Leica raws (RW2, RWL and the older RAW files, DMC-LX1 to DC-S1R II) develop from the raw data in
  every format the cameras write. Most bodies opened as preview only before: GH1–GH5, the G, GX, GF, GM, FZ, LX and
  TZ/ZS series, Leica D-Lux, V-Lux and C-Lux, and the GH6, GH7, G9 II, S5 II and S9 generation. They start from a
  colour and tone look fitted to the camera's own JPEG, as Nikon and Sony raws do, framed in the aspect ratio set in
  the camera; mapped-out sensor defects are filled in. `.rwl` and `.raw` files are imported too. Photos already
  imported as "preview only" switch over on Reload.
- Sony ARWs from before about 2017 (RX100, RX100 II–V, RX10, NEX, SLT, ILCE-6000, A7 / A7 II / A7R II and their
  siblings) no longer open bright green (issue #148): their as-shot white balance and black level are read from the
  file (Sony stores them only in scrambled maker-note data on these bodies), the few columns of padding at the right
  edge are cropped away, and "12-bit uncompressed" files are no longer clipped. The RX100 series renders much closer
  to the camera's own JPEG.