A lightweight native image viewer for macOS.
Open an image and browse its folder with the arrow keys. Everyday controls stay close at hand.
LumaView 1.3.5 — Apple Silicon DMG · Intel DMG · Website · 简体中文 · 日本語 · Changelog
macOS 12+ · Separate Apple Silicon and Intel installers · ~2 MB each
Apple menu → About This Mac: choose Apple Silicon for an M-series chip, or Intel for an Intel processor.
| Open a file | Browse its folder |
|---|---|
![]() |
![]() |
- Browse folders — open from Finder, choose a file or drag it in; use
←/→for the previous and next image. - See the details — fit, zoom, pan, rotate, print and inspect embedded EXIF information.
- Play and read — play animated GIF and WebP; use
↑/↓to turn PDF pages and keep your reading position. - Compare images — open separate windows, each with its own zoom and browsing position.
- Built for the Mac — native SwiftUI, seven languages, Light / Dark / System appearance, and default-app settings.
- Images: JPEG (
.jpg,.jpeg), PNG, HEIC / HEIF, GIF, WebP, TIFF (.tif,.tiff), BMP, ICO, ICNS and JPEG 2000 (.jp2,.j2k). Animated GIF and WebP can play. - Camera RAW:
.raw, DNG, CR2, NEF, ARW, ORF, RW2 and other formats supported by macOS. - Documents: multi-page PDF and the embedded preview of a Sketch (
.sketch) document. - System-dependent: AVIF and JPEG XL (
.jxl), as well as other image formats recognized by macOS.
Decoding depends on the macOS version, installed codecs and the individual file. Recognizing a file extension does not guarantee that every file can be opened. Sketch displays its preview, not editable layers.
- Download the DMG for Apple Silicon or Intel.
- Open it and drag LumaView.app to Applications.
- Open LumaView from Applications. To open an image directly, Control-click it in Finder and choose Open With → LumaView.
Use Help → Check for Updates… to check manually. When a new version is available, View Version opens the release page and keeps your windows open. Quit with ⌘Q before replacing the app, or use Go to Download and Quit from the update dialog.
Messages vary by macOS version: the developer may be unverified, or Apple may be unable to check the app for malicious software. If you trust the copy downloaded from this project's GitHub Releases or supplied by the developer for testing:
- Try opening LumaView from Applications once, then dismiss that alert.
- Follow the settings path below, find the message about LumaView, and click Open Anyway.
- Authenticate if prompted, then confirm Open. Subsequent launches normally work by double-clicking.
| macOS version | Settings path |
|---|---|
| macOS 12 Monterey | Apple menu → System Preferences → Security & Privacy → General |
| macOS 13 Ventura or later | Apple menu → System Settings → Privacy & Security, then scroll to Security |
If Open Anyway is missing, try opening LumaView again, then return to settings. A damaged-app or malware warning is different: stop and download a fresh copy from the project or report the issue instead of overriding it.
See Apple's opening instructions.
In Finder, select an image → press ⌘I → choose LumaView under Open with → click Change All….
The DMG is only the installer. Removing it never removes LumaView or your images; to uninstall later, move LumaView.app from Applications to Trash.
| Action | Shortcut |
|---|---|
| Open file | ⌘ O |
| Open files in new windows | ⌘ ⇧ O |
| Previous / next PDF page | ↑ / ↓ |
| Keep file information visible | ⌃ ⌘ I |
| Previous / next image | ← / → |
| Zoom in / out | ⌘ + / ⌘ - |
| Fit image | ⌘ 0 |
| Rotate left / right | ⌘ [ / ⌘ ] |
| Print current image | ⌘ P |
| Move current file to Trash | Delete (confirmation on first use) |
Use the macOS/Xcode toolchain described in the development guide. The built app runs on macOS 12 or later, on both Apple Silicon and Intel Macs.
open LumaView.xcodeproj
# Select the LumaView scheme, then press ⌘R.Before opening a pull request, run:
./Scripts/validate-project.shRelease packaging, manual QA, and performance baselines are documented in Release guide, QA guide, and Performance baseline.
Found a problem or have an idea? Use the structured bug report or feature request form. See Contributing for development expectations, Privacy for local-data behavior, and Security for responsible disclosure.
LumaView is available under the MIT License. Tabler icon attribution is listed in THIRD-PARTY-NOTICES.md.
Documentation index · Development and validation · Website maintenance.
The official website source lives in website/; docs/ is reserved for maintainer documentation.

