Skip to content

LightCraft: An open-source non-destructive photo editor written by scratch in pure Rust

docs: re-verify against 0.7.1

Fabio Lussie665aff1b312
diff --git a/docs/user/CLAUDE.md b/docs/user/CLAUDE.md
deleted file mode 120000
index 47dc3e3d8..000000000
--- a/docs/user/CLAUDE.md
+++ /dev/null
@@ -1 +0,0 @@
-AGENTS.md
\ No newline at end of file
diff --git a/docs/user/CLAUDE.md b/docs/user/CLAUDE.md
new file mode 100644
index 000000000..e7bcfb70e
--- /dev/null
+++ b/docs/user/CLAUDE.md
@@ -0,0 +1 @@
+Read `AGENTS.md` in this folder: it has the rules for the user docs.
diff --git a/docs/user/faq/free-and-private.md b/docs/user/faq/free-and-private.md
index 28f7104d2..7eb64052e 100644
--- a/docs/user/faq/free-and-private.md
+++ b/docs/user/faq/free-and-private.md
@@ -2,7 +2,7 @@
title: Is LightCraft free, and does it need an account?
description: LightCraft is free and open source, needs no account or subscription, and keeps your library on your computer.
order: 10
-verified: 0.6.0
+verified: 0.7.1
---
Yes, it is free. LightCraft is open source under the MIT or Apache-2.0 licence, your choice. It needs no account, no cloud service and no subscription, and it sends no telemetry.
diff --git a/docs/user/faq/supported-files.md b/docs/user/faq/supported-files.md
index 65da107ff..143276f13 100644
--- a/docs/user/faq/supported-files.md
+++ b/docs/user/faq/supported-files.md
@@ -2,14 +2,14 @@
title: Which cameras and file types does LightCraft open?
description: The raw and image formats LightCraft reads, what happens with raws it cannot decode yet, and how to open Lightroom catalogs.
order: 20
-verified: 0.6.0
+verified: 0.7.1
---
LightCraft reads raw files from DNG, Canon CR2 and CR3, Sony ARW, Nikon NEF, Fujifilm RAF (including X-Trans), Panasonic RW2, Leica RWL, Pentax PEF and Olympus ORF cameras. It also opens JPEG, PNG, TIFF, WebP, PSD composites and JPEG XL.
## What if my camera is not decoded yet?
-A raw that LightCraft cannot decode opens from the camera's embedded JPEG instead, marked **Preview only**. Compressed Olympus raws and some Canon CR3 variants work this way. See [A raw photo opens as "Preview only"](../troubleshooting/preview-only-raw.md).
+A raw that LightCraft cannot decode opens from the camera's embedded JPEG instead, marked **Preview only**. Compressed Olympus raws, some Canon CR3 variants and Nikon High Efficiency NEF files work this way. See [A raw photo opens as "Preview only"](../troubleshooting/preview-only-raw.md).
How closely the starting look matches your camera's own JPEG varies by model. See [Raw photos look dull or washed out](../troubleshooting/raw-photos-look-dull.md). The project's [raw support table](https://github.com/storytold/lightcraft/blob/main/docs/raw-parity.md) lists what is known per camera.
diff --git a/docs/user/getting-started/install.md b/docs/user/getting-started/install.md
index 689d2c876..8327222cb 100644
--- a/docs/user/getting-started/install.md
+++ b/docs/user/getting-started/install.md
@@ -2,10 +2,10 @@
title: Install LightCraft
description: Download LightCraft for Windows 11, macOS or Linux, install it, and open your photo library.
order: 10
-verified: 0.6.0
+verified: 0.7.1
---
-Download the file for your system from the [latest release](https://github.com/storytold/lightcraft/releases/latest) and install it. In the file names, `<version>` stands for the version number, for example `0.6.0`. The [LightCraft page on getartcraft.com](https://getartcraft.com/apps/lightcraft) also links the download.
+Download the file for your system from the [latest release](https://github.com/storytold/lightcraft/releases/latest) and install it. In the file names, `<version>` stands for the version number, for example `0.7.1`. The [LightCraft page on getartcraft.com](https://getartcraft.com/apps/lightcraft) also links the download.
## Windows 11
@@ -14,9 +14,11 @@ Download the file for your system from the [latest release](https://github.com/s
3. Run the file. The installer asks where to install. The default is `C:\Program Files\LightCraft`, and upgrades stay in the folder you chose.
4. At the end, choose the option to start LightCraft.
-For a Snapdragon or other Arm PC, download `lightcraft-<version>-windows-arm64.msi` instead.
+For a Snapdragon or other Arm PC, download `lightcraft-<version>-windows-arm64.msi` instead. For a 32-bit Windows, download `lightcraft-<version>-windows-x86.msi`.
-To run it without installing, download `lightcraft-<version>-windows-x64-portable.zip`. A portable build for `arm64` is on the release page too.
+Upgrading from an installer older than 0.6.0 also keeps LightCraft in the folder it was installed in. If that folder was deleted, the upgrade installs to `C:\Program Files\LightCraft`.
+
+To run it without installing, download `lightcraft-<version>-windows-x64-portable.zip`. Portable builds for `arm64` and `x86` are on the release page too.
## macOS
diff --git a/docs/user/guides/cull-photos.md b/docs/user/guides/cull-photos.md
index 30d0b4759..ae76982e9 100644
--- a/docs/user/guides/cull-photos.md
+++ b/docs/user/guides/cull-photos.md
@@ -2,7 +2,7 @@
title: Rate, flag and label photos
description: Sort a shoot with star ratings, pick and reject flags and colour labels, from the keyboard or the Photo menu.
order: 20
-verified: 0.6.0
+verified: 0.7.1
---
Select photos in **Photo Grid** or **Square Grid**, then press a key: `1` to `5` for stars, `P` to pick, `X` to reject, `6` to `9` for a colour label. The same actions are in the **Photo** menu.
diff --git a/docs/user/guides/edit-a-photo.md b/docs/user/guides/edit-a-photo.md
index 57c67138c..126324159 100644
--- a/docs/user/guides/edit-a-photo.md
+++ b/docs/user/guides/edit-a-photo.md
@@ -2,7 +2,7 @@
title: Edit a photo
description: Open a photo in the Edit panel, adjust Light, Color and Effects sliders, compare with the original, and undo or reset.
order: 30
-verified: 0.6.0
+verified: 0.7.1
---
Double-click a photo in the grid, then press `E` to open the **Edit** panel. Drag a slider to change the photo. Your original file is never changed, because edits are stored in the library.
@@ -21,6 +21,10 @@ Double-click a photo in the grid, then press `E` to open the **Edit** panel. Dra
Click **B&W** at the top of the **Edit** panel to turn the photo monochrome. Click it again to return to colour.
+## HDR
+
+Click **HDR**, next to **B&W**, to edit the photo in HDR, with highlights brighter than SDR white for HDR exports. LightCraft cannot show HDR on an HDR screen yet, so you edit without seeing the extra brightness.
+
## Other edit tools
Open them from the **Window** menu, or press the key shown next to each one:
diff --git a/docs/user/guides/export-photos.md b/docs/user/guides/export-photos.md
index 784deb7ba..71bca3241 100644
--- a/docs/user/guides/export-photos.md
+++ b/docs/user/guides/export-photos.md
@@ -2,7 +2,7 @@
title: Export photos
description: Save edited photos as JPEG, PNG, TIFF and other files with the size, folder and file names you choose.
order: 40
-verified: 0.6.0
+verified: 0.7.1
---
Select the photos, then choose **File** > **Export…**. Pick a format, a size and a folder, then click **OK**. Your originals are not changed.
@@ -12,14 +12,15 @@ Select the photos, then choose **File** > **Export…**. Pick a format, a size a
1. Select one or more photos in the grid.
2. Choose **File** > **Export…**. The **Export** window shows how many photos it will export.
3. Set **Format**: **JPEG**, **PNG**, **TIFF**, **PSD**, **WebP**, **AVIF**, **JPEG XL**, **DNG** or **Original files**. **DNG** writes raw photos as DNG with the edits embedded. **Original files** copies the files unchanged, each with an XMP sidecar that holds its edits.
-4. For **JPEG**, **AVIF** or lossy **JPEG XL**, set **Quality**. For **JPEG XL**, tick **Lossless** to keep every pixel exactly, at the cost of larger files.
+4. For **JPEG**, **AVIF** or lossy **JPEG XL**, set **Quality**. For **JPEG XL**, tick **Lossless** to keep every pixel exactly, at the cost of larger files. **Effort** trades time for file size, and **Progressive** makes the file show a coarse version first while it loads.
5. Under the size options, tick **Full size**, or clear it and choose **Resize to** one of **Long Edge**, **Short Edge**, **Width**, **Height**, **Width × Height**, **Megapixels** or **Percentage**, then enter the value.
-6. Set **Color space** (**sRGB**, **P3**, **Adobe RGB**, **ProPhoto** or **Rec.2020**) if you need something other than the default.
+6. Set **Color space** (**sRGB**, **P3**, **Adobe RGB**, **ProPhoto** or **Rec.2020**) if you need something other than the default. Lossy **JPEG XL** writes **Adobe RGB** and **ProPhoto** as **Rec.2020**. Tick **Lossless** to keep them.
7. Optional: set **Sharpen** for **Screen**, **Matte** or **Glossy** output, set **Metadata** to **All**, **No camera**, **Copyright** or **None**, and tick **Remove location info** or **Watermark**.
8. Next to **Folder**, click **Choose…** and pick where the files go. **Subfolder** adds a folder inside it.
9. Set **File name** to a template such as `{name}-{seq}`. Click **Tags** to see the tags you can insert.
10. Set **If file exists** to **Add number**, **Overwrite** or **Skip**.
-11. Click **OK**.
+11. On macOS, tick **Add to Apple Photos** to add the exported files to Photos as well. Type an **Album** name to put them in that album. The first time, macOS asks whether LightCraft may control Photos.
+12. Click **OK**. The export shows its progress in the activity stack at the top left.
If you did not choose a folder, the window stays open and shows an error, so your choices are not lost.
diff --git a/docs/user/guides/import-lightroom-catalog.md b/docs/user/guides/import-lightroom-catalog.md
index e06705d9b..df26df566 100644
--- a/docs/user/guides/import-lightroom-catalog.md
+++ b/docs/user/guides/import-lightroom-catalog.md
@@ -2,7 +2,7 @@
title: Move over from Lightroom
description: Import a Lightroom Classic catalog into LightCraft, and learn what comes across and what does not.
order: 50
-verified: 0.6.0
+verified: 0.7.1
---
Choose **File** > **Import Lightroom Catalog…** and pick your `.lrcat` file. LightCraft reads it directly. You do not need Lightroom installed.
@@ -12,7 +12,7 @@ Choose **File** > **Import Lightroom Catalog…** and pick your `.lrcat` file. L
1. Open the library you want the photos in. To start a new one, use **File** > **New Library…**.
2. Choose **File** > **Import Lightroom Catalog…**.
3. Pick your Lightroom Classic catalog, the file that ends in `.lrcat`. You can also give **File** > **Open Library…** a Lightroom catalog folder. LightCraft then offers this import instead of making a library there.
-4. Wait for the import to finish. It shows progress and runs in the background. A message reports how many photos were added.
+4. Wait for the import to finish. It runs in the background, with a progress row in the activity stack at the top left. A message reports how many photos were added.
If you change your mind, one **Edit** > **Undo** reverses the changes to the catalog.
@@ -36,5 +36,6 @@ Original files stay where they are, and LightCraft refers to them in place. Phot
- Before it changes anything, LightCraft tries to save your source settings, history and collections in a recovery archive in the library's `Interop` folder. This is best effort. If it fails, the photos are still imported with a warning.
- Importing the same catalog again does not duplicate virtual copies or collections. By default, edits you already made in LightCraft are kept.
-- A big catalog can take a long time. In one report, 38,000 photos took about 25 minutes from a USB SSD, and **Cancel** waited for the current work to finish.
+- A big catalog can take a long time. In one report on an earlier version, 38,000 photos took about 25 minutes from a USB SSD.
+- To stop the import, click ✕ on its row in the activity stack. This works while LightCraft reads the catalog. Once it starts adding the photos, it finishes.
- The browser version cannot import a catalog.
diff --git a/docs/user/guides/import-photos.md b/docs/user/guides/import-photos.md
index 13e1b5eec..8130272ae 100644
--- a/docs/user/guides/import-photos.md
+++ b/docs/user/guides/import-photos.md
@@ -2,7 +2,7 @@
title: Import photos
description: Bring photos from a folder or card into your LightCraft library, in place or as copies.
order: 10
-verified: 0.6.0
+verified: 0.7.1
---
Use **File** > **Import Photos…** to pick files, or **File** > **Import from Folder…** to scan a whole folder. Both open the **Import Photos** window, where you choose what to bring in and how.
@@ -11,7 +11,7 @@ Use **File** > **Import Photos…** to pick files, or **File** > **Import from F
1. Open the **File** menu and choose **Import Photos…** or **Import from Folder…**, then pick the files or the folder.
2. Look at the thumbnails. Every photo that can be imported has a checkbox. Click a photo to check or uncheck it. Shift-click sets a range. **Check All** and **Uncheck All** change every photo at once.
-3. Photos already in your library are marked **Duplicate** or **In library** and start unchecked. A file LightCraft cannot read is marked **Unreadable**.
+3. Photos already in your library are marked **Duplicate** or **In library** and start unchecked. A file LightCraft cannot read is marked **Unreadable**. A photo you deleted that is still in **Recently Deleted** is marked **Will be restored**. **In Recently Deleted** sets what happens to those: **Restore them** (the default) brings the photos back with their edits, ratings and albums, **Import as new** deletes the old record first, and **Leave them** skips them.
4. Under **Transfer**, choose how the files get into the library:
- **Add in place** keeps the files where they are. The library only points to them. Nothing is copied or moved.
- **Copy** copies the files into the library's `Originals` folder, or into a folder you pick with **Choose…** next to **Copy to**.
@@ -20,7 +20,7 @@ Use **File** > **Import Photos…** to pick files, or **File** > **Import from F
6. Optional: set **Album** to add the photos to an existing album or a new one, **Preset** to apply a preset to every photo, and **Keywords** (separated by commas).
7. Click the button at the bottom. It shows the number of checked photos, for example **Import 24 Photos**. With **Move** it reads **Move 24 Photos**.
-The import runs in the background, and you can keep working while it does. The whole import is one undo step.
+The import runs in the background, with a progress row in the activity stack at the top left, and you can keep working while it does. The whole import is one undo step.
## Good to know
diff --git a/docs/user/index.md b/docs/user/index.md
index 08e631e72..a0655a0d3 100644
--- a/docs/user/index.md
+++ b/docs/user/index.md
@@ -1,7 +1,7 @@
---
title: LightCraft
description: LightCraft is a free, open-source photo library and raw developer, an alternative to Adobe Lightroom.
-verified: 0.6.0
+verified: 0.7.1
---
LightCraft is a photo library and raw developer that runs on your own computer. It is an open-source alternative to Adobe Lightroom, written in Rust, and part of the Craft App Suite from the ArtCraft team.
diff --git a/docs/user/troubleshooting/get-help.md b/docs/user/troubleshooting/get-help.md
index 0eea58be9..963c58221 100644
--- a/docs/user/troubleshooting/get-help.md
+++ b/docs/user/troubleshooting/get-help.md
@@ -2,7 +2,7 @@
title: Get help with a problem
description: What to include when you ask for help with a LightCraft bug, and where to post it.
order: 30
-verified: 0.6.0
+verified: 0.7.1
---
Open an issue in the [issue tracker](https://github.com/storytold/lightcraft/issues), or ask in [Discord](https://discord.gg/artcraft). Include your version, your system, what you did, and what you expected.
diff --git a/docs/user/troubleshooting/preview-only-raw.md b/docs/user/troubleshooting/preview-only-raw.md
index af7720a37..b3eb4dab0 100644
--- a/docs/user/troubleshooting/preview-only-raw.md
+++ b/docs/user/troubleshooting/preview-only-raw.md
@@ -2,7 +2,7 @@
title: A raw photo opens as "Preview only"
description: Why LightCraft shows a raw photo as Preview only, and how to make it decode after an update with Reload from Disk.
order: 10
-verified: 0.6.0
+verified: 0.7.1
---
Select the photo and choose **Photo** > **Reload from Disk**. If your version can decode that raw now, LightCraft reads the sensor data again and the **Preview only** notice goes away.
@@ -22,7 +22,9 @@ If **Preview only** stays, your version still cannot decode that raw variant. Up
## Why this happens
-When LightCraft cannot decode a raw on import, it remembers that and shows the camera's embedded JPEG. It does not check again after an update on its own. **Reload from Disk** is the way to make it check, and importing the photos again works too. Compressed Olympus raws and some Canon CR3 variants are examples of files that use the embedded preview.
+When LightCraft cannot decode a raw on import, it remembers that and shows the camera's embedded JPEG. It does not check again after an update on its own. **Reload from Disk** is the way to make it check. Compressed Olympus raws, some Canon CR3 variants and Nikon High Efficiency NEF files are examples of files that use the embedded preview.
+
+0.7.1 decodes Canon EOS R5 Mark II C-RAW files that earlier versions opened as **Preview only**. Photos imported before switch over after **Reload from Disk**.
Photos shown from the preview keep the camera's picture style and white balance, because they are the camera's own JPEG.
diff --git a/docs/user/troubleshooting/raw-photos-look-dull.md b/docs/user/troubleshooting/raw-photos-look-dull.md
index 94c615394..c1f6570f5 100644
--- a/docs/user/troubleshooting/raw-photos-look-dull.md
+++ b/docs/user/troubleshooting/raw-photos-look-dull.md
@@ -2,10 +2,10 @@
title: Raw photos look dull or washed out
description: What to do when a raw photo looks flat, grey or desaturated in LightCraft compared with the camera JPEG.
order: 20
-verified: 0.6.0
+verified: 0.7.1
---
-Update to the latest LightCraft, then import the photo again. Colour handling for raw files changed a lot between 0.4.0, 0.5.0 and 0.6.0, and several flat-looking Sony and Fujifilm cases are fixed. Some Leica DNGs still look dull.
+Update to the latest LightCraft, then select the photo and choose **Photo** > **Reload from Disk**. Colour handling for raw files changed a lot between 0.4.0 and 0.7.1, and several flat-looking Sony and Fujifilm cases are fixed. Some Leica DNGs and dark, muted scenes still look dull.
## Symptoms
@@ -15,8 +15,8 @@ Update to the latest LightCraft, then import the photo again. Colour handling fo
## Fix
-1. Check your version in **Help** > **About LightCraft** (on macOS, **LightCraft** > **About LightCraft**). If it is older than 0.6.0, install the [latest release](https://github.com/storytold/lightcraft/releases/latest). See [Install LightCraft](../getting-started/install.md).
-2. Import the raw photo again, or select it and choose **Photo** > **Reload from Disk**.
+1. Check your version in **Help** > **About LightCraft** (on macOS, **LightCraft** > **About LightCraft**). If it is older than 0.7.1, install the [latest release](https://github.com/storytold/lightcraft/releases/latest). See [Install LightCraft](../getting-started/install.md).
+2. Select the raw photo and choose **Photo** > **Reload from Disk**.
3. If it still looks dull, adjust it by hand in the **Edit** panel. See [Edit a photo](../guides/edit-a-photo.md).
4. If you think the starting look is wrong for your camera, report it with the original raw file. See [Get help with a problem](get-help.md).
@@ -24,10 +24,12 @@ Update to the latest LightCraft, then import the photo again. Colour handling fo
LightCraft develops a raw from the sensor data and tries to match the look of the camera's own JPEG. How well it matches depends on the camera model.
-- **Sony ARW:** on 0.5.0 and older, some Lossless Compressed M-size files had lifted blacks, and an A7 II file lost most of its colour. Both are fixed in 0.6.0. On the A7 II file, brighter midtones can still look grey-green in 0.6.0 ([issue 865](https://github.com/storytold/lightcraft/issues/865)). Some files still fall short on dark scenes and on in-camera Dynamic Range Optimizer shots.
+- **Sony ARW:** on 0.5.0 and older, some Lossless Compressed M-size files had lifted blacks, and an A7 II file lost most of its colour. Both are fixed since 0.6.0. Some files still fall short on in-camera Dynamic Range Optimizer shots.
+- **Dark, muted scenes:** LightCraft applies only part of the camera look to them, so they can start duller than the camera JPEG. This is not fixed in 0.7.1 ([issue 865](https://github.com/storytold/lightcraft/issues/865)).
- **Fujifilm X-Pro1 and Sony A7 IV:** reported dull on 0.4.0 and fine on 0.6.0.
-- **Leica DNG:** these files carry a colour matrix but no tone curve, so 0.6.0 shows them darker and flatter than the camera JPEG. This is not fixed in 0.6.0 ([pull request 807](https://github.com/storytold/lightcraft/pull/807)).
-- **Adobe RGB:** if the camera was set to Adobe RGB, LightCraft read the embedded JPEG as sRGB and matched to a too-dull target. The fix came after 0.6.0 and is not in a release yet.
+- **Leica DNG:** these files carry a colour matrix but no tone curve, so LightCraft shows them darker and flatter than the camera JPEG. This is not fixed in 0.7.1 ([pull request 807](https://github.com/storytold/lightcraft/pull/807)).
+- **Adobe RGB:** if the camera was set to Adobe RGB, 0.6.0 and older read the embedded JPEG as sRGB and matched to a too-dull target. Fixed in 0.7.1: LightCraft reads the JPEG in the colour space the raw file states.
+- **Black-and-white picture style:** a raw shot in a monochrome picture style started about 1.3 EV darker than the same camera's colour shots. Since 0.7.1, LightCraft takes the tone from the camera's black-and-white JPEG.
## A soft picture after zooming in