Skip to content
ixiehaoPublic

About

Lightweight, minimal native image viewer for Mac

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

13 stars

Watchers

0 watching

Forks

Latest commit

 

History

113 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LumaView

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.

LumaView in use

Open a file Browse its folder
LumaView native welcome screen with one Open File action LumaView browsing images with folder position and previous-next controls

Highlights

  • 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.

Supported formats

  • 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.

Install

  1. Download the DMG for Apple Silicon or Intel.
  2. Open it and drag LumaView.app to Applications.
  3. 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.

If macOS blocks the first launch

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:

  1. Try opening LumaView from Applications once, then dismiss that alert.
  2. Follow the settings path below, find the message about LumaView, and click Open Anyway.
  3. 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.

Make LumaView the default image viewer

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.

Shortcuts

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)

Build from source

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.sh

Release packaging, manual QA, and performance baselines are documented in Release guide, QA guide, and Performance baseline.

Feedback and contribution

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.

Development documentation

Documentation index · Development and validation · Website maintenance.

The official website source lives in website/; docs/ is reserved for maintainer documentation.

About

Lightweight, minimal native image viewer for Mac

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

13 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages