mirror of
https://github.com/storytold/lightcraft.git
synced 2026-10-24 10:09:01 -06:00
- All pages checked against the v0.7.1 tag and its release assets; verified: bumped to 0.7.1. - Install: 32-bit Windows (x86) installer and portable build; pre-0.6 upgrades keep their install folder. - Import: Recently Deleted photos are restored by default; progress shows in the activity stack. - Edit: HDR button next to B&W. - Export: JPEG XL Effort and Progressive, lossy JPEG XL colour space note, Add to Apple Photos on macOS. - Lightroom import: activity stack progress and stopping with its X. - Raw troubleshooting: Adobe RGB fix now released, monochrome picture style tone, EOS R5 Mark II C-RAW decodes, Leica DNG and dark scenes still open; drop "import again" (duplicates are skipped). - docs/user/CLAUDE.md is a regular file instead of a symlink. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
58 lines
3.3 KiB
Markdown
58 lines
3.3 KiB
Markdown
---
|
|
title: Install LightCraft
|
|
description: Download LightCraft for Windows 11, macOS or Linux, install it, and open your photo library.
|
|
order: 10
|
|
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.7.1`. The [LightCraft page on getartcraft.com](https://getartcraft.com/apps/lightcraft) also links the download.
|
|
|
|
## Windows 11
|
|
|
|
1. Open the [latest release](https://github.com/storytold/lightcraft/releases/latest).
|
|
2. Download `lightcraft-<version>-windows-x64.msi`. It fits most PCs (Intel and AMD, 64-bit).
|
|
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 32-bit Windows, download `lightcraft-<version>-windows-x86.msi`.
|
|
|
|
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
|
|
|
|
1. Download `lightcraft-<version>-macos-universal.dmg`. It works on Apple silicon and Intel Macs, and is signed and notarized.
|
|
2. Open the file and install LightCraft.
|
|
|
|
## Linux
|
|
|
|
The release has these files for `x86_64` and `aarch64` (Arm). Replace `x86_64` with `aarch64` on Arm.
|
|
|
|
| File | Notes |
|
|
|----------------------------------------------|----------------------------------------------------------|
|
|
| `lightcraft-<version>-linux-x86_64.AppImage` | Runs anywhere. |
|
|
| `lightcraft-<version>-linux-x86_64.flatpak` | Sandboxed. Install with `flatpak install --user <file>`. |
|
|
| `lightcraft-<version>-linux-x86_64.deb` | For Debian and Ubuntu. |
|
|
| `lightcraft-<version>-linux-x86_64.rpm` | For Fedora, RHEL and openSUSE. |
|
|
| `lightcraft-<version>-linux-x86_64.tar.gz` | Unpack anywhere. |
|
|
|
|
RISC-V and FreeBSD builds are on the release page too. On a Wayland desktop, LightCraft runs through XWayland when it is available, because only X11 gives it file drag-and-drop.
|
|
|
|
## Install with ArtCraft Launcher
|
|
|
|
[ArtCraft Launcher](https://getartcraft.com/docs/craft-launcher) lists LightCraft and can install and update it for you. On Windows it installs the release `.msi`.
|
|
|
|
## In a web browser
|
|
|
|
The release also has `lightcraft-web-<version>.zip`, a static site that runs LightCraft in a modern browser. Host it on any static web server.
|
|
|
|
## First run
|
|
|
|
1. Start LightCraft. It opens your library at `~/Pictures/LightCraft Library`. A new library starts with demo photos.
|
|
2. To bring in your own photos, see [Import photos](../guides/import-photos.md).
|
|
|
|
## Still stuck?
|
|
|
|
Ask in [Discord](https://discord.gg/artcraft) or open an issue in the [issue tracker](https://github.com/storytold/lightcraft/issues).
|