macOS Media Library

Your media,
beautifully
organized.

Photos, videos, and audio — all in one native macOS app. With built-in support for MKV, AVI, WMV and 30+ formats via bundled FFmpeg.

macOS 14.0+ · Free & Open Source · No subscription

JPG
MKV
RAW
FLAC
AVI
HEIC
WMV
MP3
PNG
30+
Supported file formats
10
Band parametric equalizer
0mb
Extra installs required
Library size, no limits

What's inside

Everything you need,
nothing you don't.

🎬

Universal Video Playback

Play MKV, AVI, WMV, FLV, WebM and more — formats macOS can't natively handle. Lumina bundles a static FFmpeg binary so everything works out of the box. No Homebrew, no extra installs, no configuration.

Powered by FFmpeg
🖼️

Photo Viewer

Pan, zoom, and explore photos with smooth gestures. Supports RAW formats (NEF, CR2, ARW, DNG), HEIC, AVIF, WebP and all common formats.

30+ formats
🎵

Audio Player & EQ

Full-featured audio player with a 10-band parametric equalizer, real-time spectrum visualizer, queue management, shuffle, and loop modes.

±24 dB EQ
💬

Subtitle Support

Load external SRT, ASS, and VTT subtitle files for any video. Subtitles are automatically extracted from MKV containers and rendered as a styled overlay. Position and resize on screen.

SRT · ASS · VTT
🌐

Multi-language Audio

MKV files with multiple audio tracks show a language picker before playback. Pick Tamil, Telugu, Hindi, English — whatever you need. Each selection is separately cached for instant replay.

📁

Smart Library Management

Add folders and Lumina watches them automatically — new files appear instantly, deleted files disappear immediately. Sort by date modified, title, duration, file size, or play count. Grid and list views. Favorites, playlists, and Recently Played smart collections.

⌨️

Keyboard-first

Space to play/pause. Arrow keys to skip 10 seconds. Volume controls. Everything works from the keyboard without touching the mouse.

🔒

Fully Local & Private

No cloud sync. No accounts. No analytics. Your media library lives entirely on your Mac in a local SQLite database. Nothing leaves your machine.

Format Support

Every format,
handled.

Lumina bundles a static FFmpeg binary for Apple Silicon and Intel. Unsupported files are remuxed in seconds using stream copy — no re-encoding, no quality loss.

How it works: When you open an MKV, FFmpeg remuxes it to a QuickTime container in 5–10 seconds. The result is cached — reopen the same file instantly.
Native (AVPlayer)
MP4 MOV M4V MP3 AAC FLAC WAV HEIC JPEG PNG RAW
Via FFmpeg
MKV AVI WMV FLV WebM DivX VOB OGV RMVB ASF M2TS

Open Source

Free to use,
transparent by design.

Lumina

Lumina itself is free software released under the MIT License. You are free to use, modify, and distribute it. Source code is available on GitHub.

MIT License

Why not App Store?

Lumina bundles FFmpeg which is licensed under the GPL v2+. GPL software cannot be distributed through the Mac App Store. Lumina is distributed directly as a result.

Direct Distribution

About FFmpeg

Lumina bundles a statically compiled FFmpeg binary (arm64 + x86_64). FFmpeg is a free, open-source multimedia framework licensed under the GNU General Public License v2 (GPL v2). The bundled binary includes libx264, libx265, and other GPL-licensed codec libraries. By using Lumina, you acknowledge that FFmpeg is subject to the GPL v2 license.

Get started

Up and running
in three steps.

01 — Download

Get Lumina

Download the ZIP from GitHub Releases. Double-click to unzip, then move Lumina.app to your Applications folder.

Lumina-1.0.0.zip
02 — Install

Open & allow

Since Lumina is not notarized, macOS will ask for confirmation on first launch. Right-click the app and choose Open.

Right-click → Open → Open anyway
03 — Add Media

Import your library

Click + in the toolbar to add a folder. Lumina scans it and watches for new files automatically. That's it.

No extra setup required ✓