Skip to content

Latest commit

 

History

History
111 lines (56 loc) · 7.18 KB

File metadata and controls

111 lines (56 loc) · 7.18 KB

FAQ

Frequently asked questions about Safelight.

General

What is Safelight?

Safelight is a free, open-source, privacy-first RAW photo editor. It combines GPU-accelerated professional editing tools with an IDE-style extensible interface, and ships as a desktop app (Electron) for Windows, Linux, and macOS, plus a browser app.

Is Safelight free?

Yes — completely free and open source (GPL v3). No subscriptions, no hidden costs.

Does Safelight work offline?

Yes. The core app's only automatic network activity is checking GitHub for app and extension updates on launch (and refreshing the extension trust list). Turn off both update checks in Preferences and the app makes no network request unless you explicitly open the Extensions store or install an extension. See Privacy for the full list.

Does Safelight collect my data?

There is no telemetry, no analytics, and no accounts. The core app never uploads your photos or edits — they stay on your computer. The update checks above contact GitHub, which (like any download) sees your IP address and the version being compared; you can disable them. Exported images have their camera EXIF, GPS, and XMP stripped. Note that optional extensions you install can make their own network requests — for example, the Web Tools extension uploads photos to a gallery service when you choose to publish. See Privacy.

Desktop app or browser — which should I use?

The desktop app. It guarantees the fast libraw RAW decode path (cross-origin isolation + SharedArrayBuffer) and forces the high-performance GPU. The browser version works in recent Chromium-based browsers (Chrome, Edge, Opera) and is mainly useful for development; Firefox and Safari lack the File System Access API Safelight relies on.

Why does macOS say Safelight is "damaged"?

It isn't damaged. Safelight isn't notarized by Apple (that costs $99/year, which I haven't paid to give away free software I build on Windows), so macOS blocks the unsigned download with a misleading message. Drag the app into Applications and run xattr -cr /Applications/Safelight.app once in Terminal, and it opens normally from then on. The full steps, the fallback if it still won't open, and the candid explanation are in Installation → Troubleshooting → macOS.

Projects and Files

Where is my catalog stored?

Inside the project folder you open, in a hidden .safelight/ directory: catalog.json (records and edit histories), previews/ (thumbnails), and raw/ (decoded-RAW cache). Move the folder and the project moves with it.

Does Safelight modify my original files?

Never. All edits are non-destructive parameter sets stored in .safelight/. Deleting that directory removes Safelight's data and nothing else.

What happens if I add or delete photos outside Safelight?

Reopening the project reconciles against the disk: new files appear, missing files drop out, and everything else keeps its ratings and edits.

Why do I see a "Reconnect" button in the browser?

Browsers reset folder permissions between sessions. One click re-grants access to the project folder.

Features

Does Safelight support RAW files?

Yes. Safelight decodes RAW at full resolution via libraw-wasm, with an in-house decoder for uncompressed CFA/DNG, covering NEF, CR2, CR3, ARW, DNG, ORF, RAF, PEF, SRW, RW2, IIQ, 3FR, NRW, KDC, MOS, MRW, ERF, SR2, and X3F. If a file can't be decoded, Safelight falls back to the embedded JPEG preview so it always displays.

Can I make local adjustments?

Yes — masks built from radial, linear, brush, luminance-range, and color-range components (up to 8 masks per photo, 16 components total) combined with add/subtract/intersect, with per-mask exposure, contrast, tone, color, clarity, and optional sub-panels. Plus heal/clone spot removal (up to 16 spots). Geometry tools include crop, straighten, transform, and automatic/guided Upright perspective correction.

Can I use presets?

Yes. Presets are an open, human-readable JSON format (safelight-preset) that you can save, apply, export, and import — easy to share or generate. The bundled XMP Tools extension also imports Lightroom .xmp presets.

Can I compare before/after?

Yes — the bundled Image Comparison extension adds hold-to-preview and a draggable before/after split to the Develop canvas.

Can I import Lightroom catalogs?

Full catalog import isn't built in yet (it's on the roadmap via sql.js), but the bundled XMP Tools extension reads/writes XMP sidecars and imports Lightroom presets.

Does Safelight support batch editing or AI masking?

Both are planned: batch editing, and AI masking (Select Subject, Sky) via ONNX.js.

Can I rebind keyboard shortcuts?

Every shortcut is rebindable in Preferences (Ctrl+,) ▸ Shortcuts. Single-letter shortcuts can be disabled entirely if they conflict with your workflow.

Extensions

What can extensions do?

A lot — the core is a blind orchestrator that extensions fill in. They can add or replace panels (every stock panel can be disabled and swapped), add themes, layouts, slider icons, keyboard shortcuts, and UI slots; contribute display transforms (tone mappers) and lens profiles; own catalog side concerns via lifecycle hooks (e.g. XMP sidecars); add Library sorts, grid filters, and preset importers; and add export processors and filename templates. See Using Extensions.

Are extensions safe?

Treat them like any third-party software. Except for the small bundled set, extensions are independent third-party code installed from GitHub repos you choose, and they run with full access to your photos, metadata, edits, and files. Safelight consults a community trust registry — a Verified badge means a maintainer reviewed the code at a point in time (not a guarantee of safety, and later updates may not be re-reviewed), and a remote kill-switch disables extensions reported as malicious — but you should install only extensions you trust, the same judgment you'd apply to a browser extension or IDE plugin. You can require verified-only installs in Preferences ▸ Extensions. See Extensions — safety & terms.

Technical

How does multi-window support work?

Library and Develop can detach into separate OS windows; state synchronizes via BroadcastChannel (catalog, selection, edits) and the storage event (settings, themes, layouts).

What is "high bit depth" in Preferences?

When enabled (and supported by your GPU), cached RAW previews use 16-bit float textures, preserving highlight/shadow precision through heavy edits.

Performance is slow — what can I try?

Use the desktop app (it forces the discrete GPU), lower the Develop render cap or thumbnail resolution in Preferences, disable the live histogram, and keep the RAW cache enabled.

Export fails or produces no file

Ensure you have write permission to the destination and that photos finished decoding. When exporting many photos in the browser, prefer the ZIP option — separate files trigger one download prompt each.

Contributing

How can I request a feature or report a bug?

Open a GitHub issue. Pull requests are welcome — see Contributing.