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.1 — 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 naturally — open from Finder, choose a file, or drag it in; use
←/→or the toolbar for the previous and next image in the folder. -
See the image clearly — fit, zoom, pan, rotate, and print; the status bar shows the actual zoom level.
-
Inspect only when needed — one toolbar button reveals file facts and the EXIF data embedded in the current image, without a separate folder-wide metadata scan or library.
-
Open the formats you meet every day — JPEG, PNG, HEIC, GIF, TIFF, BMP, ICO, WebP, PDF, many macOS-supported RAW files, and
.sketchpreviews. -
Built for the Mac — native SwiftUI, English, Chinese, French, Russian, Spanish, Japanese, and Korean; Light / Dark / System appearance; Intel and Apple Silicon support.
-
Read PDFs — turn pages with
↑/↓; keep your page, zoom and rotation while reading. -
Choose default formats — set LumaView as the default viewer from Settings.
- 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.
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 |
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.