mirror of
https://github.com/storytold/lightcraft.git
synced 2026-10-26 11:09:23 -06:00
Part 1: verified = latest release tag policy in docs/user/AGENTS.md; released-pages sentence in root AGENTS.md. Part 6: blank line in install. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
56 lines
3.0 KiB
Markdown
56 lines
3.0 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.6.0
|
|
---
|
|
|
|
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.
|
|
|
|
## 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.
|
|
|
|
To run it without installing, download `lightcraft-<version>-windows-x64-portable.zip`. A portable build for `arm64` is 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).
|