Enable OPFS Media Storage in Safari

Safari ships the File System Access API behind experimental flags until macOS 14.4. Without OPFS, large media files fall back to in-memory storage.

Steps

1. Open Safari > Settings > Advanced and check Show features for web developers.
2. In the menu bar choose Develop > Experimental Features > File System Access API.
3. Reload OpenCut. The browser will prompt for storage access when you import media.
4. Serve OpenCut over https:// or http://localhost so the API is available.

Fallback strategy

const fs = await navigator.storage.getDirectory();
// Safari fallback
defaultStorage = window.indexedDB ?? memoryStorage;

If navigator.storage.getDirectory throws, store media in IndexedDB:

if (!window.showOpenFilePicker) {
  await mediaStore.enableIndexedDbFallback();
}

Diagram

  flowchart TD
    A[OpenCut media import] --> B{OPFS available?}
    B -- Yes --> C[Store in OPFS]
    B -- No --> D[Fallback to IndexedDB]

Communicate the experimental nature of OPFS to QA so they test on production Safari builds.