Installing PostLumina

PostLumina is signed with an Apple Developer ID and notarized by Apple, so you open the DMG, drag the app to Applications and open it. No Terminal and no trip to System Settings is needed.

Requirements: a Mac with Apple silicon (M1 or later) running macOS 13 or later. The DMG is built for Apple silicon only; it does not run on Intel Macs. PostLumina is driven by your own Claude Code or Codex, so you need one of them installed.

Three steps

Open the DMG and drag PostLumina into the Applications folder. Then eject the DMG. Never run PostLumina from inside the DMG or from your Downloads folder: macOS moves an app opened from there to a hidden read-only location (App Translocation), and the assistant connection PostLumina registers for Claude Code or Codex would point at a path that stops existing.
Open Applications → PostLumina. macOS asks once: “PostLumina” is an app downloaded from the Internet. Are you sure you want to open it? Click Open.
That is all. macOS remembers it and does not ask again.

The first open takes a moment

The first time it opens, macOS may show Verifying “PostLumina”… for a few seconds up to half a minute: the system scans the whole app (about 0.5 GB: it carries its own ffmpeg, Python and speech engine, so you install nothing else). Later opens are immediate.

Where PostLumina keeps things

Its own data (projects, jobs, logs, the speech model you download, caches): ~/Library/Application Support/PostLumina.
Everything it renders: a PostLumina Output folder inside the project folder you added. Your original files are never overwritten.
Updating: quit PostLumina, drag the new version into Applications and replace the old one. Your data and projects stay where they are.

The first time PostLumina reads files in your Desktop, Documents or other folders, macOS asks once whether it may. Click Allow; updates do not ask again.

Uninstall

If you connected an assistant, open PostLumina → Settings → AI assistants and click Disconnect first, so Claude Code or Codex no longer points at the app.
Quit PostLumina (menu bar icon → Quit), then move Applications → PostLumina to the Trash.
Optional: delete ~/Library/Application Support/PostLumina to remove its projects, logs and the downloaded speech model. Nothing in your own folders is changed; what PostLumina rendered stays in each project’s PostLumina Output folder.

Stuck on a step? Write to support@postlumina.com.