Skip to content

feat(mac): bundle ffmpeg and ship a drag-to-Applications DMG - #2

Merged
bilipp merged 1 commit into
mainfrom
feat/mac-dmg-bundled-ffmpeg
Oct 27, 2026
Merged

bilipp merged 1 commit into
mainfrom
feat/mac-dmg-bundled-ffmpeg

Conversation

@bilipp

@bilipp bilipp commented Oct 27, 2026

Copy link
Copy Markdown
Owner

Summary

Mac users install by dragging the app from a DMG. Nothing else to install: ffmpeg ships inside the app.

 MacApp/
 ├── Resources/
+│   ├── AppIcon.icon/          # Lume's icon + red record badge (Icon Composer)
+│   ├── dmg-settings.py        # dmgbuild: app ⟶ arrow ⟶ Applications
 │   └── Info.plist             # + CFBundleIconName/File
 └── scripts/
+    ├── build-ffmpeg.sh        # pinned ffmpeg 9.0.2 source (SHA-256), universal, LGPL
     └── build-app.sh
 build-app.sh
   swift build (universal)
+  build-ffmpeg.sh            → Contents/MacOS/ffmpeg + Resources/FFmpeg/{LICENSE,README}.txt
+  actool AppIcon.icon        → Assets.car + AppIcon.icns
   codesign ffmpeg, bundles, app
   notarize + staple app
-  zip
+  dmgbuild                   → LumeRecorder-<version>.dmg (APFS, LZFSE)
+  codesign + notarize + staple DMG

ffmpeg build: --disable-gpl --disable-autodetect --enable-securetransport --enable-zlib --disable-encoders --disable-avdevice --disable-x86asm. The recorder only stream-copies. It links only libSystem, libz, and the CoreFoundation, Security, CoreVideo and CoreMedia frameworks. CI caches the binary keyed on build-ffmpeg.sh.

Evidence

  • Before: release asset LumeRecorder-0.3.0.zip, and users need brew install ffmpeg.
    After: LumeRecorder-<version>.dmg (32 MB). Mounted in Finder it shows the app with its icon, an arrow, and Applications (checked by screenshot).
  • The bundled ffmpeg with the recorder's exact arguments:
    https HLS (Apple bipbop fMP4 master) → index.m3u8 + a1_00000.ts, h264 1920x1080 + ac3
      segment byte-identical to Homebrew ffmpeg 9.0.2's (6,356,844 bytes)
    http MPEG-TS (local test server)     → 10.08 s recorded, exit 0
    
  • Not verified: the signed and notarized DMG path. It runs on v* tags only.

Merge Danger

Door: two-way

Build and packaging only. No server or API changes, apart from the menu text when ffmpeg is missing.

Blast Radius: release

The macOS app job gets slower on a cache miss (two ffmpeg builds). The next tag ships a DMG instead of a zip, so old zip links stay on old releases only.

@bilipp
bilipp merged commit e453277 into main Oct 27, 2026
6 checks passed
@bilipp
bilipp deleted the feat/mac-dmg-bundled-ffmpeg branch October 27, 2026 09:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant